From 488022ee6b6d875177598d2b6708411e76514759 Mon Sep 17 00:00:00 2001 From: Artem Goncharov Date: Mon, 28 Mar 2022 14:03:38 +0200 Subject: [PATCH] Import api-ref docs (#2) Import api-ref docs Reviewed-by: kucerakk --- .zuul.yaml | 1 + .../images/en-us_image_0000001126894914.png | Bin 0 -> 20267 bytes .../images/en-us_image_0000001126895190.png | Bin 0 -> 22442 bytes .../_static/images/en-us_image_0150916848.gif | Bin 0 -> 48314 bytes .../_static/images/en-us_image_0150917346.gif | Bin 0 -> 28628 bytes .../_static/images/en-us_image_0150917350.gif | Bin 0 -> 42932 bytes .../_static/images/en-us_image_0150917353.gif | Bin 0 -> 33277 bytes .../_static/images/en-us_image_0171113090.png | Bin 0 -> 51740 bytes .../_static/images/en-us_image_0171392261.gif | Bin 0 -> 51879 bytes api-ref/source/api_overview.rst | 176 +++ ...ing_job_using_the_tensorflow_framework.rst | 449 +++++++ api-ref/source/application_cases/index.rst | 8 + .../configuring_authorization.rst | 114 ++ .../creating_a_modelarts_agency.rst | 98 ++ .../deleting_authorization.rst | 84 ++ .../source/authorization_management/index.rst | 11 + .../viewing_an_authorization_list.rst | 165 +++ .../source/before_you_start/api_calling.rst | 6 + .../before_you_start/basic_concepts.rst | 26 + api-ref/source/before_you_start/endpoints.rst | 28 + api-ref/source/before_you_start/index.rst | 11 + api-ref/source/before_you_start/overview.rst | 6 + .../source/calling_apis/authentication.rst | 189 +++ api-ref/source/calling_apis/index.rst | 10 + .../calling_apis/making_an_api_request.rst | 171 +++ api-ref/source/calling_apis/response.rst | 101 ++ api-ref/source/change_history.rst | 12 + .../source/common_parameters/error_codes.rst | 1136 +++++++++++++++++ api-ref/source/common_parameters/index.rst | 12 + .../obtaining_a_project_id_and_name.rst | 52 + .../obtaining_a_username_and_id.rst | 18 + .../obtaining_an_account_name_and_id.rst | 18 + .../source/common_parameters/status_code.rst | 124 ++ api-ref/source/conf.py | 166 +++ .../creating_a_dataset_export_task.rst | 675 ++++++++++ .../data_export_task/index.rst | 10 + .../querying_the_dataset_export_task_list.rst | 460 +++++++ ...ng_the_status_of_a_dataset_export_task.rst | 353 +++++ .../creating_an_import_task.rst | 409 ++++++ .../data_import_task/index.rst | 10 + ...ng_details_about_a_dataset_import_task.rst | 282 ++++ .../querying_the_dataset_import_task_list.rst | 306 +++++ .../data_management/data_management_apis.rst | 178 +++ .../data_synchronization_task/index.rst | 9 + ...atus_of_a_dataset_synchronization_task.rst | 120 ++ .../synchronizing_a_dataset.rst | 69 + .../dataset_management/creating_a_dataset.rst | 619 +++++++++ .../dataset_management/deleting_a_dataset.rst | 74 ++ .../dataset_management/index.rst | 16 + .../modifying_a_dataset.rst | 230 ++++ .../querying_dataset_statistics.rst | 318 +++++ .../querying_details_about_a_dataset.rst | 870 +++++++++++++ ...ls_about_team_labeling_task_statistics.rst | 320 +++++ ...rogress_of_a_team_labeling_task_member.rst | 100 ++ ...rying_the_monitoring_data_of_a_dataset.rst | 120 ++ ...se_body_for_querying_the_dataset_list..rst | 1001 +++++++++++++++ .../creating_a_dataset_labeling_version.rst | 140 ++ .../deleting_a_dataset_labeling_version.rst | 76 ++ .../dataset_version_management/index.rst | 11 + ...erying_details_about_a_dataset_version.rst | 432 +++++++ .../querying_the_dataset_version_list.rst | 496 +++++++ api-ref/source/data_management/index.rst | 22 + .../intelligent_task/index.rst | 13 + ...ng_information_about_intelligent_tasks.rst | 958 ++++++++++++++ .../querying_auto_labeling_sample_list.rst | 587 +++++++++ ..._details_about_an_auto_labeling_sample.rst | 524 ++++++++ ...ying_the_intelligent_task_list_by_page.rst | 1063 +++++++++++++++ .../starting_intelligent_tasks.rst | 822 ++++++++++++ .../stopping_an_intelligent_task.rst | 77 ++ .../creating_a_dataset_label.rst | 248 ++++ ..._the_files_that_only_contain_the_label.rst | 132 ++ .../deleting_labels_in_batches.rst | 258 ++++ .../label_management/index.rst | 13 + .../modifying_labels_in_batches.rst | 248 ++++ .../querying_the_dataset_label_list.rst | 220 ++++ .../updating_a_label_by_label_names.rst | 161 +++ ...eating_a_team_labeling_acceptance_task.rst | 105 ++ .../creating_a_team_labeling_task.rst | 231 ++++ .../deleting_a_team_labeling_task.rst | 76 ++ .../labeling_task_management/index.rst | 17 + ...ing_details_about_a_team_labeling_task.rst | 728 +++++++++++ ...ort_of_a_team_labeling_acceptance_task.rst | 136 ++ ...am_labeling_task_list_by_a_team_member.rst | 262 ++++ ...e_team_labeling_task_list_of_a_dataset.rst | 689 ++++++++++ .../starting_a_team_labeling_task.rst | 174 +++ .../updating_a_team_labeling_task.rst | 178 +++ ...tus_of_a_team_labeling_acceptance_task.rst | 562 ++++++++ .../creating_a_labeling_team.rst | 102 ++ .../deleting_a_labeling_team.rst | 116 ++ .../labeling_team_management/index.rst | 12 + ...querying_details_about_a_labeling_team.rst | 106 ++ .../querying_the_labeling_team_list.rst | 154 +++ .../updating_a_labeling_team.rst | 89 ++ .../creating_a_labeling_team_member.rst | 99 ++ .../deleting_a_labeling_team_member.rst | 76 ++ ...eting_labeling_team_members_in_batches.rst | 136 ++ .../labeling_team_member_management/index.rst | 15 + ...ng_details_about_labeling_team_members.rst | 128 ++ ..._the_list_of_all_labeling_team_members.rst | 180 +++ ...ying_the_list_of_labeling_team_members.rst | 183 +++ ...ing_an_email_to_a_labeling_team_member.rst | 133 ++ .../updating_a_labeling_team_member.rst | 100 ++ .../data_management/manual_labeling/index.rst | 8 + .../updating_sample_labels_in_batches.rst | 451 +++++++ ...reating_a_data_processing_task_version.rst | 261 ++++ .../creating_a_processing_task.rst | 390 ++++++ ...eleting_a_data_processing_task_version.rst | 76 ++ .../deleting_a_processing_task.rst | 74 ++ .../data_management/processing_task/index.rst | 19 + ...erying_details_about_a_processing_task.rst | 280 ++++ ...the_algorithm_type_for_data_processing.rst | 120 ++ ..._the_version_of_a_data_processing_task.rst | 278 ++++ ...querying_the_list_of_a_processing_task.rst | 390 ++++++ ...sult_of_a_data_processing_task_version.rst | 184 +++ ...version_list_of_a_data_processing_task.rst | 360 ++++++ ..._the_version_of_a_data_processing_task.rst | 77 ++ .../updating_a_processing_task.rst | 87 ++ .../adding_samples_in_batches.rst | 562 ++++++++ .../deleting_samples_in_batches.rst | 137 ++ .../sample_management/index.rst | 14 + .../obtaining_sample_search_condition.rst | 218 ++++ .../querying_details_about_a_sample.rst | 562 ++++++++ ...ng_details_about_team_labeling_samples.rst | 561 ++++++++ .../querying_the_sample_list.rst | 663 ++++++++++ ...e_list_of_a_team_labeling_task_by_page.rst | 625 +++++++++ .../index.rst | 10 + .../reviewing_team_labeling_results.rst | 119 ++ ..._review_comments_of_an_acceptance_task.rst | 119 ++ ...ls_of_team_labeling_samples_in_batches.rst | 455 +++++++ ...ing_a_development_environment_instance.rst | 738 +++++++++++ ...ing_a_development_environment_instance.rst | 83 ++ api-ref/source/devenviron/index.rst | 15 + ...ing_a_development_environment_instance.rst | 100 ++ ..._of_a_development_environment_instance.rst | 600 +++++++++ ...t_of_development_environment_instances.rst | 661 ++++++++++ ..._of_a_development_environment_instance.rst | 81 ++ ...out_a_development_environment_instance.rst | 559 ++++++++ .../restarting_an_ml_studio_instance.rst | 92 ++ api-ref/source/index.rst | 20 + api-ref/source/model_management/index.rst | 8 + .../models/deleting_a_model.rst | 106 ++ .../models/importing_a_model.rst | 355 ++++++ .../source/model_management/models/index.rst | 11 + .../models/querying_a_model_list.rst | 212 +++ .../querying_the_details_about_a_model.rst | 315 +++++ .../service_management/deleting_a_service.rst | 62 + .../deploying_a_model_as_a_service.rst | 321 +++++ api-ref/source/service_management/index.rst | 16 + .../querying_a_service_list.rst | 252 ++++ .../querying_service_event_logs.rst | 176 +++ ...uerying_service_monitoring_information.rst | 125 ++ .../querying_service_update_logs.rst | 188 +++ ...rted_service_deployment_specifications.rst | 116 ++ .../querying_the_details_about_a_service.rst | 341 +++++ .../updating_service_configurations.rst | 169 +++ api-ref/source/training_management/index.rst | 12 + .../training_management/job_statuses.rst | 60 + .../index.rst | 9 + .../querying_job_engine_specifications.rst | 138 ++ .../querying_job_resource_specifications.rst | 172 +++ .../creating_a_training_job_configuration.rst | 186 +++ .../deleting_a_training_job_configuration.rst | 90 ++ .../index.rst | 12 + ...modifying_a_training_job_configuration.rst | 184 +++ ..._a_list_of_training_job_configurations.rst | 156 +++ ...ils_about_a_training_job_configuration.rst | 320 +++++ .../training_jobs/creating_a_training_job.rst | 365 ++++++ .../creating_a_version_of_a_training_job.rst | 218 ++++ .../training_jobs/deleting_a_training_job.rst | 92 ++ .../deleting_a_version_of_a_training_job.rst | 90 ++ .../training_jobs/index.rst | 22 + ...ying_the_description_of_a_training_job.rst | 101 ++ ...ng_the_name_of_a_training_job_log_file.rst | 95 ++ .../querying_a_built-in_algorithm.rst | 202 +++ ...erying_a_list_of_training_job_versions.rst | 462 +++++++ .../querying_a_training_job_list.rst | 165 +++ ...tion_about_a_single_container_of_a_job.rst | 142 +++ ..._information_about_resource_pool_nodes.rst | 140 ++ ...e_details_about_a_training_job_version.rst | 500 ++++++++ ...s_and_gpu_quantity_of_all_job_versions.rst | 173 +++ .../querying_training_job_logs.rst | 123 ++ .../training_jobs/stopping_a_training_job.rst | 94 ++ .../creating_a_visualization_job.rst | 167 +++ .../deleting_a_visualization_job.rst | 90 ++ .../visualization_jobs/index.rst | 14 + ...the_description_of_a_visualization_job.rst | 103 ++ .../querying_a_visualization_job_list.rst | 175 +++ ..._the_details_about_a_visualization_job.rst | 118 ++ .../restarting_a_visualization_job.rst | 90 ++ .../stopping_a_visualization_job.rst | 90 ++ .../creating_a_workspace.rst | 197 +++ .../deleting_a_workspace.rst | 89 ++ api-ref/source/workspace_management/index.rst | 14 + .../modifying_a_workspace.rst | 136 ++ .../modifying_a_workspace_quota.rst | 159 +++ .../querying_a_workspace_list.rst | 187 +++ .../querying_a_workspace_quota.rst | 130 ++ .../querying_details_about_a_workspace.rst | 153 +++ requirements.txt | 2 +- tox.ini | 3 + 200 files changed, 40090 insertions(+), 1 deletion(-) create mode 100644 api-ref/source/_static/images/en-us_image_0000001126894914.png create mode 100644 api-ref/source/_static/images/en-us_image_0000001126895190.png create mode 100644 api-ref/source/_static/images/en-us_image_0150916848.gif create mode 100644 api-ref/source/_static/images/en-us_image_0150917346.gif create mode 100644 api-ref/source/_static/images/en-us_image_0150917350.gif create mode 100644 api-ref/source/_static/images/en-us_image_0150917353.gif create mode 100644 api-ref/source/_static/images/en-us_image_0171113090.png create mode 100644 api-ref/source/_static/images/en-us_image_0171392261.gif create mode 100644 api-ref/source/api_overview.rst create mode 100644 api-ref/source/application_cases/creating_a_training_job_using_the_tensorflow_framework.rst create mode 100644 api-ref/source/application_cases/index.rst create mode 100644 api-ref/source/authorization_management/configuring_authorization.rst create mode 100644 api-ref/source/authorization_management/creating_a_modelarts_agency.rst create mode 100644 api-ref/source/authorization_management/deleting_authorization.rst create mode 100644 api-ref/source/authorization_management/index.rst create mode 100644 api-ref/source/authorization_management/viewing_an_authorization_list.rst create mode 100644 api-ref/source/before_you_start/api_calling.rst create mode 100644 api-ref/source/before_you_start/basic_concepts.rst create mode 100644 api-ref/source/before_you_start/endpoints.rst create mode 100644 api-ref/source/before_you_start/index.rst create mode 100644 api-ref/source/before_you_start/overview.rst create mode 100644 api-ref/source/calling_apis/authentication.rst create mode 100644 api-ref/source/calling_apis/index.rst create mode 100644 api-ref/source/calling_apis/making_an_api_request.rst create mode 100644 api-ref/source/calling_apis/response.rst create mode 100644 api-ref/source/change_history.rst create mode 100644 api-ref/source/common_parameters/error_codes.rst create mode 100644 api-ref/source/common_parameters/index.rst create mode 100644 api-ref/source/common_parameters/obtaining_a_project_id_and_name.rst create mode 100644 api-ref/source/common_parameters/obtaining_a_username_and_id.rst create mode 100644 api-ref/source/common_parameters/obtaining_an_account_name_and_id.rst create mode 100644 api-ref/source/common_parameters/status_code.rst create mode 100644 api-ref/source/conf.py create mode 100644 api-ref/source/data_management/data_export_task/creating_a_dataset_export_task.rst create mode 100644 api-ref/source/data_management/data_export_task/index.rst create mode 100644 api-ref/source/data_management/data_export_task/querying_the_dataset_export_task_list.rst create mode 100644 api-ref/source/data_management/data_export_task/querying_the_status_of_a_dataset_export_task.rst create mode 100644 api-ref/source/data_management/data_import_task/creating_an_import_task.rst create mode 100644 api-ref/source/data_management/data_import_task/index.rst create mode 100644 api-ref/source/data_management/data_import_task/querying_details_about_a_dataset_import_task.rst create mode 100644 api-ref/source/data_management/data_import_task/querying_the_dataset_import_task_list.rst create mode 100644 api-ref/source/data_management/data_management_apis.rst create mode 100644 api-ref/source/data_management/data_synchronization_task/index.rst create mode 100644 api-ref/source/data_management/data_synchronization_task/querying_the_status_of_a_dataset_synchronization_task.rst create mode 100644 api-ref/source/data_management/data_synchronization_task/synchronizing_a_dataset.rst create mode 100644 api-ref/source/data_management/dataset_management/creating_a_dataset.rst create mode 100644 api-ref/source/data_management/dataset_management/deleting_a_dataset.rst create mode 100644 api-ref/source/data_management/dataset_management/index.rst create mode 100644 api-ref/source/data_management/dataset_management/modifying_a_dataset.rst create mode 100644 api-ref/source/data_management/dataset_management/querying_dataset_statistics.rst create mode 100644 api-ref/source/data_management/dataset_management/querying_details_about_a_dataset.rst create mode 100644 api-ref/source/data_management/dataset_management/querying_details_about_team_labeling_task_statistics.rst create mode 100644 api-ref/source/data_management/dataset_management/querying_details_about_the_progress_of_a_team_labeling_task_member.rst create mode 100644 api-ref/source/data_management/dataset_management/querying_the_monitoring_data_of_a_dataset.rst create mode 100644 api-ref/source/data_management/dataset_management/response_body_for_querying_the_dataset_list..rst create mode 100644 api-ref/source/data_management/dataset_version_management/creating_a_dataset_labeling_version.rst create mode 100644 api-ref/source/data_management/dataset_version_management/deleting_a_dataset_labeling_version.rst create mode 100644 api-ref/source/data_management/dataset_version_management/index.rst create mode 100644 api-ref/source/data_management/dataset_version_management/querying_details_about_a_dataset_version.rst create mode 100644 api-ref/source/data_management/dataset_version_management/querying_the_dataset_version_list.rst create mode 100644 api-ref/source/data_management/index.rst create mode 100644 api-ref/source/data_management/intelligent_task/index.rst create mode 100644 api-ref/source/data_management/intelligent_task/obtaining_information_about_intelligent_tasks.rst create mode 100644 api-ref/source/data_management/intelligent_task/querying_auto_labeling_sample_list.rst create mode 100644 api-ref/source/data_management/intelligent_task/querying_details_about_an_auto_labeling_sample.rst create mode 100644 api-ref/source/data_management/intelligent_task/querying_the_intelligent_task_list_by_page.rst create mode 100644 api-ref/source/data_management/intelligent_task/starting_intelligent_tasks.rst create mode 100644 api-ref/source/data_management/intelligent_task/stopping_an_intelligent_task.rst create mode 100644 api-ref/source/data_management/label_management/creating_a_dataset_label.rst create mode 100644 api-ref/source/data_management/label_management/deleting_a_label_and_the_files_that_only_contain_the_label.rst create mode 100644 api-ref/source/data_management/label_management/deleting_labels_in_batches.rst create mode 100644 api-ref/source/data_management/label_management/index.rst create mode 100644 api-ref/source/data_management/label_management/modifying_labels_in_batches.rst create mode 100644 api-ref/source/data_management/label_management/querying_the_dataset_label_list.rst create mode 100644 api-ref/source/data_management/label_management/updating_a_label_by_label_names.rst create mode 100644 api-ref/source/data_management/labeling_task_management/creating_a_team_labeling_acceptance_task.rst create mode 100644 api-ref/source/data_management/labeling_task_management/creating_a_team_labeling_task.rst create mode 100644 api-ref/source/data_management/labeling_task_management/deleting_a_team_labeling_task.rst create mode 100644 api-ref/source/data_management/labeling_task_management/index.rst create mode 100644 api-ref/source/data_management/labeling_task_management/querying_details_about_a_team_labeling_task.rst create mode 100644 api-ref/source/data_management/labeling_task_management/querying_the_report_of_a_team_labeling_acceptance_task.rst create mode 100644 api-ref/source/data_management/labeling_task_management/querying_the_team_labeling_task_list_by_a_team_member.rst create mode 100644 api-ref/source/data_management/labeling_task_management/querying_the_team_labeling_task_list_of_a_dataset.rst create mode 100644 api-ref/source/data_management/labeling_task_management/starting_a_team_labeling_task.rst create mode 100644 api-ref/source/data_management/labeling_task_management/updating_a_team_labeling_task.rst create mode 100644 api-ref/source/data_management/labeling_task_management/updating_the_status_of_a_team_labeling_acceptance_task.rst create mode 100644 api-ref/source/data_management/labeling_team_management/creating_a_labeling_team.rst create mode 100644 api-ref/source/data_management/labeling_team_management/deleting_a_labeling_team.rst create mode 100644 api-ref/source/data_management/labeling_team_management/index.rst create mode 100644 api-ref/source/data_management/labeling_team_management/querying_details_about_a_labeling_team.rst create mode 100644 api-ref/source/data_management/labeling_team_management/querying_the_labeling_team_list.rst create mode 100644 api-ref/source/data_management/labeling_team_management/updating_a_labeling_team.rst create mode 100644 api-ref/source/data_management/labeling_team_member_management/creating_a_labeling_team_member.rst create mode 100644 api-ref/source/data_management/labeling_team_member_management/deleting_a_labeling_team_member.rst create mode 100644 api-ref/source/data_management/labeling_team_member_management/deleting_labeling_team_members_in_batches.rst create mode 100644 api-ref/source/data_management/labeling_team_member_management/index.rst create mode 100644 api-ref/source/data_management/labeling_team_member_management/querying_details_about_labeling_team_members.rst create mode 100644 api-ref/source/data_management/labeling_team_member_management/querying_the_list_of_all_labeling_team_members.rst create mode 100644 api-ref/source/data_management/labeling_team_member_management/querying_the_list_of_labeling_team_members.rst create mode 100644 api-ref/source/data_management/labeling_team_member_management/sending_an_email_to_a_labeling_team_member.rst create mode 100644 api-ref/source/data_management/labeling_team_member_management/updating_a_labeling_team_member.rst create mode 100644 api-ref/source/data_management/manual_labeling/index.rst create mode 100644 api-ref/source/data_management/manual_labeling/updating_sample_labels_in_batches.rst create mode 100644 api-ref/source/data_management/processing_task/creating_a_data_processing_task_version.rst create mode 100644 api-ref/source/data_management/processing_task/creating_a_processing_task.rst create mode 100644 api-ref/source/data_management/processing_task/deleting_a_data_processing_task_version.rst create mode 100644 api-ref/source/data_management/processing_task/deleting_a_processing_task.rst create mode 100644 api-ref/source/data_management/processing_task/index.rst create mode 100644 api-ref/source/data_management/processing_task/querying_details_about_a_processing_task.rst create mode 100644 api-ref/source/data_management/processing_task/querying_the_algorithm_type_for_data_processing.rst create mode 100644 api-ref/source/data_management/processing_task/querying_the_details_about_the_version_of_a_data_processing_task.rst create mode 100644 api-ref/source/data_management/processing_task/querying_the_list_of_a_processing_task.rst create mode 100644 api-ref/source/data_management/processing_task/querying_the_result_of_a_data_processing_task_version.rst create mode 100644 api-ref/source/data_management/processing_task/querying_the_version_list_of_a_data_processing_task.rst create mode 100644 api-ref/source/data_management/processing_task/stopping_the_version_of_a_data_processing_task.rst create mode 100644 api-ref/source/data_management/processing_task/updating_a_processing_task.rst create mode 100644 api-ref/source/data_management/sample_management/adding_samples_in_batches.rst create mode 100644 api-ref/source/data_management/sample_management/deleting_samples_in_batches.rst create mode 100644 api-ref/source/data_management/sample_management/index.rst create mode 100644 api-ref/source/data_management/sample_management/obtaining_sample_search_condition.rst create mode 100644 api-ref/source/data_management/sample_management/querying_details_about_a_sample.rst create mode 100644 api-ref/source/data_management/sample_management/querying_details_about_team_labeling_samples.rst create mode 100644 api-ref/source/data_management/sample_management/querying_the_sample_list.rst create mode 100644 api-ref/source/data_management/sample_management/querying_the_sample_list_of_a_team_labeling_task_by_page.rst create mode 100644 api-ref/source/data_management/team_labeling_process_management/index.rst create mode 100644 api-ref/source/data_management/team_labeling_process_management/reviewing_team_labeling_results.rst create mode 100644 api-ref/source/data_management/team_labeling_process_management/submitting_sample_review_comments_of_an_acceptance_task.rst create mode 100644 api-ref/source/data_management/team_labeling_process_management/updating_labels_of_team_labeling_samples_in_batches.rst create mode 100644 api-ref/source/devenviron/creating_a_development_environment_instance.rst create mode 100644 api-ref/source/devenviron/deleting_a_development_environment_instance.rst create mode 100644 api-ref/source/devenviron/index.rst create mode 100644 api-ref/source/devenviron/managing_a_development_environment_instance.rst create mode 100644 api-ref/source/devenviron/modifying_the_description_of_a_development_environment_instance.rst create mode 100644 api-ref/source/devenviron/querying_a_list_of_development_environment_instances.rst create mode 100644 api-ref/source/devenviron/querying_the_authentication_information_of_a_development_environment_instance.rst create mode 100644 api-ref/source/devenviron/querying_the_details_about_a_development_environment_instance.rst create mode 100644 api-ref/source/devenviron/restarting_an_ml_studio_instance.rst create mode 100644 api-ref/source/index.rst create mode 100644 api-ref/source/model_management/index.rst create mode 100644 api-ref/source/model_management/models/deleting_a_model.rst create mode 100644 api-ref/source/model_management/models/importing_a_model.rst create mode 100644 api-ref/source/model_management/models/index.rst create mode 100644 api-ref/source/model_management/models/querying_a_model_list.rst create mode 100644 api-ref/source/model_management/models/querying_the_details_about_a_model.rst create mode 100644 api-ref/source/service_management/deleting_a_service.rst create mode 100644 api-ref/source/service_management/deploying_a_model_as_a_service.rst create mode 100644 api-ref/source/service_management/index.rst create mode 100644 api-ref/source/service_management/querying_a_service_list.rst create mode 100644 api-ref/source/service_management/querying_service_event_logs.rst create mode 100644 api-ref/source/service_management/querying_service_monitoring_information.rst create mode 100644 api-ref/source/service_management/querying_service_update_logs.rst create mode 100644 api-ref/source/service_management/querying_supported_service_deployment_specifications.rst create mode 100644 api-ref/source/service_management/querying_the_details_about_a_service.rst create mode 100644 api-ref/source/service_management/updating_service_configurations.rst create mode 100644 api-ref/source/training_management/index.rst create mode 100644 api-ref/source/training_management/job_statuses.rst create mode 100644 api-ref/source/training_management/resource_and_engine_specifications/index.rst create mode 100644 api-ref/source/training_management/resource_and_engine_specifications/querying_job_engine_specifications.rst create mode 100644 api-ref/source/training_management/resource_and_engine_specifications/querying_job_resource_specifications.rst create mode 100644 api-ref/source/training_management/training_job_parameter_configuration/creating_a_training_job_configuration.rst create mode 100644 api-ref/source/training_management/training_job_parameter_configuration/deleting_a_training_job_configuration.rst create mode 100644 api-ref/source/training_management/training_job_parameter_configuration/index.rst create mode 100644 api-ref/source/training_management/training_job_parameter_configuration/modifying_a_training_job_configuration.rst create mode 100644 api-ref/source/training_management/training_job_parameter_configuration/querying_a_list_of_training_job_configurations.rst create mode 100644 api-ref/source/training_management/training_job_parameter_configuration/querying_the_details_about_a_training_job_configuration.rst create mode 100644 api-ref/source/training_management/training_jobs/creating_a_training_job.rst create mode 100644 api-ref/source/training_management/training_jobs/creating_a_version_of_a_training_job.rst create mode 100644 api-ref/source/training_management/training_jobs/deleting_a_training_job.rst create mode 100644 api-ref/source/training_management/training_jobs/deleting_a_version_of_a_training_job.rst create mode 100644 api-ref/source/training_management/training_jobs/index.rst create mode 100644 api-ref/source/training_management/training_jobs/modifying_the_description_of_a_training_job.rst create mode 100644 api-ref/source/training_management/training_jobs/obtaining_the_name_of_a_training_job_log_file.rst create mode 100644 api-ref/source/training_management/training_jobs/querying_a_built-in_algorithm.rst create mode 100644 api-ref/source/training_management/training_jobs/querying_a_list_of_training_job_versions.rst create mode 100644 api-ref/source/training_management/training_jobs/querying_a_training_job_list.rst create mode 100644 api-ref/source/training_management/training_jobs/querying_monitoring_information_about_a_single_container_of_a_job.rst create mode 100644 api-ref/source/training_management/training_jobs/querying_monitoring_information_about_resource_pool_nodes.rst create mode 100644 api-ref/source/training_management/training_jobs/querying_the_details_about_a_training_job_version.rst create mode 100644 api-ref/source/training_management/training_jobs/querying_the_statuses_and_gpu_quantity_of_all_job_versions.rst create mode 100644 api-ref/source/training_management/training_jobs/querying_training_job_logs.rst create mode 100644 api-ref/source/training_management/training_jobs/stopping_a_training_job.rst create mode 100644 api-ref/source/training_management/visualization_jobs/creating_a_visualization_job.rst create mode 100644 api-ref/source/training_management/visualization_jobs/deleting_a_visualization_job.rst create mode 100644 api-ref/source/training_management/visualization_jobs/index.rst create mode 100644 api-ref/source/training_management/visualization_jobs/modifying_the_description_of_a_visualization_job.rst create mode 100644 api-ref/source/training_management/visualization_jobs/querying_a_visualization_job_list.rst create mode 100644 api-ref/source/training_management/visualization_jobs/querying_the_details_about_a_visualization_job.rst create mode 100644 api-ref/source/training_management/visualization_jobs/restarting_a_visualization_job.rst create mode 100644 api-ref/source/training_management/visualization_jobs/stopping_a_visualization_job.rst create mode 100644 api-ref/source/workspace_management/creating_a_workspace.rst create mode 100644 api-ref/source/workspace_management/deleting_a_workspace.rst create mode 100644 api-ref/source/workspace_management/index.rst create mode 100644 api-ref/source/workspace_management/modifying_a_workspace.rst create mode 100644 api-ref/source/workspace_management/modifying_a_workspace_quota.rst create mode 100644 api-ref/source/workspace_management/querying_a_workspace_list.rst create mode 100644 api-ref/source/workspace_management/querying_a_workspace_quota.rst create mode 100644 api-ref/source/workspace_management/querying_details_about_a_workspace.rst diff --git a/.zuul.yaml b/.zuul.yaml index d710d64..5c75543 100644 --- a/.zuul.yaml +++ b/.zuul.yaml @@ -3,6 +3,7 @@ merge-mode: squash-merge default-branch: main templates: + - api-ref-hc-jobs - umn-hc-jobs check: jobs: diff --git a/api-ref/source/_static/images/en-us_image_0000001126894914.png b/api-ref/source/_static/images/en-us_image_0000001126894914.png new file mode 100644 index 0000000000000000000000000000000000000000..371f8e2ef43ca3c3d02113493945aa99de4f7fa8 GIT binary patch literal 20267 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 literal 0 HcmV?d00001 diff --git a/api-ref/source/_static/images/en-us_image_0150916848.gif b/api-ref/source/_static/images/en-us_image_0150916848.gif new file mode 100644 index 0000000000000000000000000000000000000000..d5d6a5eb2eea020dccca3be9dfe5faa8138c298d GIT binary patch literal 48314 zcmWh!2{=^W8@_k;88c?A%~;1iBn=_EF_fj$gbJw$S<|#hq-L>`M%g1{8QGf_g;HZp zDya~XriG9Y70R#q`=94L_c{AH_nh~h`+e{Ej(1~z$M@;0BHPE@;rX@^x1%u z!B%AVu)veYPpwDEyN@0X3k(Jffpz!)lF1T@q-(x!d3kwgXlQfBha_8Z@#NfP}JJz5tuNv-v0PxV_#$I z&}3t4S3+xJoS>_5vUR=T`k{=*q4jWILQx~#%46MSv}VjNFK5JMoGPjxC!y-s1Az&r zB1j%_3FCqDRApxdd&grc|zH;?+EdEglBa`)tyBPJKk&WNW>EB%o)H zTV=-)vfT*T2?EkMAv+_2-X|GKhzJz)H4;#y2w%6!t^|_tdhPM~K2l#FNstgIIMqlX zco5<=#+Nndg2uSX$vDCKNahLk^MuLyxb;yP8=stV}RuR4g4_^VDK=&Xl&(C)i6~z(e z>Ba<-)%q&T3j~w%86JH_lY+j<`oN5$uAwf$IF^W*ic^W&4_>!4hoUtWhYN&@T|kaJ=39oWBQ4g7k9r5(vwDK{IJ6J=d# z#LeN)drp);$t2sSVO>vFJiS8MU9fv5f@0*TvG}Kyb>Vm)ivV_LPsJh8d zaSP4%4A1gSr(aj@EO9&IW){A;%KL`z`@&x}Lk)h9(|);`NBRgupA;Uv_PcKMUgU?~ zGds3M9c+p@R>tFRP<40=1uRH_Gp*GI3 zSEfHsWZa#8UA4P**Na%QoBindO^TEU*CWw)17F^&SKfMj{87Y*K3vht!iOh`^ZV2u z-v2Stm*u$GsMYe!RT|GA91~U@>*p3^wFZz zePK5WVvbhJD<+wd9pJL2%-vAVA9PhI)y2O98rLMAD(7u)c><-*3Om$4XMA?7EQlJN zw!rb_0=8;Unw(Lnq4H#WwyQ9+M2L_WMAY5w{ZoTG!Ps7Vtk3YC6DD))PPs6S)GfcO z{fG=wFlP-TddKnwkLT*?KWQt<-1a{+Hjes2cNv; zT6}5@xPPvG;n=Co`_48p->GhWANNi2p7`P7-{P&~{j$<4;KhsstMYJCC(}8r@&Gg<8Y4d)yHanqnKZx~N z`;j2?*uIS|h{eu#%zr!0+Xj!k(~3m!+pca?(H2v8Kp<^nZMEG>_cA>^KPSMYPt@JH z+;6_>b5$y~r=v~NQ~ldl+pc}{C|hcs);sB4LF8X*vQ=DJS$>j3Cmz1^PVK*-#Kf}J z?`%Q_AExKhhVfnC5TElATYK81V;8t;PN3~hnz8Joz6ALlqOQ5DTXOfrAQk{*Qp9** zmJG@;55io?Z1olCV9~oah(wW>s6eIN}ie~Z+v1RlcC1*wden4eGB!6US1Xm=? z#9==n(wUvmd}@l>7!=7Rb}APwa4k#$DA&comdb+a_-_I$W4I$1bQ`q|>6zb{ptMJS z0xIK#Ozf9-GK0zW&d`*0cLC%Ka=P8#i-{*5f(ivf)Ge8rt9-10;_TY%QMj00wNqfQ z|7q{Omc<-lhQKhy_1W%Ex?r5Qv(Yju@!8KSyC3)^qf-W2Y)!=h=FB$x3w(sxFeC4q zC?Nhe8K*VnfO*ZM8|MQMpbmg`@#xgGyHJEb4cAQT#}kEjaGOAdt^9G^(KZ%!I}2@2 zO_X(FN_Oe;A;>BrXmk_=J)a*zMpQu!9sBP$9{)gqtvLGJ(dN@(+pbE&iqw`rH z*SpiuoS%Tw4#43p5C%tIUE0$LIYR2{(#-srplwkK7LGY!Zi^FiMbHc1Vg^_9bqC61 ze^oiU*X+qj8xUAERx^TYyh^MFt2}X$J>{4_c3uLc=KtP!g;Ks&o!PJVj*44-oA2@d)Soi&Dg|y<3DdNx6WNU9`{x1@SooMk5*c5Uikj(!`kn&kN@GQEach; zh}5tMW+&{I?FSZhMSJnOo6&0nH&lnYzz=Vlje!t~d8-9lx#~v!Exf@+l#2g3q==Rw$GCiYA79yr@)dT0$&LMqMQoyiXb&M?&hR7ROe9_Q z9~yPe=`(`MYP)hx1!Hbd3JEHkQK`HBQe03Sw4<6>`Wbdm2fie0XU(1+_sRl zN3EwEeKNG&YDVMvnd}3h-$L0Br#H<p9&6w}C^y137J<%_Ol_iBfY(#PC8YZCVb zp-p`fFIn9Y_>ZvksM}o_E1M=#jqR5LDd%7m7L0PPjlsGS!h)p0q*hqa6xe4zGj|`m zek{J{8`5|Gctyymmfam&nnhaI{y>=b78LpTv)9a)&gzCc_{$ z8BPWEryqe@P3^EA=HmOowGA4wWn|ft2~vyDn@DTjyZFCk$fRzfmv_`&mqcCvM4w@p zhehJPmBi`au}3VDf~I0`zl{x|BsJepx}6vQW~(u?C+SsQ{L>A|$56@lLz1Icl8zGN zWAo$AO(mV7By(eut2d-1^(391O6E+(rbt$j<6@FBVv;jMlP=}Q9?wlJw1^ArNerYw z){^O()HGdM8b2njd>BHYftwgm0s~qz41xDU{)pr6#iTdor?(74>YCE)D3E#-czYP~ zo0{H5%xK8ZxY?A^Tb1#fobhrht+OYiJv8GK3Zgoy)!?B zW`2puoXO7|AI|(Zl{rnkJcr7h3C&zu$y`BQo@%hfwn zZ`p!38_JVZ@d&9rY%>p8z>}H2Omw}x(3H7Rgd3mAl8A7c&4B7imQvuAUqn!CI?G_> zih+K*F#`x=046?HjV-TQNU8y2pQ{)i0wcO=JaX062XOQO%xG7)=w~~pUNxz{YF2>Q z;d9m0GRMOw$5cPtt{~gTGRG2~&I@kNizVfqUd=m|niusncaWERaU}12L4G_sFNBoOOwB(UmYbxX&#TTq z|1_VqnxD3so7kL}9afMtofkfxAK6@RWxAjgU6^++FIvCw{L_M@>b#g~{4v+ud#->L z182p$<|Mp!Z{%8&4=$b$eKd`4uD;en%Ihh(b{Y*dP2-Dw@)Oa;Z_ve?s8_ca6g#_K zb#5+xS6wV#Eq*U4DE?x3{gcmi&(-3I=^W#*>)WSu=13)5ri-UjuRAwitsvmz33*LV zOCFH&BqJrjObN`2k1*h)l=v85KDw7L70btu@(DA1d8<-IgHobWsgiFgskc-)wp4wz zlsr?q=2NB{TSh4?GiWI@>@BPc60|DW}Djn}=uXiEzh9$~>$DUcQ2Tu>$Wxfp3ezZ&Yw7Tp;sDaHOzo6S;f~ z397}a3`?tw?5&I_tYpqq9>gDUJV=}@dK@@vwf>`W2^HEs|#DI_s14{J_X({1S%}x%iIj!6KX1bYiiPJ zYTRn-{?rJRAU9fS%KrpbS=BcA)>Nm}3YBUI)LIFlrp=(XeFmb%$XRVJDQc;EK3doJ zr!L!|+OXwXFsaNysq%n9`g!iKpPV0H$y z^2cjYufs)1cUYj5iJ=3aIM zdNFxc;%d{U^;4s_)c)Qgf4j9tfSR_Hn~}>60Psm~F`QQ-BUMjTzGGs2C;!iF8Oh(< z^3O^vHx^!4y^ZWG*`rj@`?O>flcS=1JDz}hwZ0()Qvuz(Pd@qzDxU;|Um>ek4;2JNlqBE?pR|-1$(y)9$=C1IAm{M#kRc-${_S5L8~Px*80jOFj`Z)r0}$5*ApITk zGas=@jNHJ1M6%!+51(!liZs7f!TYa|OoIkH%1xg_ki2_qtL;(@tOXx|q+%#Em@5r) zuMW}v4oT+2-Iy3bzqB0y%^d?S5RlyflFDk=7j`@-Xk+o(Qu!zg7If1BQXs}?^Wj{= z!#sU~d|aQ^wd$$o51+gfeDk~Y{kdR%t?yv?9UV8=?*+VB_M?Adyz;&>KnxM4gWBY0 zXU1Lv!k7JjO9mGJ(O>9Tc-bIN>KFrKb_d#iu6X%ry~zRqP^C9lKvjf~FVG+={?J$J zDYHm)|Eo0`o-BT)!bjvuP5>l81oXcGcrePQ2N!t|D>BsEzgNw=(WAM%dUpL^m7})< zGS=TnRKfTIkW$7L8zwAu0VZJJ%b8dK0ojR$I5RK;>fi()W&*q@Wnm0}7j+EGIbjDt zE^=mJUQeuxsL+W8oCI0*g&()0l-NFfjY;VJ|ZvrDF84V^C*NhcD2fsEi4^gppx92;2m5=EDHm za}x$8ll;tB`DK2ZIIl*W+bhyGtT~wta2gtv+SlbuXp7cP3!hfA>FR^Jp+EQ0t`k+bd+WeKkVKgTLk)6j-0z|Md&4};Qnr$ zxVvkhPqo5Oxvgx+RqLmajpS#bAEt^7F(FJ%@H#3P7|n&}$5~PljMgLWL+L_b{2{8T zAJqk*G;E~0sqIaC*q{oAMazx%$C+>WKG}e%6hCK*Q5C!HNbjotVOPCmSBZF37Tk=) z_6x?pNGmo7Uf0|*X5MwZ_IWM+P2=^2-QU3J)%C86(`qN&{~MrSAhic_dohqieMh2S z{^hXucQ#gYcH}8+#T+SUe$nV~^{Ic6yPc#0o5KQ(-OK6o zg2U>+7cvBaFZ+V#e|cek8`=vjYO4=!7APHn8j2taG|bt<;F*idW7{!CjOB}mL2Y2= z%!g$|5fFWOIjv+lW;Z0`_;RXbIof{Z{KaKM@+zlfCF$}i*M2o_H->j}Ir`>u#pC5O z$8T=BcGGsVz}@dxL&-F4?T>Bkbp7M0JIAN582xRmo_5@Lt7D_!#Qcb%k|1GYz2$?F z;FjW|xa-@WHhWI5jiCQ~w)^Uvmuqz2l7WlarZxBmi67wgsA5b~{6_NM_~z>kHrK!6 z|1%jG_^~jzY5v|p<)x#W?<~#>eti%uHXwsiyPOR;JMeD>L0ZqgMYiEyu1+bFyr%F ze8z|)`>HI7)$fonHFX`pq$z$s&JTn5$NjEGn43yGMyk;H*KHZm5sBry|4OSq*cvYG zyr}-zw&>^L=VsjEp{TLuP)<@{P$qx6|z}Q{qk7s?{7|l>UG;y zx1RYq7h%8kzb*D`ZkG3 zMzJ&*aFW?zK~|G>@D2dwK7VxXRG@2TU6a|rGi#fyqr7n^;joRk8_Iy)-hKf^eYH*A z@r!epM!L<(Zn<;MZ#gUbB%E;5*&BH>QMY7ZkDC!bWzo$*u=8Y>$(^x9XSLcjljr)$ z+Me5tUw!$p!+fyw)(+#3@}6BvC8s@JY(AH;rB_8#;HS~6`2Z{5M`#W+ehD4=xyVwC zGN2)GTPN;%?zV^1%KE%5{PBvvtNbBedJMBc%)a18j@O=pXD*|Uy5|h;4QXxMyMcLZ z@7w*!?;AOX6IIQf-&I2_#{a`oappD%@unR;rZD~DRb1SQc{GdCoUd9h(N1s7t&ZzM|lhTKezD)@FS zV4dtNYMm?mnmzcaIi%>VdEEEnkB>%z?zZ(c&)(Y`C7f(|bK%^P*5nKCChk}rCAGiP z#s(9x164-@pX%KwR9x{M);D~y^{dK8)gS@_{mNOd_4J$F&bDW?IWo4yfZ>IjQzIca zTBF}phdZ#dsnI+(Msv2DDD#Kn00Zb%G*6O&HwX}ZPj!D;_ycIf5_Cf^timZ@FF5X$ zBI~FPM(I6XD+hQWS~R~)dCvXWg?^Ozzb%h1{GESt(IHv(B4Y@xc$Puo2%&~kG#R4* z`j;k3FsyS#U^@ZK8UYE&JF0m!v2k=!f<)bdE@LmEDc*bA`t-z6O+E4US;8lLg;>|_ z1)4aHik5#=aqh1e;6^8H?QJq0jzZSNHNmTp94cJAc+=u=mMV)mx#C+D^74F(Mb^z zU?c0cO9#Ht?~ORgic;Z28rG6+4S)CUd;L1+{@q|BpXMD0hEC>bc!Myy_}Tt_{G3Nl zx|?%GE?pcj$yH3BFgZS*8K)v);at2O%G|Q6Vp#fWV}1@>@gm%bE2oOyn}%4u8hLTD zVaqia;uC0;&yJ(Lw{zRID^1T7JddAS%x|dsN%1jX_PyIdShJ!rtT1rgq!49E>Rr1$_V1sgJ8pB4axoQ9SOzT{76 z%G%ke8tVH9J99y?zz`PonWh3g}+f` z(k`dQ90D@~6Se}5w^Z^jpi+@gMMf@uzgT_B^RQWAKg=?PhUl=^mawZ7;r^e4 zT0)gXJLxhpX+ij{0kV}06YFYcG!T&sr*33Ku#Y-VbB1UreoW;CRv=mDp$w9K^S&ak1k8GCw`Vc1P>{3hy0q=+f#h7j)jxPnd9sJa4VIQA%g5NcrqO-jyE~vM`>W JQ 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 y-hWZQ#f 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 literal 0 HcmV?d00001 diff --git a/api-ref/source/_static/images/en-us_image_0150917350.gif b/api-ref/source/_static/images/en-us_image_0150917350.gif new file mode 100644 index 0000000000000000000000000000000000000000..b3e8034421a24d52aecc554744239232450a3fc6 GIT binary patch literal 42932 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%0DmEr(AKqP_+c%k3GfHmr`e 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 RLB@y_XSBKtfr)?s06StS&glRE literal 0 HcmV?d00001 diff --git a/api-ref/source/_static/images/en-us_image_0171113090.png b/api-ref/source/_static/images/en-us_image_0171113090.png new file mode 100644 index 0000000000000000000000000000000000000000..d4a37a976d4576d256107faeb20bd06794b51b43 GIT binary patch literal 51740 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%0AZD@BjI{u{Gzp=uHI(1CKApP%TB6 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μMKUP;j3tZz2lr=fW<}VJLdca4MNKQ^pP%GM| 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 literal 0 HcmV?d00001 diff --git a/api-ref/source/api_overview.rst b/api-ref/source/api_overview.rst new file mode 100644 index 0000000..d1bb9a9 --- /dev/null +++ b/api-ref/source/api_overview.rst @@ -0,0 +1,176 @@ +API Overview +============ + +All ModelArts APIs are proprietary. + +You can use these APIs to manage datasets, training jobs, models, and services. + +Data Management APIs +-------------------- + +Data management APIs include the APIs for managing datasets, dataset versions, samples, and labels. Use these APIs to create datasets and label data. For details, see `Data Management APIs `__. + +Development Environment APIs +---------------------------- + + + +.. _modelarts030002enustopic0129435564table6223102719106: + +.. table:: **Table 1** Development environment APIs + + +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+ + | API | Description | + +=======================================================================================================================================================================+============================================================================+ + | `Creating a Development Environment Instance `__ | Create a development environment instance for code development. | + +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+ + | `Querying a List of Development Environment Instances `__ | Query the development environment instances that meet the search criteria. | + +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+ + | `Querying the Details About a Development Environment Instance `__ | Query the details about a development environment instance. | + +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+ + | `Modifying the Description of a Development Environment Instance `__ | Modify the description of a development environment instance. | + +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+ + | `Deleting a Development Environment Instance `__ | Delete a development environment instance. | + +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+ + | `Managing a Development Environment Instance `__ | Start or stop a development environment instance. | + +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------+ + +Training Management APIs +------------------------ + + + +.. _modelarts030002enustopic0129435564table19560011132619: + +.. table:: **Table 2** Training management APIs + + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | Type | API | Description | + +======================================+=====================================================================================================================================================================================================+==============================================================================+ + | Training Jobs | `Creating a Training Job `__ | Create a training job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Querying a Training Job List `__ | Query the created training jobs that meet the search criteria. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Querying the Details About a Training Job Version `__ | Query the details about a specified training job based on the job ID. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Deleting a Version of a Training Job `__ | Delete a version of a training job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Querying a List of Training Job Versions `__ | Query the version of a specified training job based on the job ID. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Creating a Version of a Training Job `__ | Create a version of a training job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Stopping a Training Job `__ | Stop a training job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Modifying the Description of a Training Job `__ | Modify the description of a training job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Deleting a Training Job `__ | Delete a training job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Obtaining the Name of a Training Job Log File `__ | Obtain the name of a training job log file. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Querying a Built-in Algorithm `__ | Query the details about a built-in model. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Querying Training Job Logs `__ | Query detailed information about training job logs by row. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | Training Job Parameter Configuration | `Creating a Training Job Configuration `__ | Create a training job configuration. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Querying a List of Training Job Configurations `__ | Query the created training job configurations that meet the search criteria. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Modifying a Training Job Configuration `__ | Modify a training job configuration. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Deleting a Training Job Configuration `__ | Delete a training job configuration. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Querying the Details About a Training Job Configuration `__ | Query the details about a specified training job configuration. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | Visualization Job Management | `Creating a Visualization Job `__ | Create a visualization job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Querying a Visualization Job List `__ | Query the visualization jobs that meet the search criteria. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Querying the Details About a Visualization Job `__ | Query the details about a specified visualization job based on the job name. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Modifying the Description of a Visualization Job `__ | Modify the description of a visualization job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Deleting a Visualization Job `__ | Delete a visualization job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Stopping a Visualization Job `__ | Stop a visualization job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Restarting a Visualization Job `__ | Restart a visualization job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | Resource and Engine Specifications | `Querying Job Resource Specifications `__ | Query the resource specifications of a specified job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | | `Querying Job Engine Specifications `__ | Query the engine type and version of a specified job. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | Job Statuses | `Job Statuses `__ | View job statuses and status description. | + +--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + +Model Management APIs +--------------------- + + + +.. _modelarts030002enustopic0129435564table172059163715: + +.. table:: **Table 3** Model management APIs + + +--------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | API | Description | + +==========================================================================================================================+=============================================================================================================+ + | `Importing a Model `__ | Import a model. | + +--------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | `Querying a Model List `__ | Query the models that meet the search criteria. | + +--------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | `Querying the Details About a Model `__ | Query details about a model based on the model ID. | + +--------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | `Deleting a Model `__ | Delete a specified model based on the model ID. All versions of the model can be deleted in cascading mode. | + +--------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + +Service Management APIs +----------------------- + + + +.. _modelarts030002enustopic0129435564table17144179535: + +.. table:: **Table 4** Service management APIs + + +---------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ + | API | Description | + +=========================================================================================================================================================+==============================================================================================================================+ + | `Deploying a Model as a Service `__ | Deploy a model service. | + +---------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ + | `Querying a Service List `__ | Query model services. | + +---------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ + | `Querying the Details About a Service `__ | Query the details about a model service based on the service ID. | + +---------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ + | `Updating Service Configurations `__ | Update a model service. | + +---------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ + | `Querying Service Monitoring Information `__ | Query service monitoring information. | + +---------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ + | `Querying Service Update Logs `__ | Query the update logs of a real-time service. | + +---------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ + | `Querying Service Event Logs `__ | Query service event logs, including service operation records, key actions during deployment, and deployment failure causes. | + +---------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ + | `Deleting a Service `__ | Delete a model service. | + +---------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ + | `Querying Supported Service Deployment Specifications `__ | Query supported service deployment specifications. | + +---------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ + +Authorization Management APIs +----------------------------- + + + +.. _modelarts030002enustopic0129435564table19853112615335: + +.. table:: **Table 5** Workspace management APIs + + +-------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | API | Description | + +=================================================================================================+=========================================================================================================================================================================================================================+ + | `Viewing an Authorization List `__ | View an authorization list. | + +-------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | `Configuring Authorization `__ | Configure ModelArts authorization. ModelArts functions such as training management, development environment, data management, and real-time services can be properly used only after required permissions are assigned. | + +-------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | `Deleting Authorization `__ | Delete the authorization of a specified user or all users. | + +-------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | `Creating a ModelArts Agency `__ | Create a ModelArts agency for dependent services such as OBS, SWR, and IEF. | + +-------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ diff --git a/api-ref/source/application_cases/creating_a_training_job_using_the_tensorflow_framework.rst b/api-ref/source/application_cases/creating_a_training_job_using_the_tensorflow_framework.rst new file mode 100644 index 0000000..d67338c --- /dev/null +++ b/api-ref/source/application_cases/creating_a_training_job_using_the_tensorflow_framework.rst @@ -0,0 +1,449 @@ +Creating a Training Job Using the TensorFlow Framework +====================================================== + +Overview +-------- + +This section describes how to train a model on ModelArts by calling a series of APIs. + +The process for creating a training job using the TensorFlow framework is as follows: + +#. Call the API in `Authentication <../calling_apis/authentication.html#modelarts030004>`__ to obtain the user token, which will be put into the request header for authentication in a subsequent request. +#. Call the API in `Querying Job Resource Specifications <../training_management/resource_and_engine_specifications/querying_job_resource_specifications.html#modelarts030072>`__ to obtain the resource flavors available for training jobs. +#. Call the API in `Querying Job Engine Specifications <../training_management/resource_and_engine_specifications/querying_job_engine_specifications.html#modelarts030073>`__ to view the engine types and versions available for training jobs. +#. Call the API in `Creating a Training Job <../training_management/training_jobs/creating_a_training_job.html#modelarts030045>`__ to create a training job. +#. Call the API in `Querying the Details About a Training Job Version <../training_management/training_jobs/querying_the_details_about_a_training_job_version.html#modelarts030047>`__ to query the details about the training job based on the job ID. +#. Call the API in `Obtaining the Name of a Training Job Log File <../training_management/training_jobs/obtaining_the_name_of_a_training_job_log_file.html#modelarts030054>`__ to obtain the name of the training job log file. +#. Call the API in `Querying Training Job Logs <../training_management/training_jobs/querying_training_job_logs.html#modelarts030149>`__ to view the log details of the training job. +#. Call the API in `Deleting a Training Job <../training_management/training_jobs/deleting_a_training_job.html#modelarts030053>`__ to delete the training job if it is no longer needed. + +Prerequisites +------------- + +- You have obtained the endpoints of and `ModelArts <../before_you_start/endpoints.html>`__. +- You have located the region where the service is deployed and obtained . +- You have obtained the project ID. For details, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. +- You have prepared the training code for TensorFlow. For example, you have stored the boot file **train_mnist_tf.py** in the **/test-modelarts/mnist-tensorflow-code/** directory of OBS. +- You have prepared a dataset for the training job. For example, you have stored a training dataset in the **/test-modelarts/dataset-mnist/** directory of OBS. +- You have created the output path of the training job, for example, **/test-modelarts/mnist-model/output/**. + +Procedure +--------- + +#. Call the API in `Authentication <../calling_apis/authentication.html#modelarts030004>`__ to obtain the user token. + + a. Request body: + + URI format: POST https://**{iam_endpoint}**/v3/auth/tokens + + Request header: Content-Type → application/json + + Request body: + + .. code-block:: + + { + "auth": { + "identity": { + "methods": ["password"], + "password": { + "user": { + "name": "username", + "password": "**********", + "domain": { + "name": "domainname" + } + } + } + }, + "scope": { + "project": { + "name": "" + } + } + } + } + + Set the italic fields in bold based on the site requirements. + + - Replace **iam_endpoint** with the IAM endpoint. + - Replace **username** with the IAM username. + - Replace **\*******\*** with the login password of the user. + - Replace **domainname** with the account to which the user belongs. + - Replace with the project name, which indicates the zone where the service is deployed. + + b. The status code **201 Created** is returned. The value of **X-Subject-Token** in the response header is the token. + + .. code-block:: + + x-subject-token →MIIZmgYJKoZIhvcNAQcCoIIZizCCGYcCAQExDTALBglghkgBZQMEAgEwgXXXXXX... + +#. Call the API in `Querying Job Resource Specifications <../training_management/resource_and_engine_specifications/querying_job_resource_specifications.html#modelarts030072>`__ to obtain the resource flavors available for training jobs. + + a. Request body: + + URI format: GET https://**{ma_endpoint}**/v1/**{project_id}**/job/resource-specs?job_type=train + + Request header: X-auth-Token →\ **MIIZmgYJKoZIhvcNAQcCoIIZizCCGYcCAQExDTALBglghkgBZQMEAgEwgXXXXXX...** + + Set the italic fields in bold based on the site requirements. + + - Replace **ma_endpoint** with the ModelArts endpoint. + - Replace **project_id** with the project ID of the user. + - Set **X-auth-Token** to the token obtained in `1 <#modelarts030401enustopic0000001073831232li1438114133315>`__. + + b. The status code **200 OK** is returned. The response body is as follows: + + .. code-block:: + + { + "specs": [ + ...... + { + "spec_id": 7, + "core": "2", + "cpu": "8", + "gpu_num": 0, + "gpu_type": "", + "spec_code": "modelarts.vm.cpu.2u", + "unit_num": 1, + "max_num": 1, + "storage": "", + "interface_type": 1, + "no_resource": false + }, + { + "spec_id": 27, + "core": "8", + "cpu": "32", + "gpu_num": 0, + "gpu_type": "", + "spec_code": "modelarts.vm.cpu.8u", + "unit_num": 1, + "max_num": 1, + "storage": "", + "interface_type": 1, + "no_resource": false + } + ], + "is_success": true, + "spec_total_count": 5 + } + + - Select and record the flavor type required for creating the training job based on the **spec_code** field. This section uses **modelarts.vm.cpu.8u** as an example and records the value of the **max_num** field as **1**. + - The **no_resource** field is used to determine whether resources are sufficient. Value **false** indicates that resources are available. + +#. Call the API in `Querying Job Engine Specifications <../training_management/resource_and_engine_specifications/querying_job_engine_specifications.html#modelarts030073>`__ to view the engine types and versions available for training jobs. + + a. Request body: + + URI format: GET https://**{ma_endpoint}**/v1/**{project_id}**/job/ai-engines?job_type=train + + Request header: X-auth-Token →\ **MIIZmgYJKoZIhvcNAQcCoIIZizCCGYcCAQExDTALBglghkgBZQMEAgEwgXXXXXX...** + + Set the italic fields in bold based on the site requirements. + + - Replace **ma_endpoint** with the ModelArts endpoint. + - Replace **project_id** with the project ID of the user. + - Set **X-auth-Token** to the token obtained in `1 <#modelarts030401enustopic0000001073831232li1438114133315>`__. + + b. The status code **200 OK** is returned. The response body is as follows: + + .. code-block:: + + { + "engines": [ + { + "engine_type": 13, + "engine_name": "Ascend-Powered-Engine", + "engine_id": 130, + "engine_version": "TF-1.15-python3.7-aarch64" + }, + ...... + { + "engine_type": 1, + "engine_name": "TensorFlow", + "engine_id": 3, + "engine_version": "TF-1.8.0-python2.7" + }, + { + "engine_type": 1, + "engine_name": "TensorFlow", + "engine_id": 4, + "engine_version": "TF-1.8.0-python3.6" + }, + ...... + { + "engine_type": 9, + "engine_name": "XGBoost-Sklearn", + "engine_id": 100, + "engine_version": "XGBoost-0.80-Sklearn-0.18.1-python3.6" + } + ], + "is_success": true + } + + Select the engine flavor required for creating a training job based on the **engine_name** and **engine_version** fields and record **engine_id**. This section describes how to create a job based on the TensorFlow engine. Record **engine_id** as **4**. + +#. Call the API in `Creating a Training Job <../training_management/training_jobs/creating_a_training_job.html#modelarts030045>`__ to create a training job named **jobtest_TF** based on the TensorFlow framework. + + a. Request body: + + URI format: POST https://**{ma_endpoint}**/v1/**{project_id}**/training-jobs + + Request header: + + - X-auth-Token →\ **MIIZmgYJKoZIhvcNAQcCoIIZizCCGYcCAQExDTALBglghkgBZQMEAgEwgXXXXXX...** + - Content-Type →application/json + + Request body: + + .. code-block:: + + { + "job_name": "jobtest_TF", + "job_desc": "using TensorFlow for handwritten digit recognition", + "config": { + "worker_server_num": 1, + "parameter": [], + "flavor": { + "code": "modelarts.vm.cpu.8u" + }, + "train_url": "/test-modelarts/mnist-model/output/", + "engine_id": 4, + "app_url": "/test-modelarts/mnist-tensorflow-code/", + "boot_file_url": "/test-modelarts/mnist-tensorflow-code/train_mnist_tf.py", + "data_source": [ + { + "type": "obs", + "data_url": "/test-modelarts/dataset-mnist/" + } + ] + }, + "notification": { + "topic_urn": "", + "events": [] + }, + "workspace_id": "0" + } + + Set the italic fields in bold based on the site requirements. + + - Set **job_name** and **job_desc** to the name and description of the training job. + - Set **worker_server_num** and **code** to the values of **max_num** and **spec_code** obtained in `2 <#modelarts030401enustopic0000001073831232li384513468342>`__. + - Set **engine_id** to the engine ID obtained in `3 <#modelarts030401enustopic0000001073831232li12845104623418>`__. + - Set **train_url** to the output directory of the training job. + - Set **app_url** and **boot_file_url** to the code directory and code boot file of the training job, respectively. + - Set **data_url** to the dataset directory used by the training job. + + b. The status code **200 OK** is returned, indicating that the training job has been created. The response body is as follows: + + .. code-block:: + + { + "version_name": "V0001", + "job_name": "jobtest_TF", + "create_time": 1609121837000, + "job_id": 567524, + "resource_id": "jobaedef089", + "version_id": 1108482, + "is_success": true, + "status": 1 + } + + - Record the values of **job_id** (training job ID) and **version_id** (training job version ID) for future use. + - The value of **status** is **1**, indicating that the training job is being initialized. + +#. Call the API in `Querying the Details About a Training Job Version <../training_management/training_jobs/querying_the_details_about_a_training_job_version.html#modelarts030047>`__ to query the details about the training job based on the job ID. + + a. Request body: + + URI format: GET https://**{ma_endpoint}**/v1/**{project_id}**/training-jobs/**567524**/versions/**1108482** + + Request header: X-auth-Token →\ **MIIZmgYJKoZIhvcNAQcCoIIZizCCGYcCAQExDTALBglghkgBZQMEAgEwgXXXXXX...** + + Set the italic fields in bold based on the site requirements. + + - Replace *567524* with the value of **job_id** recorded in `4 <#modelarts030401enustopic0000001073831232li5845144683416>`__. + - Replace *1108482* with the value of **version_id** recorded in `4 <#modelarts030401enustopic0000001073831232li5845144683416>`__. + + b. The status code **200 OK** is returned. The response body is as follows: + + .. code-block:: + + { + "dataset_name": null, + "duration": 1326, + "spec_code": "modelarts.vm.cpu.8u", + "parameter": [], + "start_time": 1609121913000, + "model_outputs": [], + "engine_name": "TensorFlow", + "error_result": null, + "gpu_type": "", + "user_frame_image": null, + "gpu": null, + "dataset_id": null, + "nas_mount_path": null, + "task_summary": {}, + "max_num": 1, + "model_metric_list": "{}", + "is_zombie": null, + "flavor_code": "modelarts.vm.cpu.8u", + "gpu_num": 0, + "train_url": "/test-modelarts/mnist-model/output/", + "engine_type": 1, + "job_name": "jobtest_TF", + "nas_type": "efs", + "outputs": null, + "job_id": 567524, + "data_url": "/test-modelarts/dataset-mnist/", + "log_url": null, + "boot_file_url": "/test-modelarts/mnist-tensorflow-code/train_mnist_tf.py", + "volumes": null, + "dataset_version_id": null, + "algorithm_id": null, + "worker_server_num": 1, + "pool_type": "SYSTEM_DEFINED", + "autosearch_config": null, + "job_desc": "using TensorFlow for handwritten digit recognition", + "inputs": null, + "model_id": null, + "dataset_version_name": null, + "pool_name": "hec-train-pub-cpu", + "engine_version": "TF-1.8.0-python3.6", + "system_metric_list": { + "recvBytesRate": [ + "0", + "0" + ], + "cpuUsage": [ + "0", + "0" + ], + "sendBytesRate": [ + "0", + "0" + ], + "memUsage": [ + "0", + "0" + ], + "gpuUtil": [ + "0", + "0" + ], + "gpuMemUsage": [ + "0", + "0" + ], + "interval": 1, + "diskWriteRate": [ + "0", + "0" + ], + "diskReadRate": [ + "0", + "0" + ] + }, + "retrain_model_id": null, + "version_name": "V0001", + "pod_version": "1.8.0-cp36", + "engine_id": 4, + "status": 10, + "cpu": "32", + "user_image_url": null, + "spec_id": 27, + "is_success": true, + "storage": "", + "nas_share_addr": null, + "version_id": 1108482, + "no_resource": false, + "user_command": null, + "resource_id": "jobaedef089", + "core": "8", + "npu_info": null, + "app_url": "/test-modelarts/mnist-tensorflow-code/", + "data_source": [ + { + "type": "obs", + "data_url": "/test-modelarts/dataset-mnist/" + } + ], + "pre_version_id": null, + "create_time": 1609121837000, + "job_type": 1, + "pool_id": "pool7d1e384a" + } + + You can learn about the version details of the training job based on the response. The value of **status** is **10**, indicating that the training job is successful. + +#. Call the API in `Obtaining the Name of a Training Job Log File <../training_management/training_jobs/obtaining_the_name_of_a_training_job_log_file.html#modelarts030054>`__ to obtain the name of the training job log file. + + a. Request body: + + URI format: GET https://**{ma_endpoint}**/v1/**{project_id}**/training-jobs/**567524**/versions/**1108482**/log/file-names + + Request header: X-auth-Token →\ **MIIZmgYJKoZIhvcNAQcCoIIZizCCGYcCAQExDTALBglghkgBZQMEAgEwgXXXXXX...** + + Set the italic fields in bold based on the site requirements. + + b. The status code **200 OK** is returned. The response body is as follows: + + .. code-block:: + + { + "is_success": true, + "log_file_list": [ + "job-jobtest-tf.0" + ] + } + + Only one log file named **job-jobtest-tf.0** exists. + +#. Call the API in `Querying Training Job Logs <../training_management/training_jobs/querying_training_job_logs.html#modelarts030149>`__ to query details about eight rows in the training job log file. + + a. Request body: + + URI format: GET https://**{ma_endpoint}**/v1/**{project_id}**/training-jobs/**567524**/versions/**1108482**/aom-log?log_file=\ **job-jobtest-tf.0**\ &lines=\ **8**\ &order=\ **desc** + + Request header: X-auth-Token →\ **MIIZmgYJKoZIhvcNAQcCoIIZizCCGYcCAQExDTALBglghkgBZQMEAgEwgXXXXXX...** + + Set the italic fields in bold based on the site requirements. + + - Set **log_file** to the name of the log file obtained in `6 <#modelarts030401enustopic0000001073831232li52217241518>`__. + - Set **lines** to the rows to be obtained in the log file. + - Set **order** to the log query direction. + + b. The status code **200 OK** is returned. The response body is as follows: + + .. code-block:: + + { + "start_line": "1609121886518240330", + "lines": 8, + "is_success": true, + "end_line": "1609121900042593083", + "content": "Done exporting!\n\n[Modelarts Service Log]Training completed.\n\n[ModelArts Service Log]modelarts-pipe: will create log file /tmp/log/jobtest_TF.log\n\n[ModelArts Service Log]modelarts-pipe: will create log file /tmp/log/jobtest_TF.log\n\n[ModelArts Service Log]modelarts-pipe: will write log file /tmp/log/jobtest_TF.log\n\n[ModelArts Service Log]modelarts-pipe: param for max log length: 1073741824\n\n[ModelArts Service Log]modelarts-pipe: param for whether exit on overflow: 0\n\n[ModelArts Service Log]modelarts-pipe: total length: 23303\n" + } + +#. Call the API in `Deleting a Training Job <../training_management/training_jobs/deleting_a_training_job.html#modelarts030053>`__ to delete the training job if it is no longer needed. + + a. Request body: + + URI format: GET https://**{ma_endpoint}**/v1/**{project_id}**/training-jobs/**567524** + + Request header: X-auth-Token →\ **MIIZmgYJKoZIhvcNAQcCoIIZizCCGYcCAQExDTALBglghkgBZQMEAgEwgXXXXXX...** + + Set the italic fields in bold based on the site requirements. + + b. The status code **200 OK** is returned, indicating that the job has been deleted. The response is as follows: + + .. code-block:: + + { + "is_success": true + } + + diff --git a/api-ref/source/application_cases/index.rst b/api-ref/source/application_cases/index.rst new file mode 100644 index 0000000..44c8901 --- /dev/null +++ b/api-ref/source/application_cases/index.rst @@ -0,0 +1,8 @@ +================= +Application Cases +================= + +.. toctree:: + :maxdepth: 1 + + creating_a_training_job_using_the_tensorflow_framework diff --git a/api-ref/source/authorization_management/configuring_authorization.rst b/api-ref/source/authorization_management/configuring_authorization.rst new file mode 100644 index 0000000..20da12a --- /dev/null +++ b/api-ref/source/authorization_management/configuring_authorization.rst @@ -0,0 +1,114 @@ +Configuring Authorization +========================= + +Function +-------- + +This API is used to configure ModelArts authorization. ModelArts functions such as training management, development environment, data management, and real-time services can be properly used only after required permissions are assigned. The administrator can use this API to set an agency for IAM users and set the access key of the current user. + +URI +--- + +POST /v2/{project_id}/authorizations + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=======================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain a project ID, see `Obtaining a Project ID <../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateAuthorizationrequestAuthorizationRequest: + +.. table:: **Table 2** Request body parameters + + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+====================================================================================================================================================+ + | user_id | No | String | User ID. For details about how to obtain a user ID, see `Obtaining a User ID <../common_parameters/obtaining_a_username_and_id.html>`__. | + | | | | | + | | | | If **user_id** is set to **all**, all IAM users are authorized. If some IAM users have been authorized, the authorization setting will be updated. | + | | | | | + | | | | This parameter is mandatory only if the authorization type is set to **agency**. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | String | Authorization type. **Agency** is recommended. | + | | | | | + | | | | Options: | + | | | | | + | | | | - **agency**: authorization through an agency | + | | | | | + | | | | - **credential**: authorization through an access Key (AK/SK) | + | | | | | + | | | | Default: **agency** | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | content | Yes | String | Authorization content. | + | | | | | + | | | | - If **Authorization Type** is set to **Agency**, this field indicates the agency name. | + | | | | | + | | | | - If **Authorization Type** is set to **AK/SK**, this field indicates the access key ID (AK). | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | secret_key | No | String | Secret Access Key (SK). This field is required only when **Authorization Method** is set to **AK/SK**. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Upload authorization. + +.. code-block:: + + POST https://{endpoint}/v2/{project_id}/authorizations + + { + "user_id" : "****d80fb058844ae8b82aa66d9fe****", + "type" : "agency", + "content" : "modelarts_agency" + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "result" : "true" + } + +Status Codes +------------ + + + +.. _CreateAuthorizationstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +400 Bad Request +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/authorization_management/creating_a_modelarts_agency.rst b/api-ref/source/authorization_management/creating_a_modelarts_agency.rst new file mode 100644 index 0000000..ff308eb --- /dev/null +++ b/api-ref/source/authorization_management/creating_a_modelarts_agency.rst @@ -0,0 +1,98 @@ +Creating a ModelArts Agency +=========================== + +Function +-------- + +This API is used to create an agency so that ModelArts can access dependent services such as OBS, SWR, and IEF. + +URI +--- + +POST /v2/{project_id}/agency + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=======================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain a project ID, see `Obtaining a Project ID <../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateModelArtsAgencyrequestCreateModelArtsAgencyRequest: + +.. table:: **Table 2** Request body parameters + + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+=================+=================+============================================================================================================================+ + | agency_name_suffix | No | String | Agency name suffix. | + | | | | | + | | | | The parameter contains a maximum of 50 characters. | + | | | | | + | | | | The agency name prefix is consistently to be **ma_agency**. | + | | | | | + | | | | For example, if the value of this parameter is **iam-user01**, the name of the created agency is **ma_agency_iam-user01**. | + | | | | | + | | | | The value of this parameter is left blank by default, indicating that an agency named **modelarts_agency** is created. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Create a ModelArts agency. + +.. code-block:: + + POST https://{endpoint}/v2/{project_id}/agency + + { + "agency_name_suffix" : "iam-user01" + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "agency_name" : "ma_agency_iam-user01" + } + +Status Codes +------------ + + + +.. _CreateModelArtsAgencystatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +400 Bad Request +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/authorization_management/deleting_authorization.rst b/api-ref/source/authorization_management/deleting_authorization.rst new file mode 100644 index 0000000..bc28217 --- /dev/null +++ b/api-ref/source/authorization_management/deleting_authorization.rst @@ -0,0 +1,84 @@ +Deleting Authorization +====================== + +Function +-------- + +This API is used to delete the authorization of a specified user or all users. + +URI +--- + +DELETE /v2/{project_id}/authorizations + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=======================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain a project ID, see `Obtaining a Project ID <../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------+-----------+--------+---------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+===================================================================================================+ + | user_id | No | String | User ID. If this parameter is set to **all**, the authorization of all IAM users will be deleted. | + +-----------+-----------+--------+---------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Delete the authorization of a specified user. + +.. code-block:: + + DELETE https://{endpoint}/v2/{project_id}/authorizations?user_id=****d80fb058844ae8b82aa66d9fe**** + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "result" : "true" + } + +Status Codes +------------ + + + +.. _DeleteAuthorizationsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +400 Bad Request +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/authorization_management/index.rst b/api-ref/source/authorization_management/index.rst new file mode 100644 index 0000000..ba83d54 --- /dev/null +++ b/api-ref/source/authorization_management/index.rst @@ -0,0 +1,11 @@ +======================== +Authorization Management +======================== + +.. toctree:: + :maxdepth: 1 + + configuring_authorization + viewing_an_authorization_list + deleting_authorization + creating_a_modelarts_agency diff --git a/api-ref/source/authorization_management/viewing_an_authorization_list.rst b/api-ref/source/authorization_management/viewing_an_authorization_list.rst new file mode 100644 index 0000000..6b1e171 --- /dev/null +++ b/api-ref/source/authorization_management/viewing_an_authorization_list.rst @@ -0,0 +1,165 @@ +Viewing an Authorization List +============================= + +Function +-------- + +This API is used to view an authorization list. + +URI +--- + +GET /v2/{project_id}/authorizations + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=======================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain a project ID, see `Obtaining a Project ID <../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==========================================================================+ + | sort_by | No | String | Sorting field. | + | | | | | + | | | | Options: | + | | | | | + | | | | - **user_name**: IAM user | + | | | | | + | | | | - **create_time**: creation time | + | | | | | + | | | | Default: **user_name** | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------+ + | order | No | String | Sorting method. | + | | | | | + | | | | Options: | + | | | | | + | | | | - **asc**: ascending order | + | | | | | + | | | | - **desc**: descending order | + | | | | | + | | | | Default: **asc** | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------+ + | limit | No | Integer | Maximum number of records returned on each page. Default value: **1000** | + | | | | | + | | | | The value ranges from 1 to 1000. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _GetAuthorizationsresponseAuthorizationListResponse: + +.. table:: **Table 3** Response body parameters + + +-------------+----------------------------------------------------------------------------------------------+---------------------------------+ + | Parameter | Type | Description | + +=============+==============================================================================================+=================================+ + | total_count | Number | Authorization information. | + +-------------+----------------------------------------------------------------------------------------------+---------------------------------+ + | auth | Array of `AuthorizationResponse <#getauthorizationsresponseauthorizationresponse>`__ objects | Authorization information list. | + +-------------+----------------------------------------------------------------------------------------------+---------------------------------+ + + + +.. _GetAuthorizationsresponseAuthorizationResponse: + +.. table:: **Table 4** AuthorizationResponse + + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+====================================================================================================================================================+ + | user_id | String | User ID. For details about how to obtain a user ID, see `Obtaining a User ID <../common_parameters/obtaining_a_username_and_id.html>`__. | + | | | | + | | | If **user_id** is set to **all**, all IAM users are authorized. If some IAM users have been authorized, the authorization setting will be updated. | + | | | | + | | | This parameter is mandatory only if the authorization type is set to **agency**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Authorization type. **Agency** is recommended. | + | | | | + | | | Options: | + | | | | + | | | - **agency**: authorization through an agency | + | | | | + | | | - **credential**: authorization through an access Key (AK/SK) | + | | | | + | | | Default: **agency** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | content | String | Authorization content. | + | | | | + | | | - If **Authorization Type** is set to **Agency**, this field indicates the agency name. | + | | | | + | | | - If **Authorization Type** is set to **AK/SK**, this field indicates the access key ID (AK). | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | secret_key | String | Secret Access Key (SK). This field is required only when **Authorization Method** is set to **AK/SK**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Timestamp when the quality job was created. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +View an authorization list. + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/authorizations + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "total_count" : 1, + "auth" : [ { + "user_id" : "****d80fb058844ae8b82aa66d9fe****", + "user_name" : "iam-user01", + "type" : "agency", + "content" : "modelarts_agency", + "create_time" : 15657747821288 + } ] + } + +Status Codes +------------ + + + +.. _GetAuthorizationsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +400 Bad Request +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/before_you_start/api_calling.rst b/api-ref/source/before_you_start/api_calling.rst new file mode 100644 index 0000000..db74dd6 --- /dev/null +++ b/api-ref/source/before_you_start/api_calling.rst @@ -0,0 +1,6 @@ +API Calling +=========== + +ModelArts supports Representational State Transfer (REST) APIs, allowing you to call APIs using HTTPS. For details about API calling, see `Calling APIs <../calling_apis/making_an_api_request.html#modelarts030005>`__. + + diff --git a/api-ref/source/before_you_start/basic_concepts.rst b/api-ref/source/before_you_start/basic_concepts.rst new file mode 100644 index 0000000..c2ffc29 --- /dev/null +++ b/api-ref/source/before_you_start/basic_concepts.rst @@ -0,0 +1,26 @@ +Basic Concepts +============== + +- Account + + An account is created upon successful registration with the cloud platform. The account has full access permissions for all of its cloud services and resources. It can be used to reset user passwords and grant user permissions. + +- Region + + A region is a physical location where a cloud service is deployed. Availability zones (AZ) in the same region can communicate with each other over an intranet but AZs in different regions cannot communicate with each other. By creating cloud resources in different regions, you can design applications to better meet customer requirements and comply with local laws and regulations. + +- AZ + + An AZ contains one or more physical data centers. It has independent cooling, fire extinguishing, moisture-proof, and electricity facilities. Within an AZ, computing, network, storage, and other resources are logically divided into multiple clusters. AZs within a region are interconnected using high-speed optical fibers to allow users to build cross-AZ high-availability systems. + +- Project + + Projects group and isolate compute, storage, and network resources across physical regions. A default project is provided for each region, and subprojects can be created under each default project. Users can be granted permissions to access all resources in a specific project. For more refined access control, create subprojects under a project and purchase resources in the subprojects. Users can then be assigned permissions to access only specific resources in the subprojects. + + .. figure:: /_static/images/en-us_image_0171392261.gif + :alt: **Figure 1** Project isolation model + + + **Figure 1** Project isolation model + + diff --git a/api-ref/source/before_you_start/endpoints.rst b/api-ref/source/before_you_start/endpoints.rst new file mode 100644 index 0000000..7b94b88 --- /dev/null +++ b/api-ref/source/before_you_start/endpoints.rst @@ -0,0 +1,28 @@ +Endpoints +========= + +Endpoints are **request address** for calling APIs. Endpoints vary depending on services and regions. To obtain the regions and endpoints, contact the enterprise administrator. + +A service endpoint consists of the service name, region ID, and external domain name in the format of "{service_name}.{region_id}.{external_domain_name}". For details about how to obtain each parameter, see `Table 1 <#modelarts030141enustopic0000001072357044table8700253831>`__. + + + +.. _modelarts030141enustopic0000001072357044table8700253831: + +.. table:: **Table 1** Obtaining an endpoint + + +----------------------+-------------------------------------------------+------------------------------------------+ + | Parameter | Description | How to Obtain | + +======================+=================================================+==========================================+ + | service_name | Abbreviation of a case-insensitive service name | **modelarts** for ModelArts by default. | + +----------------------+-------------------------------------------------+------------------------------------------+ + | region_id | Region ID | Obtain the value from the administrator. | + +----------------------+-------------------------------------------------+------------------------------------------+ + | external_domain_name | External domain name suffix | Obtain the value from the administrator. | + +----------------------+-------------------------------------------------+------------------------------------------+ + +.. important:: + + If an endpoint uses a domain name, configure the hosts file in the format of "{float-ip} {service_name}.{region_id}.{external_domain_name}" on the local PC. Obtain **float-ip** from the administrator. + + diff --git a/api-ref/source/before_you_start/index.rst b/api-ref/source/before_you_start/index.rst new file mode 100644 index 0000000..549f4f1 --- /dev/null +++ b/api-ref/source/before_you_start/index.rst @@ -0,0 +1,11 @@ +================ +Before You Start +================ + +.. toctree:: + :maxdepth: 1 + + overview + api_calling + endpoints + basic_concepts diff --git a/api-ref/source/before_you_start/overview.rst b/api-ref/source/before_you_start/overview.rst new file mode 100644 index 0000000..5e3eba2 --- /dev/null +++ b/api-ref/source/before_you_start/overview.rst @@ -0,0 +1,6 @@ +Overview +======== + +ModelArts is a one-stop AI development platform geared toward developers and data scientists of all skill levels. It enables you to rapidly build, train, and deploy models anywhere (from the cloud to the edge), and manage full-lifecycle AI workflows. ModelArts accelerates AI development and fosters AI innovation with key capabilities, including data preprocessing and auto labeling, distributed training, automated model building, and one-click workflow execution. You can use ModelArts through open APIs. For details about all ModelArts APIs, see `API Overview <../api_overview.html>`__. + + diff --git a/api-ref/source/calling_apis/authentication.rst b/api-ref/source/calling_apis/authentication.rst new file mode 100644 index 0000000..857ca0e --- /dev/null +++ b/api-ref/source/calling_apis/authentication.rst @@ -0,0 +1,189 @@ +Authentication +============== + +Requests for calling an API can be authenticated using either of the following methods: AK/SK-based authentication: Requests are authenticated by encrypting the request body using an AK/SK pair. + +- Token-based authentication: Requests are authenticated using a token. +- AK/SK authentication: Requests are encrypted using the access key ID (AK) and secret access key (SK). + +Token-based Authentication +-------------------------- + +.. note:: + + The validity period of a token is 24 hours. When using a token for authentication, cache it to prevent frequently calling the IAM API used to obtain a user token. + +A token specifies temporary permissions in a computer system. During API authentication using a token, the token is added to requests to get permissions for calling the API. + +In `Making an API Request <../calling_apis/making_an_api_request.html#modelarts030005>`__, the process of calling the API used to obtain a user token is described. + +.. code-block:: + + { + "auth": { + "identity": { + "methods": [ + "password" + ], + "password": { + "user": { + "name": "user_name", + "password": "user_password", + "domain": { + "name": "domain_name" + } + } + } + }, + "scope": { + "project": { + "name": "project_name" + } + } + } + } + +After a token is obtained, the **X-Auth-Token** header field must be added to requests to specify the token when calling other APIs. For example, if the token is **ABCDEFJ....**, **X-Auth-Token: ABCDEFJ....** can be added to a request as follows: + +.. code-block:: + + POST https://{endpoint}/v1/{project_id}/services + Content-Type: application/json + X-Auth-Token: ABCDEFJ.... + +AK/SK-based Authentication +-------------------------- + +An AK/SK is used to verify the identity of a request sender. In AK/SK-based authentication, a signature needs to be obtained and then added to requests. + +.. note:: + + AK: access key ID, which is a unique identifier used in conjunction with a secret access key to sign requests cryptographically. + + SK: secret access key used in conjunction with an AK to sign requests cryptographically. It identifies a request sender and prevents the request from being modified. + +The following uses a demo project to show how to sign a request and use an HTTP client to send an HTTPS request. + +Download the demo project at https://github.com/api-gate-way/SdkDemo. + +If you do not need the demo project, visit the following URL to download the API Gateway signing SDK: + +Obtain the API Gateway signing SDK from the enterprise administrator. + +Decompress the downloaded package and reference the obtained JAR files as dependencies, as highlighted in the following figure. + +|image1| + +#. Generate an AK/SK. (If an AK/SK file has already been obtained, skip this step and locate the downloaded AK/SK file. Generally, the file name will be **credentials.csv**.) + + a. Log in to ManageOne Operation Portal. + b. In the upper right corner of the page, click your account avatar and choose **My Settings** from the drop-down list. + c. On the **My Settings** page, the **Project List** tab page is displayed by default. Click the **Manage Access Key** tab page. + d. Click **Add Access Key** to create an AK/SK pair. + e. Click **OK**. The certificate is automatically downloaded. + f. After the certificate is downloaded, obtain the AK and SK information from the **credentials** file. + + .. important:: + + - Only two access keys can be added for each user. + - To ensure access key security, access keys are automatically downloaded only when they are generated for the first time and cannot be obtained from the management console later. Keep them properly. + +#. Download and decompress the demo project. + +#. Import the demo project to Eclipse. + + .. figure:: /_static/images/en-us_image_0150917346.gif + :alt: **Figure 1** Selecting Existing Projects into Workspace + + + **Figure 1** Selecting Existing Projects into Workspace + + .. figure:: /_static/images/en-us_image_0150917350.gif + :alt: **Figure 2** Selecting the demo project + + + **Figure 2** Selecting the demo project + + .. figure:: /_static/images/en-us_image_0150917353.gif + :alt: **Figure 3** Structure of the demo project + + + **Figure 3** Structure of the demo project + +#. Sign the request. + + The request signing method is integrated in the JAR files imported in `3 <#modelarts030004enustopic0129435566li94791126103617>`__. The request needs to be signed before it is sent. The signature will then be added as part of the HTTP header to the request. + + The demo code is classified into the following classes to demonstrate signing and sending the HTTP request: + + - **AccessService**: abstract class that merges the GET, POST, PUT, and DELETE methods into the **access** method + - **Demo**: execution entry used to simulate the sending of GET, POST, PUT, and DELETE requests + - **AccessServiceImpl**: implementation of the **access** method, which contains the code required for communication with API Gateway + + The following describes how to call a POST method to sign the request. + + a. (Optional) Add request header fields. + + Uncomment the following code snippet in the **AccessServiceImpl.java** file, and specify the project ID and account ID. + + .. code-block:: + + //TODO: Add special headers. + //request.addHeader("X-Project-Id", "xxxxx"); + //request.addHeader("X-Domain-Id", "xxxxx"); + + b. Edit the **main()** method in the Demo.java file, and replace the bold text with actual values. + + As shown in the following code, if you use other methods such as POST, PUT, and DELETE, see the corresponding comment. Replace the values of **region**, **serviceName**, **ak**, **sk**, and **url**. The URL for obtaining the VPC is used in the sample project. Replace it with the actual URL. Contact the administrator to obtain the endpoint. + + .. code-block:: + + //TODO: Replace the value of region with the actual region where the service to be accessed is located. + private static final String region = ""; + + //TODO: Replace vpc with the name of the service you want to access. For example, ecs, vpc, iam, and elb. + private static final String serviceName = ""; + + public static void main(String[] args) throws UnsupportedEncodingException + { + //TODO: Replace the values of ak and sk with the AK/SK obtained on the My Credentials page. + String ak = "ZIRRKMTWP******1WKNKB"; + String sk = "Us0mdMNHk******YrRCnW0ecfzl"; + + //TODO: To specify a project ID (multi-project scenarios), add the X-Project-Id header. + //TODO: To access a global service, such as IAM, DNS, CDN, and TMS, add the X-Domain-Id header to specify an account ID. + //TODO: To add a header, find "Add special headers" in the AccessServiceImple.java file. + + //TODO: Test the API. + String url = "https://{Endpoint}/v1/{project_id}/vpcs"; + get(ak, sk, url); + + //TODO: When creating a VPC, replace {project_id} in postUrl with the actual value. + //String postUrl = "https://serviceEndpoint/v1/{project_id}/cloudservers"; + //String postbody ="{\"vpc\": {\"name\": \"vpc\",\"cidr\": \"192.168.0.0/16\"}}"; + //post(ak, sk, postUrl, postbody); + + //TODO: When querying a VPC, replace {project_id} in url with the actual value. + //String url = "https://serviceEndpoint/v1/{project_id}/vpcs/{vpc_id}"; + //get(ak, sk, url); + + //TODO: When updating a VPC, replace {project_id} and {vpc_id} in putUrl with the actual values. + //String putUrl = "https://serviceEndpoint/v1/{project_id}/vpcs/{vpc_id}"; + //String putbody ="{\"vpc\":{\"name\": \"vpc1\",\"cidr\": \"192.168.0.0/16\"}}"; + //put(ak, sk, putUrl, putbody); + + //TODO: When deleting a VPC, replace {project_id} and {vpc_id} in deleteUrl with the actual values. + //String deleteUrl = "https://serviceEndpoint/v1/{project_id}/vpcs/{vpc_id}"; + //delete(ak, sk, deleteUrl); + } + + c. Compile the code and call the API. + + In the **Package Explorer** area on the left, right-click **Demo.java** and choose **Run AS** > **Java Application** from the shortcut menu to run the demo code. + + You can view the API call logs on the console. + + + +.. |image1| image:: /_static/images/en-us_image_0150916848.gif + diff --git a/api-ref/source/calling_apis/index.rst b/api-ref/source/calling_apis/index.rst new file mode 100644 index 0000000..e8be2f1 --- /dev/null +++ b/api-ref/source/calling_apis/index.rst @@ -0,0 +1,10 @@ +============ +Calling APIs +============ + +.. toctree:: + :maxdepth: 1 + + making_an_api_request + authentication + response diff --git a/api-ref/source/calling_apis/making_an_api_request.rst b/api-ref/source/calling_apis/making_an_api_request.rst new file mode 100644 index 0000000..12764de --- /dev/null +++ b/api-ref/source/calling_apis/making_an_api_request.rst @@ -0,0 +1,171 @@ +Making an API Request +===================== + +This section describes the structure of a REST API request, and uses the IAM API for obtaining a user token as an example to demonstrate how to call an API. The obtained token can then be used to authenticate the calling of other APIs. + +Request URI +----------- + +The format of a request URI is as follows: + +**{URI-scheme} :// {Endpoint} / {resource-path} ? {query-string}** + + + +.. _modelarts030005enustopic0129435569enustopic0170917207enustopic0168405763table442645372610: + +.. table:: **Table 1** Request URI + + +---------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Description | + +===============+=====================================================================================================================================================================================================================================================================+ + | URI-scheme | Protocol used to transmit requests. All APIs use HTTPS. | + +---------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Endpoint | Domain name or IP address of the server for the REST service endpoint. The endpoint varies depending on services in different regions. It can be obtained in `Endpoints <../before_you_start/endpoints.html>`__. | + +---------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource-path | Access path of an API for performing a specified operation. Obtain the path from the URI of an API. For example, the **resource-path** of the API used to obtain a user token is **/v3/auth/tokens**. | + +---------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | query-string | Query parameter, which is optional. Ensure that a question mark (?) is included before each query parameter that is in the format of "*Parameter name=Parameter value*". For example, **? limit=10** indicates that a maximum of 10 data records will be displayed. | + +---------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +For example, to obtain an IAM token in a region, obtain the endpoint of IAM for this region and the **resource-path** (**/v3/auth/tokens**) in the URI of the API used to obtain a user token. Then, construct the URI as follows: + +.. code-block:: + + https://{iam-endpoint}/v3/auth/tokens + +.. note:: + + To simplify the URI display in this document, each API is provided only with a **resource-path** and a request method. The **URI-scheme** of all APIs is **HTTPS**, and the endpoints of all APIs in the same region are identical. + +Request Methods +--------------- + +The HTTP protocol defines the following request methods that can be used to send a request to the server: + + + +.. _modelarts030005enustopic0129435569enustopic0113746487table1961229113819: + +.. table:: **Table 2** HTTP methods + + +-----------------------------------+----------------------------------------------------------------------------+ + | **Method** | **Description** | + +===================================+============================================================================+ + | GET | Requests the server to return specified resources. | + +-----------------------------------+----------------------------------------------------------------------------+ + | PUT | Requests the server to update specified resources. | + +-----------------------------------+----------------------------------------------------------------------------+ + | POST | Requests the server to add resources or perform special operations. | + +-----------------------------------+----------------------------------------------------------------------------+ + | DELETE | Requests the server to delete specified resources, for example, an object. | + +-----------------------------------+----------------------------------------------------------------------------+ + | HEAD | Same as GET except that the server must return only the response header. | + +-----------------------------------+----------------------------------------------------------------------------+ + | PATCH | Requests the server to update partial content of a specified resource. | + | | | + | | If the resource does not exist, a new resource will be created. | + +-----------------------------------+----------------------------------------------------------------------------+ + +For example, in the case of the API used to obtain a user token, the request method is POST. The request is as follows: + +.. code-block:: + + POST https://{iam-endpoint}/v3/auth/tokens + +Request Header +-------------- + +You can also add additional header fields to a request, such as the fields required by a specified URI or HTTP method. For example, to request for the authentication information, add **Content-Type**, which specifies the request body type. + +`Table 3 <#modelarts030005enustopic0129435569table139019272562>`__ describes the common request header fields to be added to the request. + + + +.. _modelarts030005enustopic0129435569table139019272562: + +.. table:: **Table 3** Common request header fields + + +-----------------+-------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Header | Description | Mandatory | Example | + +=================+=====================================================================================================================================+=======================================================================================+===================================================================================================================================================================================================+ + | Content-type | Request body type or format. The default value is **application/json**. | Yes | application/json | + +-----------------+-------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Content-Length | Length of the request body. The unit is byte. | Mandatory for POST and PUT requests but must be left blank for GET requests | 3495 | + +-----------------+-------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | X-Project-Id | Project ID. This parameter is used to obtain the token for each project. | No | e9993fc787d94b6c886cbaa340f9c0f4 | + +-----------------+-------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | X-Auth-Token | User token. It is a response to the API used to obtain a user token. This API is the only one that does not require authentication. | Mandatory for token-based authentication | None | + +-----------------+-------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | X-Sdk-Date | Time when the request is sent. The time is in *YYYYMMDD*\ **'T'**\ *HHMMSS*\ **'Z'** format. | Mandatory for AK/SK-based authentication, optional for PKI token-based authentication | 20190307T101459Z | + | | | | | + | | The value is the current Greenwich Mean Time (GMT) time of the system. | | | + +-----------------+-------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Authorization | Authentication information. | Mandatory for AK/SK-based authentication | SDK-HMAC-SHA256 Credential=ZIRRKMTWPTQFQI1WKNKB/20150907//ec2/sdk_request, SignedHeaders=content-type;host;x-sdk-date, Signature=55741b610f3c9fa3ae40b5a8021ebf7ebc2a28a603fc62d25cb3bfe6608e1994 | + | | | | | + | | The value is obtained from the request signature result and is required when the AK/SK are used to encrypt the signature. | | | + | | | | | + | | Type: string | | | + | | | | | + | | Default value: none | | | + +-----------------+-------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Host | Information about the requested server. The value can be obtained from the URL of the service API. | Mandatory for AK/SK-based authentication | code.test.com | + | | | | | + | | This value is *host name*\ [:*port number*]. | | or | + | | | | | + | | If the port number is not specified, the default port is used. The default port number for **https** is **443**. | | code.test.com:443 | + +-----------------+-------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. note:: + + In addition to supporting authentication using tokens, APIs support authentication using AK/SK, which uses SDK to sign a request. During the signature, the **Authorization** (signature authentication) and **X-Sdk-Date** (time when a request is sent) headers are automatically added to the request. + +The API for obtaining a user token does not require authentication. Therefore, this API only requires adding the **Content-Type** field. The request with the added **Content-Type** header is as follows: + +.. code-block:: + + POST https://{iam-endpoint}/v3/auth/tokens + Content-Type: application/json + +Request Body +------------ + +The body of a request is often sent in a structured format as specified in the Content-Type header field. The request body transfers content except the request header. If the request body contains Chinese characters, these characters must be encoded in UTF-8. + +The request body varies between APIs. Some APIs do not require the request body, such as the APIs requested using the GET and DELETE methods. + +If an API is used to obtain a user token, the request parameters and parameter description can be obtained from the API request. The following provides an example request with a body included. Replace *user_name*, *domain_name*, and *user_password* with the actual username, account name, and login password, respectively. **project_name** is the project name. For details, see `Obtaining a Username <../common_parameters/obtaining_a_username_and_id.html#modelarts030006>`__, `Obtaining an Account Name and ID <../common_parameters/obtaining_an_account_name_and_id.html#modelarts030148>`__, and `Obtaining a Project Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. + +.. note:: + + The **scope** parameter specifies where a token takes effect. In the example, the token takes effect only for the resources in a specified project. ModelArts uses a region-specific endpoint to call this API. Set **scope** to **project**. You can set **scope** to an account or a project under an account. In the following example, the token takes effect only for the resources in a specified project. For more information about this API, see "Obtaining a User Token". + +.. code-block:: + + POST https://{iam-endpoint}/v3/auth/tokens + Content-Type:application/json + { + "auth": { + "identity": { + "methods": ["password"], + "password": { + "user": { + "name": "Username", + "password": "User password", + "domain": { + "name": "Domain name" + } + } + } + }, + "scope": { + "project": { + "name": "Project name" + } + } + } + } + +If all data required for the API request is available, you can send the request to call the API through `curl `__, `Postman `__, or coding. In the response to the API used to obtain a user token, **x-subject-token** is the desired user token. This token can then be used to authenticate the calling of other APIs. + + diff --git a/api-ref/source/calling_apis/response.rst b/api-ref/source/calling_apis/response.rst new file mode 100644 index 0000000..e750003 --- /dev/null +++ b/api-ref/source/calling_apis/response.rst @@ -0,0 +1,101 @@ +Response +======== + +After sending a request, you will receive a response, including the status code, response header, and response body. + +Status Code +----------- + +A status code is a group of digits, ranging from 1\ *xx* to 5\ *xx*. It indicates the status of a request. For more information, see `Status Code <../common_parameters/status_code.html#modelarts030094>`__. + +For example, if status code **201** is returned for calling the API used to obtain a user token, the request is successful. + +Response Header +--------------- + +Similar to a request, a response also has a header, for example, **Content-type**. + + + +.. _modelarts030003enustopic0171310283table14216843: + +.. table:: **Table 1** Common response header fields + + +-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+ + | Header | Description | Mandatory | + +=======================+================================================================================================================================================================================================================================+=======================+ + | Content-Type | Media type of the message body sent to a receiver | Yes | + | | | | + | | Type: string | | + | | | | + | | Default value: **application/json; charset=UTF-8** | | + +-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+ + | X-request-id | This field carries the request ID for task tracing. | No | + | | | | + | | Type: string **request_id-timestamp-hostname** (**request_id** is the UUID generated on the server, **timestamp** indicates the current timestamp, and **hostname** is the name of the server that processes the current API.) | | + | | | | + | | Default value: none | | + +-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+ + | X-ratelimit | This field carries the total number of flow control requests. | No | + | | | | + | | Type: integer | | + | | | | + | | Default value: none | | + +-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+ + | X-ratelimit-used | This field carries the number of remaining requests. | No | + | | | | + | | Type: integer | | + | | | | + | | Default value: none | | + +-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+ + | X-ratelimit-window | This field carries the flow control unit. | No | + | | | | + | | Type: string The unit is minute, hour, or day. | | + | | | | + | | Default value: hour | | + +-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+ + +`Figure 1 <#modelarts030003enustopic0171310283enustopic0170917209enustopic0168405765fig4865141011511>`__ shows the response header fields for the API used to obtain a user token. + +**x-subject-token** is the desired user token. This token can then be used to authenticate the calling of other APIs. + +.. figure:: /_static/images/en-us_image_0171113090.png + :alt: **Figure 1** Header fields of the response to the request for obtaining a user token + + + **Figure 1** Header fields of the response to the request for obtaining a user token + +Response Body +------------- + +The body of a response is often returned in structured format as specified in the **Content-Type** header field. The response body transfers content except the response header. + +The following is part of the response body for the API used to obtain a user token. + +.. code-block:: + + { + "token": { + "expires_at": "2019-02-13T06:52:13.855000Z", + "methods": [ + "password" + ], + "catalog": [ + { + "endpoints": [ + { + "region_id": "aaa", + ...... + +If an error occurs during API calling, an error code and a message will be displayed. The following shows an error response body. + +.. code-block:: + + { + "error_message": "The format of message is error", + "error_code": "AS.0001" + } + +In the error response body, **error_code** is an error code, and **error_message** provides information about the error. For more details, see `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/change_history.rst b/api-ref/source/change_history.rst new file mode 100644 index 0000000..b4208e8 --- /dev/null +++ b/api-ref/source/change_history.rst @@ -0,0 +1,12 @@ +Change History +============== + + + +.. _modelarts030097enustopic0135263212table1819116292310: + +=========== =================================== +Released On Description +=========== =================================== +2021-04-30 This is the first official release. +=========== =================================== diff --git a/api-ref/source/common_parameters/error_codes.rst b/api-ref/source/common_parameters/error_codes.rst new file mode 100644 index 0000000..2988547 --- /dev/null +++ b/api-ref/source/common_parameters/error_codes.rst @@ -0,0 +1,1136 @@ +Error Codes +=========== + ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Status Code | Error Codes | Error Message | Description | Solution | ++=============+================+===========================================================================================================================================================+===============================================================================================================================================================+======================================================================================================================================================================================================================+ +| 400 | ModelArts.0104 | Parameter error. | Parameter error. | Check the parameter settings. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.0113 | Create Notebook failed. Quota: {} is exhausted. | Failed to create the notebook instance due to the exhausted quota. | Contact the administrator for a higher quota. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6301 | The instance already exists. | The instance already exists. | Enter another instance name. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6302 | The instance count already reaches the maximum value. | The maximum number of instances has been reached. | Delete unnecessary instances. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6303 | The field does not support sorting. | This field does not support sorting. | Delete the field from the sorting parameters. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6304 | Please stop the instance before deleting. | Failed to delete the instance in the running state. | Refresh the page. Stop the instance and then delete it. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6305 | The instance is already running. | The instance is in the running state. | Do not start it again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6306 | The instance is starting. | Other operations cannot be performed because the instance is being started. | Perform other operations later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6307 | The instance has already been stopped. | The instance has been stopped. | Refresh the page and view the instance state. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6308 | The instance is stopping. | The instance is being stopped. | Refresh the page and view the instance state. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6309 | The instance does not exist. | The instance does not exist. | Ensure that the instance has been deleted. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6316 | The param 'storage' is needed for creating notebook instance. | Incorrect parameters during instance creation. | Add the storage parameter. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6317 | The 'path' parameter is required when the storage type is OBS. | Incorrect parameters during instance creation. | Add the path parameter. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6318 | The param 'path' needs to end with /. | Incorrect parameters during instance creation. | Ensure that the value of the path parameter ends with a slash (/). | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6319 | There is no ak/sk in the global settings. Please add it by access ModelArts console. | The AK/SK have not been configured in the global settings of ModelArts. | Configure the AK/SK in the global settings of ModelArts. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6320 | Access obs error. Reason is {}. | OBS access error. | Ensure that the OBS path is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6323 | The flavor is not supported, please check it. | The flavor is not supported. | Ensure that the flavor is correctly configured. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6324 | This location type is not supported. Please check it. | The storage type is not supported. | Ensure that the storage type is correctly configured. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6326 | The instance is frozen. Check whether your account is in arrears in Billing Center. | The instance has been frozen. | Check the account balance and top up the account. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6327 | The instance is not in running. Please refresh the page and start it. | The instance is not in the running state. | Refresh the page and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6328 | Sorry, you currently do not have permission for this flavor. Please apply it firstly. | You do not have permission to use the flavor. | Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6329 | Sorry, this flavor specification is sold out. Please try others. | The flavor is sold out. | Use another flavor or try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6330 | The flavor type of profile does not match the type of flavor. Please check it. | The types are not matched. | Ensure that the flavor type matches the profile type. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6331 | The evs volume size ranges from {} GB to {} GB. | The EVS disk size exceeds the upper limit. | Check the EVS disk size. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6332 | Incorrect parameter type. The '{}' parameter must be of the '{}' type. | Parameter type error. | Ensure that the parameter type meets the requirements. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6333 | The notebook is being restored. Refresh the page and wait for several minutes. The fault may be caused by instance overload. | Notebook instance fault. | The instance is recovering. Try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6334 | Invalid value for name or description. The character \`{}\` is not allowed. | The description parameter is incorrect. | Enter a valid description value. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6335 | '{}' is a required property. | Parameter missing. | Ensure that the corresponding parameter is available. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6336 | '{}' property value is incorrect. | Incorrect parameter value. | Ensure that the corresponding parameter is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6341 | The repository does not exist or has been deleted. | The Git repository does not exist or has been deleted. | Check the corresponding parameter. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6343 | The repository name already exists. | The Git repository already exists. | Check the corresponding parameter. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6344 | Delete failed. Please delete the associated development environment instance first. | Failed to delete the repository. | Delete the corresponding notebook instance first. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6345 | Currently the OBS type instance does not support git capability. | The Git repository cannot be used for OBS instances. | Use notebook instances of the EVS type. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6346 | The timestamp of auto stop must be later than the current timestamp. | This parameter cannot be modified. | Check the corresponding parameter and ensure that the automatic end time is later than the current time. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6347 | When the instance is in the '{}' status, the '{}' parameter cannot be modified. | Failed to modify the parameter. | Check the corresponding parameter. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6348 | The 'duration' parameter is mandatory for enabling auto stop. | The description parameter is missing. | Configure the duration parameter. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6349 | The 'duration' parameter is incorrect. The value ranges from {} to {}. | The value of duration parameter exceeds the threshold. | Configure the duration parameter. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6350 | Failed to access OBS because of incorrect AK/SK or insufficient permissions. | Access to OBS is rejected. | Ensure that the AK/SK is correct and you have the permission to access OBS. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6353 | Failed to verify the AK/SK. Please check and try again. | Incorrect AK/SK. | Ensure that the AK/SK in the global settings of ModelArts is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6354 | The AK/SK do not belong to the user. Please check and enter the correct ones. | Incorrect AK/SK. | Ensure that the AK/SK in the global settings of ModelArts is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6355 | The resource is initializing. Please wait one minute and try again. | Resources in the dedicated resource pool are being initialized. | Try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6357 | The operation is not allowed because another operation is being performed on the instance or the instance is in the target state. | The operation is not allowed. | Try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6358 | The path parameter is incorrect. It cannot be the root directory of an OBS bucket, but must be a specific directory in the OBS bucket. | The OBS path parameter is incorrect. | Ensure that the path parameter is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6361 | ModelArts internal service or configuration error. Submit a service ticket to get professional technical support. | Internal error. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6371 | Currently, notebooks support only OBS buckets whose Storage Class is Standard. Change the OBS bucket and try again. | Notebook instances support only standard OBS buckets. | Use standard OBS buckets. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6374 | The credential can be added only when type is set to AK/SK or agency. | The authentication type can only be AK/SK or agency. | Ensure that the authentication type is AK/SK or agency. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6376 | Please make sure agency exists. | The IAM agency does not exist. | Ensure that the agency exists on IAM. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6377 | The user id cannot be left blank. | The user ID cannot be left blank. | Ensure that the user ID parameter is available. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6378 | The agency name cannot be left blank. | The agency name cannot be left blank. | Ensure that the agency name parameter is available. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6379 | No IAM agency created in Settings. Create an IAM agency on the ModelArts management console. | No agency is created in the global settings. | Create an agency in the global settings. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6528 | No EVS available. Please try again later. | The EVS disk has been sold out. | Try again later or contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 401 | ModelArts.6201 | The user's account has been suspended. | The user account is frozen. | Check the account balance and top up the account. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 401 | ModelArts.6203 | The user's account has been restricted. | The user account is restricted. | Check the account balance and top up the account. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.0112 | Policy doesn't allow {} {} to be performed. | The permission on the workspace is restricted. | Ensure that you have the permission on the workspace. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 408 | ModelArts.6100 | The request timed out. Please try again. | Timeout. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 429 | ModelArts.6101 | The system is busy now. Please try again later. | The system is busy. | The system is busy. Please try again. If the retry still fails, contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.6102 | The server has encountered an error and fails to process the request. Please try again later or submit a service ticket. | Internal error. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.6200 | No resources available. Please try again later or submit a service ticket. | Internal error. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6600 | Check whether the parameter is valid. | Failed to verify the parameters. | Ensure that the parameter is valid. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6651 | Unsupport entity. | Unsupported project objects. | Ensure that the project object is supported. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6652 | Please delete resources from the project first. | Failed to delete the project resources. | Delete the datasets and notebook instances under the project and ensure that all training jobs have been completed. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.6690 | The image size cannot exceed 8 MB. | The image size exceeds 8 MB. | Ensure that the image size does not exceed 8 MB. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 401 | ModelArts.6608 | Please refresh user info. | Failed to obtain the user information. | Refresh the user information. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 401 | ModelArts.6620 | Please refresh the user token. | Invalid user token. | Refresh the user token. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.6653 | Contact the project owner. | You are not authorized to operate the project. | Contact the project owner to obtain the authorization. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.6623 | Ensure that the dataset already exists. | Failed to find the corresponding dataset. | Ensure that the dataset already exists. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.6624 | Ensure that the storage path already exists. | Failed to find the corresponding storage path. | Ensure that the storage path already exists. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.6650 | Ensure that the project already exists. | Failed to find the corresponding project. | Ensure that the project already exists. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.6655 | Can't find ai project template. | Failed to find the corresponding project template. | Ensure that the corresponding project template already exists. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 417 | ModelArts.6654 | Project with the same name already exists. | A project with the same name already exists. | Use another project name. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.6691 | System error. Check the service status. | The algorithm service is abnormal. | System error. Check the service state. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.6692 | System error. Check the service status. | The dataset service is abnormal. | System error. Check the service state. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.6699 | Internal error. | Network error. | Check network connectivity. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4205 | A subdirectory must be specified as the dataset input or output path. | A subdirectory must be specified as the dataset input or output path. | A subdirectory must be specified as the dataset input or output path. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4311 | OBS bucket does not exist | The OBS bucket does not exist. | Ensure that the bucket name is correct and that the bucket name exists in OBS. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4312 | OBS path does not exist | Incorrect or invalid bucket name. | Ensure that the bucket name is correct and that the bucket name exists in OBS. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4313 | OBS path is invalid | Invalid characters in the OBS path. | Ensure that the OBS path consists of valid characters, including digits, letters, hyphens (-), underscores (_), slashes (/), and Chinese characters. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4314 | Obs error | OBS access error. | Ensure that you have the permission to access OBS and that the OBS path is valid. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4338 | The resource not exists | The dataset ID or labeling task ID does not exist. | Ensure that the input dataset ID or labeling task ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4340 | Import path does not contain valid file | No valid file exists in the import path. | Ensure that the file in the OBS path is valid. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4342 | Dataset publish with splitting annotated samples error | Incorrect splitting for labeled samples. | Ensure that the labeled samples and labels meet splitting criteria. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4343 | Dataset is publishing, the operation is forbidden | Do not switch, import, synchronize, or publish a dataset version because there is an ongoing publish task. | Perform the operations after the ongoing publish task is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4344 | Dataset is being deleted, annotation is forbidden | No labeling task is allowed because the dataset is being deleted. | Ensure that the dataset ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4345 | File not found | The HDFS file does not exist. | Ensure that the OBS path is correct and that the file is available in the OBS path. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4347 | List files failed | Failed to obtain HDFS files. | Ensure that the OBS path is correct and that the files are available in the OBS path. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4349 | Dataset is switching version, the operation is forbidden | Do not switch, import, synchronize, or publish a dataset version because there is an ongoing version switching task. | Perform the operations after the ongoing version switching task is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4350 | The work_path is too long, please select shorter folder | The value of work_path exceeded the limit. | Change the value of work_path to a valid one. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4351 | Dataset already exists | A dataset whose name is the value of dataset_name already exists. | Change the value of dataset_name. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4352 | Dataset does not exist | The dataset ID does not exist. | Ensure that the imported dataset ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4353 | Dataset version does not exist | The dataset version ID does not exist. | Check dataset version parameters. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4355 | Sync data source task exist | A data synchronization task is being executed for the dataset. | Perform the operations after the ongoing data synchronization task is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4356 | Dataset already has running import task | A data import task is being executed for the dataset. | Perform the operations after the ongoing data import task is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4357 | Parse AI annotation result file name error | Failed to parse the labeling file name. | Ensure that the file name in the OBS auto labeling result path is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4358 | Invalid export path | Invalid OBS export path. | Ensure that the export path is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4359 | Export task does not exist | The export task ID does not exist. | Ensure that the export task ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4361 | Import AI annotation error | Failed to synchronize the auto labeling task result. | Ensure that the auto labeling task result is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4362 | Import data error | Failed to import data. | Ensure that the authentication information and the request parameters for creating an import task are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4364 | Dataset workPath subdir already exists | The work_path subdirectory already exists in the dataset directory. | Ensure that the subdirectory in the dataset directory is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4365 | Dataset labels not set | The label set of the dataset is empty. | Create labels for the dataset. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4368 | Parse pc bin file error | Failed to parse the point cloud binary file. | Ensure that the point cloud binary file is not damaged. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4369 | Parse pc prelabel json file error | Failed to parse the point cloud pre-labeling file. | Ensure that the point cloud pre-labeling file is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4370 | One dataset version can be released in a minute, please try again later | Frequent dataset version creation. | Do not frequently create dataset versions. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4371 | Dataset version already exists | The value of version_name is the same as an existing version. | Change the value of version_name. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4372 | Valid image not found | No point cloud data image found. | Ensure that the point cloud data image is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4374 | Invalid path | Invalid OBS path. | Ensure that the OBS path is correct and that the file is available in the OBS path. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4375 | Parse pc obs image error | Failed to parse the point cloud data image in OBS. | Ensure that the point cloud data image is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4376 | Unsupported pc pcd format error | The PCD attribute is not supported. | Check the point cloud data in PCD format. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4377 | Pc pcd format error | Failed to parse the point cloud data in PCD format. | Ensure that the PCD file is valid. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4378 | Parse pc pcd file error | Failed to parse the point cloud data in PCD format. | Ensure that the PCD file is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4379 | Unsupported pc file format error | The point cloud data format is not supported. | Ensure that the imported point cloud data is in BIN or PCD format. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4380 | Parse kitti calibration file error | Failed to parse the Kitti data. | Ensure that the data is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4381 | Dataset is publishing, annotation is forbidden | Sample labeling is not allowed because a publish task is being executed in the dataset. | Wait until the publish task is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4382 | Generate 2d image error | Failed to generate a 2D image. | Ensure that the point cloud data is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4384 | Invalid export parameter | Invalid parameter. | Ensure that all mandatory parameters are included and valid. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4391 | Task name is invalid | An auto deploy task whose name is the task_name value already exists in the dataset. | Ensure that the task name is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4392 | Task failed | Failed to create or run the dataset. | Ensure that the parameters and task resources are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4393 | Task stopped | The dataset task has been stopped. | Check the status of the dataset task with the specified ID. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4396 | Parameter is invalid | Invalid parameter. | Ensure that the import task parameters are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4399 | Type match error | The dataset type does not match the algorithm model. | Ensure that the algorithm model is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4400 | Can not get table schema | Failed to obtain the schema information from the OBS directory. | Ensure that the CSV file in the OBS directory is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4404 | Can not get table schema from DLI | Failed to obtain the schema information from DLI. | Ensure that the request parameters are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4405 | Dataset must contains labels to start automation labeling | Labeled samples must be available for enabling auto labeling. | Add new labeled samples to the dataset. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4406 | Dataset must contains labels with at least five images to start automation labeling | The number of samples to be labeled for each label cannot be less than 5. | Ensure that each label has at least five samples. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4407 | Dataset must contains unlabeled files | The dataset must contain samples that have not been labeled. | Ensure that there are unlabeled samples in the dataset. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4408 | Dataset contains labels shape not bndbox | The label shape cannot be bounding box. | Ensure that the shape attribute is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4409 | Running tasks has exceed the max threshold | The number of tasks that are being executed in the dataset has reached the maximum allowed limit. | Try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4410 | Label not found | The label does not exist. | Ensure that the label name is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4411 | Label already exists | The new label list contains existing label names. | Ensure that the label names are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4412 | Label shortcut already exists | The label shortcut already exists. | Change the label shortcut. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4413 | Label is incompatible with annotation rules | The label attribute does not comply with specifications. | Ensure that the label attribute complies with specifications. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4414 | Triplet label's from_entity or to_entity does not exist | The entity label does not exist in the triplet label. | Ensure that the entity label in the triplet label is available. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4415 | Entity label can not be deleted because it is used by triplet label | Failed to delete the entity label because it is being used in the triplet label. | Wait until the label is not used in the triplet label and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4416 | Sync tags error | Failed to synchronize labels in the team labeling task. | Ensure that the synchronization task parameters are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4417 | Update sample labels failed when upload sample and labels | Failed to update the sample labels. | Ensure that the labels are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4418 | Label property mask_gray_value already exists | Duplicate tag mask_gray_value. | Ensure that the tag mask_gray_value is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4420 | Sample not found | The sample with the specified ID does not exist. | Ensure that the sample ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4421 | Upload sample failed | Failed to upload the sample to the dataset. | Ensure that the uploaded sample type and data are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4422 | Sample already exists | The sample that is being imported already exists. | Enter that the imported sample is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4423 | Get sample size failed, please input size manually | Incorrect size of the image obtained from the object detection dataset. | Manually set the image size. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4425 | Label property mask_gray_value is incompatible with defined value | The mask_gray_value value cannot be changed. | Ensure that the mask_gray_value value is not changed. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4426 | Dataset must contains tags to start auto deploy | The label set of the dataset cannot be empty. | Create labels for the dataset. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4427 | Dataset must contains tags with at least five images to start auto deploy | The number of samples to be labeled for each label cannot be less than 5. | Ensure that each label has at least five samples. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4502 | The IAM agency name already exists, please delete the agency in IAM first and retry | The default IAM agency already exists. | Delete the IAM agency and create a new one. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4601 | The workforce does not exist | The team ID does not exist. | Ensure that the team ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4602 | The workforce already exists | A team whose name is the workforce_name value already exists. | Ensure that the workforce_name value is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4603 | Update workforce state failed | Failed to delete the team. | Check whether the team has been deleted. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4604 | The worker does not exist | The team member specified by work_id does not exist. | Ensure that the workforce_id and work_id values are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4605 | The worker already exists | The team member whose value is the email value already exists. | Ensure that the email value is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4609 | Change password failed | Failed to change the account password. | Ensure that the new password complies with specifications. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4612 | Task not found | The task ID does not exist. | Ensure that the task ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4615 | Workforce task is unfinished | The version cannot be switched because the team labeling task has not been completed. | Wait until the team labeling task is complete and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4617 | The number of manager should be one | The team manager already exists. | Ensure that the roles of the team members are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4618 | Can not delete yourself | You cannot delete yourself from the team. | Ensure that the request parameters are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4619 | Workforce task does not exist | No team labeling task whose ID is the workforce_task_id value is allowed. | Ensure that the workforce_task_id value is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4620 | The workforce task already exists | A team labeling task whose name is the task_name value already exists. | Ensure that the task_name value is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4622 | Invalid n_clusters, should less than the total number of samples | The number of groups has reached the maximum allowed limit. | Check whether the number of groups is less than the total number of samples. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4623 | Workforce task is checking | Only one review task is allowed at a time. | Wait until all existing review tasks are complete and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4627 | Request notify too frequently | Frequent notification request submission. | Try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4628 | Can not delete worker who has task | The team member cannot be deleted because the labeling task has not been completed. | Notify the member to complete the task. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4650 | Interactive operations not found | Incorrect interactive_operations value. | Ensure that the interactive_operations value is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4651 | Get obs sample error | Failed to read the sample from OBS. | Ensure that the sample in OBS is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4700 | Task does not exist | The task ID does not exist. | Ensure that the task ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4701 | Can not start data analysis task, dataset version annotation type must be 'Image Classification' or 'Object Detection' | The dataset type does not support feature analysis. | Ensure that the dataset type is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4702 | Can not start data analysis task, dataset version must be 'Default' format | The dataset format does not support feature analysis. | Use the default dataset format. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4703 | Can not start data analysis task, dataset version must contains annotated samples | Feature analysis cannot be performed because there is no labeled sample in the dataset. | Ensure that there are labeled samples in the dataset. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4704 | Currently unable to start data analysis task, Please try again later | Feature analysis cannot be performed because a dataset version is being published. | Try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4706 | Can not start data analysis task, dataset version status must be normal | Feature analysis cannot be performed because the dataset version is not in normal state. | Ensure that the current dataset version is in normal state. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4709 | Data preprocessing task already exists | A training task whose name is the name value already exists. | Ensure that the name value is correct in the request for creating in the task. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4710 | Dataset export file error | Failed to publish or export the dataset. | Ensure that the task export or publish parameters are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4711 | Publishing requires splitting but annotated samples do not satisfied for splitting rules | Failed to publish because the dataset label samples do not meet splitting requirements. | Ensure that the number of dataset labels and the number of labeled samples meet the splitting requirements. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4712 | Dataset publish version failed | Failed to publish the dataset version. | Ensure that the task export or publish parameters are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4800 | The label task already exists | A labeling task whose name is the task_name value already exists. | Ensure that the task_name value is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4801 | The label task not exists | The labeling task specified by the ID does not exist. | Ensure that the imported task ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4820 | Unsupported operation, label task type is %s | The labeling task type does not support the operation. | Ensure that the labeling task type is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4822 | The number of labelers must exceed 1 | At least two annotators are available in the team. | Check the number of annotators in the team. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4823 | Import to dataset version error | No data can be imported to a table dataset version. | Ensure that the dataset type is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4824 | Dataset version status must be normal | Abnormal dataset version state. | Check the version publish state of the dataset. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4825 | Dataset version is empty | No sample is available in the dataset version. | Check the version publish result of the dataset. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4827 | Dataset version delete failed | Failed to delete the dataset version because there is a labeling task based on the dataset version. | Check whether there is any labeling task that is created using the dataset version. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.4851 | Task version not found | The version specified by version_id does not exist. | Ensure that the version_id value is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 401 | ModelArts.4504 | Iam error | IAM error. | Ensure that the AK/SK or token is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4310 | OBS action is forbidden, please check iam agency or OBS and so on | You do not have permission to access OBS. | Grant the permission to access OBS. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4335 | Iam agency is invalid | Invalid IAM agency. | Check the IAM permission. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4336 | The user hasn't permission | Restricted user permission. | Check the user permission. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4348 | Check dli agency failed | Failed to create the agency for checking DLI. | Check the agency permission for checking DLI. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4419 | File is too large | The size of the file imported from OBS or to be parsed has reached the maximum allowed limit. | Ensure that the file is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4500 | The number of iam agencies has reached the maximum | The number of IAM agencies exceeded the upper limit. | Delete unused IAM agencies. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4501 | The iam agency create action is forbidden | Failed to create the IAM agency. | Ensure that you have permission to create an IAM agency. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4600 | The worker action is forbidden | The team member cannot perform the operation. | Check whether the team member has permission to perform the operation. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4613 | Task not finish | Failed to obtain the task result because the task execution has not been completed. | Try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4803 | Dataset has unfinished label tasks, the operation is forbidden | Failed to delete data because the labeling task in the dataset has not been completed. | Ensure that all labeling tasks in the dataset are complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4821 | Task is publishing, the operation is forbidden | The auto labeling task cannot be started because a labeling task is being published. | Try again after the labeling task is published. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.4850 | Process task is initializing, the operation is forbidden | Failed to delete the task because the processor task is being initialized. | Check the task status. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 429 | ModelArts.4395 | Too many dataset requests | Frequent dataset or labeling task creation in a unit time. | Try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.4354 | Insufficient quota | The number of created datasets has reached the maximum allowed limit. | Delete unused datasets or apply for a higher quota. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.4360 | Sync data source error | Failed to synchronize the data source. | Check the synchronization task status and result. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.4367 | Update dataset state failed | Failed to delete the dataset. | Check the dataset status. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.4373 | No migratory job | Failed to create the dataset migration task. | Check whether the source dataset of the migration task is valid. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.4424 | Delete sample failed | Failed to delete the dataset sample. | Ensure that the sample to be deleted is correct and that there is unfinished import or synchronization task. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.4614 | Task failed | Failed to run the task. | Check the execution result of the processor task. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 501 | ModelArts.4383 | Unsupported operation, dataset %s type is %s | The operation cannot be performed in the dataset. | Check whether the dataset supports the current operation. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 501 | ModelArts.4385 | Auto deploy task exist | Failed to start the deploy task because an auto deploy task is being executed in the dataset. | Start a new deploy task after the current task is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 501 | ModelArts.4386 | Auto labeling task exist | Failed to start the auto labeling task because an auto labeling task is being executed in the dataset. | Start a new auto labeling task after the current task is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 501 | ModelArts.4387 | Pre-label task exist | Failed to start the pre-labeling task because a pre-labeling task is being executed in the dataset. | Start a new pre-labeling task after the current task is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 501 | ModelArts.4394 | Task is running | Failed to obtain the migration result because a migration task is being executed in the dataset. | Wait until the migration task is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.0116 | Free train job reached the limit | The number of free jobs exceeds the upper limit. | Create the job again after the running job or the queuing job is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.0806 | download log failed | No log is found. | Ensure that the configured log storage duration exceeds the log storage duration. View the job running parameters and ensure that the job is started successfully. If the fault persists, contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.0901 | Get dataset url failed | An error occurred when obtaining the dataset URL. | Ensure that the dataset URL is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.2605 | The number of available nodes in the resource pool is illegal: ${nodeCount} | No compute node is available in the selected resource pool. | Select another resource pool. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.2606 | ${obsUrl} should not be bucket | The selected dataset path is invalid. | Select a valid path or select another dataset. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.2607 | parameter length reaches the max limit ${BATCH_CMD_LENGTH_LIMIT} | The number of characters in the running parameter exceeds the upper limit. | Check the running parameters and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.2608 | ${url} should not contains | Invalid OBS path. | Ensure that the OBS path does not contain the following characters: '{} [] and spaces try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.2701 | There is already a peer connection | The VPC peering connection already exists in the resource pool. | Use the existing connection or create another one. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.2702 | Invalid vpc or subnet | The specified VPC CIDR block overlaps with the dedicated resource pool CIDR block, and no VPC peering connection can be created. | Change the VPC CIDR block. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.2703 | network of pool is not ready | There are multiple peering connections in the dedicated resource pool. These peering connections may have been manually operated. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.3000 | volumes of config are used in dedicated pools | You do not have the permission to access the volume in the dedicated resource pool. | Access a common volume. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.0015 | The resource you requested is not exist | The queried resource does not exist. | Ensure that the URL is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.2700 | ${operator} failed. Response status is ${status}.Detail error msg: $agentErrorMsg | Failed to call the VPC interface. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.2704 | Update sfs turbo info of pool failed. Error msg: {ex.getMessage} | Failed to create the VPC peering connection and call the VPC interface. | Try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.2800 | ${operator} failed. Response status is $status. Detail error msg: ${agentErrorMsg} | Failed to access the SFS Turbo interface. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5011 | Invalid parameter | Invalid parameter. | Modify the parameter. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5012 | Invalid product attribute | Invalid product attribute. | Modify the product attribute. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5016 | The original model ({0}) does not exist during model release | The product source model does not exist. | Select another source model. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5022 | Unsupported model type | The model type is not supported. | Select another source model. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5025 | Incorrect verification code | Incorrect verification code. | Enter the correct verification code. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5026 | Verification code expired | Verification code expired. | Obtain a new verification code. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5027 | The verification code does not match the email address. | The email address and verification code do not match. | Obtain a new verification code. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5038 | You must first get a verification code | You have not obtained the verification code. | Specify your email address and obtain the verification code by email. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5041 | Duplicate version. Refresh the page and try again | Duplicate version. | Refresh the page and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5047 | Hilens product name duplicated. | Duplicate HiLens name. | Enter another product name. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5048 | Hilens skill version duplicated. | Duplicate HiLens version. | Select another version. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5049 | Incorrect Hilens skill. Select the skill corresponding to the offering. | Incorrect HiLens skill. | Select the correct HiLens skill. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5051 | The HiLens skill type is not supported. Release the skill type in HiLens Studio. | The HiLens skill is currently unavailable. Publish the skill in HiLens Studio. | Select the correct HiLens skill. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5052 | The user does not have the agency permission | You do not have the agency permission. | Set an agency and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5303 | The obs source data is empty | Empty source data. | Select other source data. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5304 | The maximum number of files has been exceeded | The number of files has reached the maximum allowed limit. | Select other source data or reduce the data volume. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5305 | The maximum size of files has been exceeded | The file size has reached the maximum allowed limit. | Select other source data or reduce the data volume. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5306 | The maximum depth of files has been exceeded | The file depth has reached the maximum allowed limit. | Select other source data or reduce the data depth. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5309 | Only allow edge service published to AIHub. | Only edge VAS can be published. | Select the edge VAS. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5312 | Only allow market category service published to AIHub. | Only market VAS can be published. | Select the market VAS. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5313 | Only allow released service published to AIHub. | Only published VAS is allowed. | Select the published VAS. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.5314 | Only allow 'closed Beta Test' stage service published to AIHub. | Only Closed Beta Test VAS can be published. | Select the Closed Beta Test VAS. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 401 | ModelArts.5001 | Token is blank | The token does not exist. | Add the token and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 401 | ModelArts.5002 | Token is invalid | Invalid token. | Obtain a token and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 401 | ModelArts.5056 | You do not have the permission to access the requested resource. | You have not subscribed to HiLens. | Log in to the HiLens management console and subscribe to the service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.5013 | The user is not registered. Please release a product first to complete the registration | You have not registered with AI Gallery. | Publish a product in AI Gallery for registration. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.5014 | Permission deny | You do not have permission to access the resource. | Access other resources. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.5017 | Account suspended. | Suspended account. | Ensure that the account is not restricted and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.5040 | Your usage has exceeded the maximum quota | The resource usage has reached the maximum allowed limit. | Wait until the system is idle and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.5043 | Challenge applications submit failed | Failed to submit the contest. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.5053 | Product has been recycled. | The product has been reclaimed. | Select another product. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.5054 | At least one available version must exist. | At least one available version is required for the product. | Perform other operations. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.5055 | The subscription has expired. | The subscription has expired. | Initiate a new subscription. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.5057 | The free package is sold out. | The free package has been sold out. | Select another package. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.5058 | Object ({0}) does not exit. | The object does not exist. | Select another object. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 409 | ModelArts.5015 | The product is being reviewed | The product is being reviewed. | Perform operations after the review is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 409 | ModelArts.5044 | Operations conflict, please try again later | Failed to perform the operation. | Try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5000 | Please try again later or contact customer service to solve the problem | Internal error. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5003 | Internal Error: access IAM service failed | Failed to access IAM. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5004 | Internal Error: access moderation service failed. | Failed to access Text Moderation. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5005 | Internal Error: access ModelArts service failed | Failed to access ModelArts. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5006 | Internal Error: access AI service failed | Failed to access the managed services in AI Gallery. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5007 | Internal Error: access AI manager failed | Failed to access the manager services in AI Gallery. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5008 | Internal Error: access SMN service failed | Failed to access SMN. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5009 | Database operation failed | Database operation error. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5010 | OBS operation failed | Failed to access OBS. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5019 | Internal Error: access CBC service failed | Failed to access CBC. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5021 | Internal Error: access LCS service failed | Failed to access LCS. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5039 | Dear User,the traffic is a little busy. Please try again later | Excessive requests. | Try again later. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5050 | Internal Error: access Hilens service failed | Failed to access HiLens. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5300 | Failed to explore the user source address. | Failed to traverse user source addresses. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5301 | Failed to download the source file from OBS. | Failed to download the source file from OBS. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5302 | Failed to upload the source file to the destination address. | Failed to upload the source file to the destination address. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5308 | Internal Error: access VAS service failed | Failed to access VAS. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.5311 | Failed to get market category id. | No market category ID found. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.0101 | Invalid Argument. | Invalid parameter. | Enter the correct parameter as prompted. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.0107 | The values of the request parameters ({0},{1}) are invalid. | Invalid parameter values ({0}, {1}). | Check whether the parameter values are valid. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.0204 | Token must contain projectId info. | No project ID included in the token. | Ensure that the project token is used. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3015 | Config json file does not conform to the specification. | The model configuration file does not comply with file specifications. | Check whether config.json or initial_config complies with the specifications. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3016 | Failed to parse config json file because of unsupported fields, types, or formats({0}, {1}). | Failed to parse the configuration file because the field, type, or format is not supported. | Check whether the field is correct as prompted. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3017 | Failed to publish model because source location noncompliance. | Failed to publish the model because the model source path does not meet specifications. | Check whether the source_location value complies with the specifications. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3023 | Invalid labels({0}) of model. | Invalid model label {0}. | Ensure that a model label starts with a letter or a Chinese character and contains a maximum of 64 characters, including letters, digits, underscores (_), and Chinese characters. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3024 | The templateInputs field is incorrectly configured, check if the input is consistent with the template requirements. | Incorrect configuration. Check whether the configuration complies with the template requirements. | The parameter configuration does not comply with the template requirements. Modify the configuration. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3025 | User ({0}) has only a single share permission and cannot be shared with all users. | User {0} does not have permission to share data with all users. | Only the administrator or accounts in the whitelist have permission to share data with all users. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3026 | Failed to delete infer format, infer format ({0}) already be used by template. | Failed to delete input/output mode {0} because it is being used by a template. | Find the template that is using the input/output mode, disassociate the mode from the template, and delete the mode again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3027 | The model used by the template ({0}) is private and belongs to other users and cannot be shared. | Input/Output mode {0} used by the template cannot be shared. | Select another mode. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3028 | Failed to publish model, please select input and output mode. | Failed to publish the model. Select an input/output mode. | Select another input/output mode and publish the model again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3029 | Model publishing failed because the Template model must provide the template ID used. | Failed to publish the model because the template ID is unavailable. | Enter the template ID. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3030 | Model publishing failed, template ({0}) does not support modifying its built-in input and output mode. | Failed to publish the model because the built-in input/output mode of template {0} cannot be changed. | Do not change the input/output mode of a template when publishing the template model. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3031 | Cancel sharing failed, ({0}) has not been shared with other tenants. | Failed to cancel the sharing because image {0} is not shared with other users. | Ensure that image {0} is not shared with other users. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3032 | Image ({0}) cannot be shared to admin ({1}), please check the image permissions. | Failed to share image {0} with the administrator {0}. Check the image permission. | Perform operations according to the error message. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3033 | Template publishing failed, please provide template label. | Failed to publish the template model because its label is left blank. | Set the model label. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3034 | Template model failed to be published, template field is required. | Failed to publish the template model because the template field is left blank. | Set template. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3035 | Profile preview failed, sourceLocation and previewConfig fields need to provide at least one. | Failed to preview the configuration file. | Either source_location or preview_config must be specified. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3036 | Parameter verification failed, parameter ({0}) is required. | Failed to check parameter {0} because it is left blank. | Set parameters according to the error message. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3037 | Parameter ({0}:{1}) is invalid. | Invalid parameter {0}:{1}. | Modify passwords as prompted. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3038 | When isSpecific is true, domainId is required. | Failed to perform the operation because domain_id is left blank. | Set domain_id as prompted. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3039 | Template input input_id cannot be repeated. | Failed to perform the operation because input_id is repetitive. | Ensure that the input_id value is unique. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3040 | When the installer installer is yum or apt-get, and the version packageVersion exists, the version constraint restraint can only be EXACT. | Failed to perform the operation because restraint can only be EXACT. | Change the restraint value to EXACT. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3041 | When the installer installer is conda or pip, and the version packageVersion exists, the version constraint restraint can only be EXACT, ATLEAST, ATMOST. | Failed to perform the operation because restraint can only be EXACT, ATLEAST, or ATMOST. | Change the restraint value to EXACT, ATLEAST, or ATMOST. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3063 | Mode unshared failed, the template using this mode has been shared, you need to cancel the sharing of the template first. | Failed to cancel mode sharing because the template using the mode is being shared. | Perform operations according to the error message. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3070 | There is a model name that does not belong to this tenant: ({0}). | The model does not belong to user {0}. | The domain ID of the subscribed model is different from the entered domain ID. Contact the model subscription service and check whether the entered domain ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3072 | The domain id is the same and does not support subscribing to your own model. | You cannot subscribe to your own model. | Use another account to subscribe to the model. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3074 | Unable to delete subscribed model. | Failed to delete the subscribed model. | Unsubscribe from the model and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3076 | Model does not support deploying edge services and cannot broadcast. | Failed to perform the operation because the model cannot be deployed as an edge service. | The install_type of the model does not support edge service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3077 | Model is a subscription model that cannot be broadcast. | Failed to perform the operation because the model has been subscribed. | The model_source of the model has been set to subscribe. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3078 | The model status is not normal and cannot be broadcast. | Failed to perform the operation because the model status is abnormal. | Check the model status. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3079 | Purchased license, can't cancel subscription. | Failed to unsubscribe from the model because a license has been configured for the model. | Delete the license and unsubscribe from the model. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.0108 | You are not authorized to perform the ({0}) operation. | You do not have permission to perform {0}. | Check whether you are authorized to perform operations on OBS or APIs. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.0203 | Invalid token. | Invalid token. | Obtain a new token and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.0206 | Invalid AK/SK. | Invalid AK/SK. | Check whether the token is valid. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.3010 | Failed to copy model, you don't have permission to copy the model ({0}). | You do not have the permission to copy model {0}. | Check whether the entered token or model ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.3075 | Model ({0}) is a subscription model and cannot create a new version. | Failed to create a new version because model {0} has been subscribed. | No new version can be created for a subscribed model. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.3001 | Model ({0}) does not exist. | Model {0} does not exist. | Check whether the entered model ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.3003 | Failed to get model names list. | Failed to obtain the model name list. | Check whether the account is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.3019 | Infer format ({0}) does not exist. | Input/Output mode {0} does not exist. | Change the input/output mode. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.3021 | Template ({0}) does not exists. | Template {0} does not exist. | Select another template. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.3071 | The subscription ({0}) does not exist. | Subscription {0} does not exist. | Subscribe to the model and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.3080 | Model optimization job ({0}) does not exist. | Model optimization task {0} does not exist. | The task is unavailable. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 409 | ModelArts.3002 | Model ({0}, {1}) already exists. | Model ({0}, {1}) already exists. | Change the model name or version and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 409 | ModelArts.3020 | Infer format ({0}) already exists. | Input/Output mode {0} already exists. | Change the input/output mode. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 409 | ModelArts.3022 | Template ({0}) already exists. | Template {0} already exists. | Select another template. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 409 | ModelArts.3073 | model ({0}) already exists, no subscription required. | Model {0} already exists. | Do not subscribe to another model with the same name. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.0010 | Internal error. | Internal error. | Contact R&D and O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.0109 | Unauthorized account. | Unauthorized account. | Only the administrator can call alarm APIs. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3006 | Failed to publish model. | Failed to publish the model. | The model metadata failed to be stored to the database. Contact R&D and O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3009 | Failed to delete model, model ({0}) already deploy service. | Failed to delete model {0} because it has been deployed as a service. | Delete the deployed service and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3043 | User ({0}) does not have obs: object: PutObjectAcl permission. | User {0} does not have the obs:object:PutObjectAcl permission. | Add the permission and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3044 | Model file ({0}) is larger than 5G and cannot be imported. | Failed to import model file {0}. | Ensure that the file is at most 5 GB in size. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3045 | Parameter ({0}) is null. | Parameter {0} is left blank. | Check the parameter setting as prompted. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3047 | ExeML model({0}) cannot be converted. | Failed to convert model {0}. | ExeML models cannot be converted. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3048 | Model({0}) is being imported and cannot be converted. | Failed to convert model {0} because the model status is abnormal. | Convert the model after the model status changes to normal. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3049 | Cannot convert models belonging to other users. | Models of other users cannot be converted. | You can only convert your models. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3050 | Get user temporary credential failed. | Failed to obtain the temporary user certificate. | Check whether the token is valid. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3052 | Chip Type ({0}) not support. | Chip type {0} is not supported. | Check whether the chip is of Ascend, GPU, Arm, or general type. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3053 | Model Type ({0}) not support. | Model type {0} is not supported. | This type of model is not supported. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3054 | Task ({0}) does not exists. | Task {0} does not exist. | The task is unavailable. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3055 | Task ({0}) is running cannot be deleted. | Failed to delete task {0} because it is running. | Delete the task after it is complete. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3056 | Task name ({0}) not meeting the specification. | Task name {0} does not comply with specifications. | Ensure that a task name starts with a lowercase letter, ends with a lowercase letter or digit, and contains 2 to 24 characters, including lowercase letters, digits, and hyphens (-). | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3057 | Task description ({0}) not meeting the specification. | Task description {0} does not comply with specifications. | Ensure that task description contains 1 to 100 characters and cannot contain the following characters: &,!\"<>=. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3058 | Task input ({0}) not meeting the specification. | Task input {0} does not comply with specifications. | Perform operations according to the error message. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3059 | Task output ({0}) not meeting the specification. | Task output {0} does not comply with specifications. | Ensure that the task output is a valid HTTP or HTTPS address. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3060 | Task spec ({0}) not meeting the specification. | Advanced task option {0} does not comply with specifications. | Ensure that the advanced option does not contain Chinese characters or the following characters: (|)&$?<>. Ensure that the value is less than 4000. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3061 | get Task ({0}) log parameter not meeting the specification. | Log parameters of task {0} do not comply with specifications. | Ensure that the offset or lines value is greater than or equal to 0. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3062 | Task ({0}) exists. | Task {0} already exists. | Change the name and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3064 | DL Framework Type ({0}) not support. | Deep learning framework {0} is not supported. | This type of framework is not supported. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3065 | The image of the model is being built so the runtime cannot be updated. | Failed to update runtime because the model image is being created. | Wait until the image is created. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3301 | Failed to build image. | Failed to create the image. | Check the image, or contact R&D and O&M personnel to rectify the fault. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3801 | invalid token, can not get template ak/sk. | Failed to obtain the template AK/SK due to an invalid token. | Obtain a new token and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3802 | create encrypt path or file failed. | Failed to create the encryption path or file. | Contact R&D and O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3803 | download file from obs failed. | Failed to download the file from OBS. | Check whether the OBS path is available. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3804 | upload file to obs failed. | Failed to upload the file to OBS. | Contact R&D and O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3805 | file can not be empty. | The file cannot be left blank. | Set file. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3901 | license id ({0}) is not exist. | License ID {0} does not exist. | Check whether the license ID is valid. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3902 | Failed to get license info because ({0}). | Failed to obtain the license because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3903 | Renew license failed because ({0}). | Failed to renew the license because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3904 | Upload data failed because ({0}). | Failed to report the used quota because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3905 | Failed to get app key. | Failed to obtain the app key. | Contact R&D and O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3906 | Failed to create license because ({0}). | Failed to create the license because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3907 | Failed to delete license because ({0}). | Failed to delete the license because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3908 | Failed to get CBC resources. | Failed to obtain CBC resources. | Check the license ID or the associated license configuration. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3909 | access CBC failed. | Failed to access CBC. | Contact R&D and O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3910 | Check CBC auth failed because ({0}). | Failed to authorize CBC operations because {Reason}. | Locate the fault based on the failure cause. Renewal authentication fails because cloudservicetype is not provided. Unsubscription authentication fails because an instance is being deployed. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.7001 | Internal error occurred in workspace manager. | An internal error occurred in the workspace manager. | Contact R&D and O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3514 | Field [input_params] must be set for the model that is used to deploy the batch service. | The input_params parameter for the batch service model is left blank. | Set input_params. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3515 | The model {id} cannot be used for deploying services because it is still being published. | Failed to deploy the service because model {ID} is not ready. | Try again after the model is ready. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3516 | Failed to deploy services because the version of the model that is used for deploying services is the same. | Failed to deploy the service due to duplicate model versions. | Correct the model version list to ensure that no duplicate model versions exist. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3518 | The {service_type} service has not been enabled or authorized. | Service {type} has not been enabled or authorized. | Enable or authorize the service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3519 | Services only in one of states in [deploying, running, stopping, deleting] can be updated. | Services in the deploying, running, stopping, or deleting state cannot be updated. | Do not update services in the deploying, running, stopping, or deleting state. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3520 | A maximum of {number} {service_type} services are allowed. | The total number of {type} services has reached the maximum allowed limit {quantity}. | Delete the services that are no longer used or contact service O&M personnel to increase the quantity quota. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3521 | A maximum of {number} {service_type} services in running status are allowed. | The total number of {type} services in the running state has reached the maximum allowed limit {quantity}. | Delete the services that are no longer used or contact service O&M personnel to increase the quantity quota. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3522 | A maximum of {number} {service_type} service instances are allowed. | The total number of {type} service instances has reached the maximum allowed limit {quantity}. | Delete the service instances that are no longer used or contact service O&M personnel to increase the quantity quota. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3523 | Service {name} has been subscribed. | Service {name} has been subscribed. | Directly use the subscribed service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3524 | Failed to subscribe to the service because {reason}. | Failed to subscribe to the service because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3525 | Forbidden to update service {name} because it is a shared service. | Failed to update service {name} because it is a shared service. | Do not update a shared service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3527 | Forbidden to subscribe to service {id} because it is a {service_type} service. | Failed to subscribe to service {ID} because it is a {type} service. | The service of this type cannot be subscribed to. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3528 | Forbidden to subscribe to service {id} because it is released by yourself. | Failed to subscribe to service {ID} because it is your service. | You cannot subscribe to services published by yourself. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3529 | Model {id} under service {id} does not exist. | Model {ID} of service {ID} does not exist. | Ensure that the model ID is correctly set and that the model belongs to the target service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3531 | Service {id} has created the QR code. | A QR code has been created for service {ID}. | The QR code has been created for the service and does not need to be created again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3532 | No QR code found for service {id}. | A QR code has not been created for service {ID}. | Create a QR code for the service and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3533 | The selected edge node does not support {GPU/NPU}. | The selected edge node flavor does not support {GPU/NPU}. | Add the target hardware support to the selected edge node, or use another edge node that supports the target hardware. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3534 | The security group must contain at least one inbound rule to allow the TCP request from source address 0.0.0.0/0 and port 8080. | The security group must contain at least one inbound rule to permit the requests whose protocol is TCP, source address is 0.0.0.0/0, and port number is 8080. | Add the inbound rule to the security group. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3535 | Subservice {name} of service {name} does not exist. | Subservice {name} of service {name} does not exist. | Ensure that the subservice name is correctly set and that the subservice belongs to the target service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3536 | Subservice {name} of service {name} has been subscribed. | You have subscribed to subservice {name} of service {name}. | Directly use the subscribed subservice. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3538 | The requirement notification of service {name} should not exceed one. | At most one requirement notification is allowed for service {name}. | Check the configuration and ensure that no more than one requirement notification is configured for service {name}. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3540 | Operation failed because you are not the owner of service {name}. | You are not the owner of service {name}. | This operation can be performed only by the service owner. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3541 | Error code {error_code} of service {name} does not exist. | Error code {error code} of service {name} does not exist. | Ensure that the error code is correctly set and that the error code belongs to the target service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3542 | Error code {error_code} of service {name} already exists. | Error code {error code} of service {name} already exists. | Change the error code and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3544 | URL domain CNAME resolution failed. | Failed to parse the CNAME domain. | Check whether the URL is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3545 | Invalid certificate or private key. | Invalid certificate or private key. | Check whether the certificate or private key is correctly configured. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3547 | Cluster {id} does not exist. | Cluster {ID} does not exist. | Check whether the cluster ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3548 | Path {path} is not a valid regex. | Path {path} is not a valid regular expression. | Check whether the path is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3549 | Error code {code} is duplicated. | Duplicate error code {error code} in the request body. | Modify the error code to ensure that the error code is unique. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3550 | Domain {name} has been used. | Domain {noun} has been used. | Change the domain name and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3551 | OBS path {path} does not exist. | OBS path {path} does not exist. | Check whether the OBS path is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3552 | The length of [resource_id] must be in the range of [0, 64]. | The resource_id value is not in the range from 0 to 64. | Check whether RESOURCE_SPEC_CODE is too long. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3553 | Service {name} not subscribed yet. | Service {name} has not been subscribed to. | Subscribe to the service and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3554 | Cluster name {name} has been used. | Cluster name {name} has been used. | Change the cluster name and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3556 | Forbidden to share ai-service {id} because ai-service is unsharable. | AI service {ID} cannot be shared. | AI services cannot be shared. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3559 | Source error code {error_code} of service {name} already exists. | Source error code {error code} of service {name} already exists. | Change the source error code and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3560 | Project {project_id} has not subscribed to subservice {id}. | Subservice {ID} has not been subscribed for project {ID}. | Subscribe to the subservice and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3561 | Insufficient node quota. | Insufficient node quota. | Contact service O&M personnel to increase the quota or delete unnecessary nodes to release resources. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3562 | The value of field {due_time} must be a future time. | The due_time value must be later than the current time. | Set the due_time parameter to a time later than the current time. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3564 | The sample collection task has been created for service {id}. | Sample collection for service {ID} has been created. | Do not create the task again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3565 | No sample collection task is created for service {id}. | Sample collection for service {ID} has not been created. | Create a service sample collection task and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3566 | Forbidden to modify the default workspace. | The default workspace cannot be modified. | Do not modify the default workspace. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3567 | OBS error occurs because {reason}. | OBS error because {cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3568 | OBS client error occurs. | The OBS client is abnormal. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3572 | Invalid OBS URL {url}. | Invalid OBS path {path}. | Check whether the OBS path is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3573 | Failed to obtain the bucket name from OBS URL {url}. | Failed to obtain the bucket name from OBS path {path}. | Check whether the OBS path is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3574 | Failed to validate the correctness of OBS URL {url}. | Failed to check OBS path {path}. | Check whether the OBS path is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3576 | Failed to query the model quota. | Failed to obtain the model quota. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3577 | Failed to update the model quota. | Failed to update the model quota. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3578 | Insufficient model quota. Increase the quota or delete any unnecessary services. | Insufficient model quota. | Increase the quota or delete the models that are no longer used, and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3580 | Model not purchased. | The model has not been purchased. | Purchase the model and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3582 | Failed to create edge configurations. | Failed to create edge configurations. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3583 | Failed to create the edge application due to IEF error. | Failed to create the edge application due to an IEF platform error. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3584 | Failed to update the edge application. | Failed to update the edge application. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3585 | The host port has been used by another edge application. | The host port has been used by another edge application. | Use another port or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3586 | Failed to create the edge application. | Failed to create the edge application. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3587 | Failed to delete the edge application. | Failed to delete the edge application. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3588 | Failed to create edge volumes and environments. | Failed to create edge parameters. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3589 | Model {id} cannot be used to deploy {service_type} service. | Model {ID} cannot be used to deploy the {type} service. | Select another deployment type. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3590 | Invalid expression rule. Create a rule using Spring Expression Language and the desired result type is Boolean. | Invalid expression rule. | Ensure that the rule complies with the Spring expression language syntax, and the expected result is of Boolean type. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3591 | There are duplicate rules in the extend-configs. | Duplicate rules in extend-configs. | Modify the expression specifications to prevent duplicate expressions. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3592 | Incorrect model health configuration. | Incorrect model health check parameters. | Check whether the health check parameters of the model are correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3593 | The model has been expired. | The model has expired. | Purchase or subscribe to the model again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3594 | Failed to query IEF instances. | Failed to obtain the edge instance. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3595 | Failed to create the IEF application mesh. | Failed to create the application mesh. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3596 | Failed to update the IEF application mesh. | Failed to update the application mesh. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3597 | Please authorize the development environment to use and store your AK and SK. | Failed to use the service because the development environment has not been authorized to store and use your AK and SK. | Authorize the development environment to store and use your AK and SK. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3598 | Only nodes in the [Running] state can be selected. | Only running nodes can be selected. | Select a running node and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3610 | Parameter {name} cannot be empty. | Parameter {name} cannot be left blank. | Set the parameter and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3611 | Failed to query the batch task run log. | Failed to obtain batch processing task logs. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3612 | Failed to {create/update} the service payload due to error code {code}. Please try later or submit a service ticket for professional technical support. | Failed to {create/update} service workload. The error code is {error code}. Try again later or submit a service ticket. | Try again or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3613 | Failed to register the API. Please try later or submit a service ticket for professional technical support. | Failed to register the service API. Try again later or submit a service ticket. | Try again or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3620 | Failed to get the number of associated services. | Failed to obtain the number of associated services. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3811 | Failed to query the agency because {reason}. | Failed to obtain the agency because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3812 | Failed to create AI resource specification code {code} because {reason}. | Failed to create resource flavor code {code} because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3813 | Failed to update AI resource specification code {code} because {reason}. | Failed to update resource flavor code {code} because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3814 | Failed to delete AI resource specification code {code} because {reason}. | Failed to delete resource flavor code {code} because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3815 | Failed to delete AI subservice {id} because {reason}. | Failed to delete subservice {ID} because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3816 | Failed to create the AI proxy mapping because {reason}. | Failed to create the proxy mapping because {reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3817 | Failed to update the AI proxy mapping because {reason}. | Failed to update the proxy mapping path because {reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3818 | The agency of service {name} has been defined. | The agency of service {name} has been configured. | Do not repeat the operation. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3822 | The batch service task does not exist. | The batch service does not exist. | Enter the correct batch service ID. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3825 | Failed to generate the SDR data because {reason}. | Failed to generate CDR data because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3826 | Failed to create the API because {reason}. | Failed to create the API because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3827 | Failed to subscribe to the API because {reason}. | Failed to subscribe to the API because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3828 | Failed to unsubscribe from the API because {reason}. | Failed to unsubscribe from the API because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3829 | Failed to modify the API subscription status because {reason}. | Failed to update the API subscription because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3830 | Operation not allowed. Change the charging mode from postpaid to prepaid in CBC. | You are not allowed to change the billing mode from postpaid to prepaid. | Change the billing mode in CBC. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3831 | Operation not allowed. Change the charging mode from prepaid to postpaid in CBC. | You are not allowed to change the billing mode from prepaid to postpaid. | Change the billing mode in CBC. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3832 | The subscription configuration is not modified and does not need to be updated. Please check. | Failed to perform the operation because the subscription configuration has not modified. | Change the subscription configuration and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3833 | Failed to delete the API because {reason}. | Failed to delete the API because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3834 | Failed to update metedata in CBC because {reason}. | Failed to update the CBC metadata because {Reason}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3835 | Resource specification code {code} of service {name} does not exist. | Resource flavor code {code} of service {name} does not exist. | Ensure that the resource flavor code is correctly set and that the code belongs to the target service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3836 | Resource specification code {code} of project {id} does not exist. | Resource flavor code {code} of project {1} does not exist. | Ensure that the resource flavor code is correctly set and that the code belongs to the target project. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3837 | Resource ID {id} of project {id} does not exist. | Resource {ID} of project {1} does not exist. | Ensure that the resource ID is correctly set and that the resource belongs to the target project. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3838 | The hard-select has not been enabled for service {id}. | Hard example filtering of service {0} has not been enabled. | Enable hard example filtering for the service and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3839 | The hard-select has been enabled for service {id}. | Hard example filtering of service {0} has been enabled. | You do not need to enable it again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3840 | Only one algorithm can be set for the service model. | Service {0} has more than one labeling type. | Modify the configuration to ensure that there is only one labeling type. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3841 | The value of [dataset_type] must be one of values in [image_classification, object_detection]. | The labeling type is not object detection or image classification. | Change the labeling type to object detection or image classification. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3842 | The labeling type of service algorithm {name} does not match that of dataset {type}. | The labeling type of service algorithm {0} does not match that of dataset {1}. | Modify the labeling type or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3843 | Failed to query the information about dataset {id}. | Failed to obtain database {0}. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3844 | Failed to import samples to dataset {id}. | Failed to import the sample to dataset {0}. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3845 | No sample is available for import under the OBS path {path} of service {id}. | No sample is available to be imported to OBS path {path} of service {ID}. | Try again or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3846 | Failed to add the OBS bucket lifecycle rule for service {id}. | Failed to add the lifecycle rule for the OBS bucket of service {ID}. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3847 | Failed to delete the OBS bucket lifecycle rule for service {id}. | Failed to delete the lifecycle rule for the OBS bucket of service {ID}. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3848 | Service {id} in the information of dataset {import_type} already exists. | The service {ID} of the {import type} dataset already exists. | Check the request and select the correct service ID. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3849 | Service {id} in the information of dataset {import_type} does not exist. | The service {ID} of the {import type} dataset does not exist. | Check whether the service ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3850 | The hard-sample-select task {id} of service {id} does not exist. | Hard example task {ID} of service {ID} does not exist. | Ensure that the hard example task ID is correctly set and that the task belongs to the target service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3851 | The status of hard-sample-select task {name} cannot be changed from {status} to {status}. | The status {status value} of the hard example task {name} cannot be updated to {status value}. | Try again or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3852 | Failed to start hard-sample-select task {id} because related OBS files have been deleted. | Failed to start hard example task {ID} because key OBS files have been deleted. | Try again or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3853 | The hard-sample-select quota of project {id} does not exist. | The quota for selecting hard samples for project {ID} does not exist. | Create the quota and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3854 | The hard-sample-select quota of project {id} already exists. | The quota for selecting hard samples for project {ID} already exists. | You do not need to create it again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3856 | A maximum of {number} free services are allowed. | The number of free services has reached the maximum allowed limit {Number}. | Delete unnecessary free services to release resources. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3857 | A maximum of {number} free service instances are allowed. | The number of free services has reached the maximum allowed limit {Number}. | Delete unnecessary free services to release resources. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3862 | Subservice {id} has been added to whitelist URL {url}. | The URL {URL} has been added to the whitelist of the sub-service {ID}. | Do not repeat the operation. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3863 | Whitelist URL {id} of service {name} does not exist. | The whitelist URL {ID} of the service {name} does not exist. | Ensure that the URL ID in the whitelist is correct and that the URL belongs to the corresponding service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3864 | Subservice {id} of service {name} does not exist. | The sub-service {ID} of service {name} does not exist. | Ensure that the sub-service ID is correct and that the sub-service belongs to the corresponding service. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3865 | The size of the download whitelist of service {name} exceeds the maximum number {number} allowed. | The number of the whitelist records downloaded by service {name} exceeds the upper limit {value}. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3866 | Domain ID {id} and user ID {id} already exist. | The domain ID {ID} and user ID {ID} already exist. | Do not repeat the operation. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3867 | Domain ID {id} does not exist. | The domain ID {ID} does not exist. | Check the request and enter the correct domain ID. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3868 | Domain ID {id} and user ID {id} do not exist. | The domain ID {ID} and user ID {ID} do not exist. | Check the request and enter the correct domain ID and user ID. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3869 | Failed to delete the task type because {reason}. | Failed to delete the task type. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3870 | Failed to subscribe to the API because {reason}. | Failed to subscribe to the API. Fault cause: {fault cause}. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3871 | Forbidden to subscribe to postpaid QPS for the task type. | You are not allowed to subscribe to postpaid QPS for the task type. | Check the request parameter or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3872 | Forbidden to change the charging mode for the task type from prepaid to postpaid QPS. | You are not allowed to change the billing mode of the task type from prepaid mode to postpaid QPS mode. | Check the request parameter or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3873 | No corresponding subservice is found in cluster {name}. | The cluster {0} does not have the corresponding sub-service. | Check the request parameter or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3880 | Failed to create the AS policy because {reason}. | Failed to create the AS policy. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3890 | The total number of AS policies exceeds the maximum number {number} allowed. | The number of AS policies exceeds the upper limit {0}. | Delete unnecessary AS policies. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3892 | Calling failed due to invalid CBS request. | Failed to call the API due to the invalid CBC request. | Try again or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3894 | The specification configuration information of runtime environment {name} does not exist. | The specification configurations of the running environment {0} does not exist. | Set the flavor configurations for the running environment and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3895 | The specification configuration information of runtime environment {name} already exists. | The specification configurations of the running environment {0} already exist. | Do not repeat the operation. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3896 | Resource specification code {0} for user {1} already exists. | The records of the resource specification code {0} in project {1} already exist. | Do not repeat the operation. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3897 | Failed to {create/obtain/remove} the AS policy due to error code {code}. | Failed to request {create/obtain/delete} the AS. Error code: {0}. | Try again or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3950 | Failed to obtain the AI service list. | Failed to obtain the AI service list. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3951 | Failed to parse file {name}. | Failed to parse the file {name}. | Ensure that the file name is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3952 | Insufficient resources. Please try later. | Insufficient resources. | Try again later or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3953 | Failed to delete online service {id} because it has been associated with AI service {name}. Please disassociate it and try again. | Failed to delete real-time service {ID} because it has been associated with AI service {name}. | Cancel the association between the real-time service and all AI services and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3954 | AI resource specification {id} does not exist. | The cloud resource specification {ID} does not exist. | Ensure that the cloud resource specification ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.3955 | Field [resource_id_components] of AI resource specification {id} cannot be empty. | The ID components in the cloud resource specification {ID} cannot be left blank. | Set the resource_id_components parameter and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.7002 | You are not authorized to operate dataset {id}. | You do not have the permission to operate the dataset {ID}. | Check the permission or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 401 | ModelArts.3801 | User credential (AK and SK) does not exist. | The user certificate does not exist. | Add the AK/SK again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.0210 | The project id in the request URL does not match the token. | The project ID in the request URL and the token do not match. | Use the correct project ID to generate a token. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.3555 | Forbidden to access ECS. | You do not have the permission to access the ECS. | Authorize access to the ECS and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 403 | ModelArts.3936 | The app-auth API {id} does not belong to service {id}. | The API {ID} that supports application authentication does not belong to the service {ID}. | Check the request parameter or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.3502 | Service {name} does not exist. | The service {name} does not exist. | Ensure that the service name is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.3507 | Model {name} does not exist. | The model {ID} does not exist. | Ensure that the model ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.3923 | Application {id} does not exist. | The application {ID} does not exist. | Ensure that the application ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 404 | ModelArts.3935 | The app-auth API {id} does not exist. | The API {ID} that supports application authentication does not exist. | Ensure that the interface ID is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 409 | ModelArts.3503 | Service {name} already exists. | The service {name} already exists. | Change the service name and try again. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 409 | ModelArts.3929 | Failed to create the application because {reason}. | Failed to create the application. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3501 | Failed to deploy the service. | Failed to deploy the service. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3504 | Failed to delete the service. | Failed to delete the service. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3505 | Failed to update the service. | Failed to query the service. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3506 | Model {id} does not exist. | Failed to update the service. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3508 | Failed to query the service monitoring information. | Failed to obtain the service monitoring information. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3509 | Failed to query edge nodes. | Failed to query the node. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3511 | Failed to query edge tags. | Failed to query the edge label. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3537 | Failed to handle the CBC request. | Failed to process the CBC request. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3539 | Failed to initialize service URL {url}. | Failed to initialize the service URL {URL}. | Ensure that the service URL is correct. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3543 | Invalid CBC request. | The CBC request is invalid. | Try again or contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3546 | Failed to create the cluster. | Failed to create the dedicated resource pool. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3579 | Failed to query the model information. | Failed to query the model information. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3581 | Failed to create edge certificates. | Failed to create the edge certificate. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3802 | Failed to create API group {name} because {reason}. | Failed to create the API group {name}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3803 | Failed to register API {name} because {reason}. | Failed to register the API {name}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3805 | Failed to create AI service {name} because {reason}. | Failed to create the AI service {name}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3806 | Failed to update AI service {name} because {reason}. | Failed to update the AI service {name}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3807 | Failed to delete AI service {name} because {reason}. | Failed to delete the AI service {name}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3808 | Failed to create AI subservice {name} because {reason}. | Failed to create the sub-service {name}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3809 | Failed to update AI subservice {name} because {reason}. | Failed to update the sub-service {name}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3810 | Failed to create the agency because {reason}. | Failed to create the agency. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3819 | Failed to delete the agency definition. | Failed to delete the service agency definition. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3858 | Failed to bind task type to API {id} because {reason}. | Failed to bind task type to API {ID}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3859 | Failed to unbind task type from API {id} because {reason}. | Failed to unbind the task type from API {ID}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3860 | Failed to create the task type because {reason}. | Failed to create the task type. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3861 | Failed to update the task type because {reason}. | Failed to update the task. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3891 | Failed to operate the serverless cluster because {reason}. | Failed to operate the serverless cluster. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3893 | Failed to forward the CBC request to the cloud service. | Failed to forward the CBC request to the cloud service. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3921 | Failed to create the app-auth API because {reason}. | Failed to register the API that supports application authentication. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3924 | Failed to create the application code for application {id} because {reason}. | Failed to create the AppCode of the application {ID}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3925 | Failed to delete app-auth api {id} because {reason}. | Failed to delete API {ID} that supports application authentication. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3926 | Failed to reset the secret of application {id} because {reason}. | Failed to reset the private key of the application {ID}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3927 | Failed to reset the application code of application {id} because {reason}. | Failed to reset the AppCode of the application {ID}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3928 | Failed to obtain the app-auth API information because {reason}. | Failed to obtain information about the API that supports application authentication. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3932 | Failed to obtain the application information because {reason}. | Failed to obtain the application information. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3933 | Failed to delete application {id} because {reason}. | Failed to delete the application {ID}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3934 | Failed to delete the application code of application {id} because {reason}. | Failed to delete the AppCode of the application {ID}. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3937 | Failed to authorize the app-auth API to the application because {reason}. | Failed to authorize the API to the application. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.3938 | Failed to unbind the app-auth API from the application because {reason}. | Failed to cancel the authorization from the API to the application. Fault cause: {fault cause}. | Locate the fault based on the failure cause. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.7001 | Unknown workspace system error. Try again later or submit a service ticket for professional technical support. | An internal workspace error occurred. | Contact service O&M personnel. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.7002 | Not gray user, please contact the administrator | Workspace authentication error. | Contact the administrator to check whether the user has permissions on the workspace. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.7003 | no permission to get iam user list, please check permission | IAM permissions are incorrect. | Add the IAM permissions based on the error message. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.7004 | the status of workspace: {workspaceID} is abnormal, can not execute [action: {action}] | You are not allowed to create resources when a workspace is in the normal state, for example, a deleted or failed workspace. | Create resources in a normal workspace. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.7005 | workspace:{workspace} not existed | The workspace does not exist. | Ensure that the transferred workspace ID exists. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 400 | ModelArts.7006 | workspace number over limit, limit: {limit} | The number of workspaces exceeds the upper limit. | Delete unnecessary workspaces. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.7001 | Workspace internal error | An unknown error occurs in the workspace. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.7008 | workspace in read-only status, please wait a few minutes | The workspace is abnormal. Only the read-only operation is supported. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.7009 | call {apiType} api failed | The workspace is abnormal. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.7100 | get enterprise project id failed | EPS request error. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| 500 | ModelArts.7101 | Call pdp auth api failed. | PDP request error. | System error. Contact technical support. | ++-------------+----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + diff --git a/api-ref/source/common_parameters/index.rst b/api-ref/source/common_parameters/index.rst new file mode 100644 index 0000000..58c1f55 --- /dev/null +++ b/api-ref/source/common_parameters/index.rst @@ -0,0 +1,12 @@ +================= +Common Parameters +================= + +.. toctree:: + :maxdepth: 1 + + status_code + error_codes + obtaining_a_project_id_and_name + obtaining_an_account_name_and_id + obtaining_a_username_and_id diff --git a/api-ref/source/common_parameters/obtaining_a_project_id_and_name.rst b/api-ref/source/common_parameters/obtaining_a_project_id_and_name.rst new file mode 100644 index 0000000..eba570c --- /dev/null +++ b/api-ref/source/common_parameters/obtaining_a_project_id_and_name.rst @@ -0,0 +1,52 @@ +Obtaining a Project ID and Name +=============================== + +Scenarios +--------- + +A project ID or name is required for some requests when an API is called. Therefore, obtain the project ID and name before calling the API. Use either of the following methods: + +- `Obtaining a Project ID and Name from the Console <#obtaining-a-project-id-and-name-from-the-console>`__ +- `Obtaining a Project ID by Calling an API <#obtaining-a-project-id-by-calling-an-api>`__ + +Obtaining a Project ID and Name from the Console +------------------------------------------------ + +To do so, perform the following operations: + +#. Log in to the console. +#. In the upper right corner, click your account avatar icon and choose **My Settings** from the drop-down list. +#. On the **My Settings** page, go to the **Project List** tab page, which is displayed by default. View the project ID and name in the project list. + +Obtaining a Project ID by Calling an API +---------------------------------------- + +The API for obtaining a project ID is **GET https://**\ *{iam-endpoint}*\ **/v3/projects**. To obtain *{iam-endpoint}*, see `Request URI <../calling_apis/making_an_api_request.html#request-uri>`__\ `Endpoints <../before_you_start/endpoints.html>`__. + +The following is an example response. For example, if ModelArts is deployed in the **xxx** region, the value of **name** in the response body is **xxx**. The value of **id** in **projects** is the project ID. + +.. code-block:: + + { + "projects": [{ + "domain_id": "65382450e8f64ac0870cd180d14e684b", + "is_domain": false, + "parent_id": "65382450e8f64ac0870cd180d14e684b", + "name": "xxx", + "description": "", + "links": { + "next": null, + "previous": null, + "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" + }, + "id": "a4a5d4098fb4474fa22cd05f897d6b99", + "enabled": true + }], + "links": { + "next": null, + "previous": null, + "self": "https://www.example.com/v3/projects" + } + } + + diff --git a/api-ref/source/common_parameters/obtaining_a_username_and_id.rst b/api-ref/source/common_parameters/obtaining_a_username_and_id.rst new file mode 100644 index 0000000..827aeee --- /dev/null +++ b/api-ref/source/common_parameters/obtaining_a_username_and_id.rst @@ -0,0 +1,18 @@ +Obtaining a Username and ID +=========================== + +When you call APIs, certain requests require the username and ID. To obtain a username and ID, do as follows: + +#. Log in to the management console after registration. + +#. In the upper right corner, click your account avatar icon and choose **My Settings** from the drop-down list. + + On the **My Settings** page, view the username and ID. + + .. figure:: /_static/images/en-us_image_0000001126895190.png + :alt: **Figure 1** Viewing the username and ID + + + **Figure 1** Viewing the username and ID + + diff --git a/api-ref/source/common_parameters/obtaining_an_account_name_and_id.rst b/api-ref/source/common_parameters/obtaining_an_account_name_and_id.rst new file mode 100644 index 0000000..eb2ded3 --- /dev/null +++ b/api-ref/source/common_parameters/obtaining_an_account_name_and_id.rst @@ -0,0 +1,18 @@ +Obtaining an Account Name and ID +================================ + +When you call APIs, certain requests require the account name and ID. To obtain an account name and ID, do as follows: + +#. Sign up and log in to the console. + +#. Hover the cursor on the username and choose **My Credentials** from the drop-down list. + + On the **API Credentials** page, view the account name and ID. + + .. figure:: /_static/images/en-us_image_0000001126894914.png + :alt: **Figure 1** Viewing the account name and ID + + + **Figure 1** Viewing the account name and ID + + diff --git a/api-ref/source/common_parameters/status_code.rst b/api-ref/source/common_parameters/status_code.rst new file mode 100644 index 0000000..47afdfb --- /dev/null +++ b/api-ref/source/common_parameters/status_code.rst @@ -0,0 +1,124 @@ +Status Code +=========== + +`Table 1 <#modelarts030094enustopic0132773864table1450010510213>`__ describes the status codes. + + + +.. _modelarts030094enustopic0132773864table1450010510213: + +.. table:: **Table 1** Status codes + + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Status Code | Code | Status Code Description | + +=======================+=================================+===========================================================================================================================================================================================================================================================================================================================================================================================================+ + | 100 | Continue | The client continues sending the request. | + | | | | + | | | This provisional response informs the client that part of the request has been received and has not yet been rejected by the server. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 101 | Switching Protocols | Switching protocols. The target protocol must be more advanced than the source protocol. | + | | | | + | | | For example, the current HTTP protocol is switched to a later version of HTTP. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 200 | OK | The request has been fulfilled. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 201 | Created | The request for creating a resource has been fulfilled. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 202 | Accepted | The request has been accepted, but the processing has not been completed. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 203 | Non-Authoritative Information | Non-authoritative information. The request is successful. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 204 | NoContent | The request has been fulfilled, but the HTTP response does not contain a response body. | + | | | | + | | | The status code is returned in response to an HTTP OPTIONS request. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 205 | Reset Content | The server has fulfilled the request, but the requester is required to reset the content. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 206 | Partial Content | The server has successfully processed a part of the GET request. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 300 | Multiple Choices | There are multiple options for the location of the requested resource. The response contains a list of resource characteristics and addresses from which the user or user agent (such as a browser) can choose the most appropriate one. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 301 | Moved Permanently | The requested resource has been assigned a new permanent URI, and the new URI is contained in the response. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 302 | Found | The requested resource resides temporarily under a different URI. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 303 | See Other | The response to the request can be found under a different URI, | + | | | | + | | | and should be retrieved using a GET or POST method. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 304 | Not Modified | The requested resource has not been modified. When the server returns this status code, it does not return any resources. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 305 | Use Proxy | The requested resource must be accessed through a proxy. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 306 | Unused | The HTTP status code is no longer used. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 400 | BadRequest | The request is invalid. | + | | | | + | | | Do not retry the request before modification. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 401 | Unauthorized | The status code is returned after the client provides the authentication information, indicating that the authentication information is incorrect or invalid. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 402 | Payment Required | This status code is reserved for future use. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 403 | Forbidden | The request has been rejected. | + | | | | + | | | The server has received and understood the request; yet it refused to respond, because the request is set to deny access. Do not retry the request before modification. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 404 | NotFound | The requested resource cannot be found. | + | | | | + | | | Do not retry the request before modification. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 405 | MethodNotAllowed | The request contains one or more methods not supported for the resource. | + | | | | + | | | Do not retry the request before modification. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 406 | Not Acceptable | The server cannot fulfill the request according to the content characteristics of the request. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 407 | Proxy Authentication Required | This status code is similar to 401, but the client must first authenticate itself with the proxy. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 408 | Request Time-out | The request timed out. | + | | | | + | | | The client may repeat the request without modifications at any time later. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 409 | Conflict | The request could not be processed due to a conflict with the current state of the resource. | + | | | | + | | | This status code indicates that the resource that the client attempts to create already exits, or the requested update failed due to a conflict. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 410 | Gone | The requested resource is no longer available. | + | | | | + | | | The status code indicates that the requested resource has been deleted permanently. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 411 | Length Required | The server refuses to process the request without a defined **Content-Length**. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 412 | Precondition Failed | The server does not meet one of the preconditions that the requester puts on the request. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 413 | Request Entity Too Large | The request is larger than that a server is able to process. The server may close the connection to prevent the client from continuing the request. If the server cannot process the request temporarily, the response will contain a **Retry-After** header field. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 414 | Request-URI Too Large | The URI provided was too long for the server to process. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 415 | Unsupported Media Type | The server is unable to process the media format in the request. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 416 | Requested range not satisfiable | The requested range is invalid. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 417 | Expectation Failed | The server fails to meet the requirements of the **Expect** request-header field. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 422 | UnprocessableEntity | The request is well-formed but is unable to be processed due to semantic errors. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 429 | TooManyRequests | The client has sent excessive number of requests to the server within a given time (exceeding the limit on the access frequency of the client), or the server has received an excessive number of requests within a given time (beyond its processing capability). In this case, the client should resend the request after the time specified in the **Retry-After** header of the response has elapsed. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 500 | InternalServerError | The server is able to receive but unable to understand the request. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 501 | Not Implemented | The server does not support the requested function. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 502 | Bad Gateway | The server acting as a gateway or proxy has received an invalid request from a remote server. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 503 | ServiceUnavailable | The requested service is invalid. | + | | | | + | | | Do not retry the request before modification. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 504 | ServerTimeout | The request cannot be fulfilled within a given time. This status code is returned to the client only when the **Timeout** parameter is specified in the request. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | 505 | HTTP Version not supported | The server does not support the HTTP protocol version used in the request. | + +-----------------------+---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + diff --git a/api-ref/source/conf.py b/api-ref/source/conf.py new file mode 100644 index 0000000..9f1ea2d --- /dev/null +++ b/api-ref/source/conf.py @@ -0,0 +1,166 @@ +# Licensed under the Apache License, Version 2.0 (the "License"); you may +# not use this file except in compliance with the License. You may obtain +# a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations +# under the License. +# +import os +import sys + +extensions = [ + 'otc_api_ref', + 'otcdocstheme' +] + + +html_theme = 'otcdocs' +html_theme_options = { + "sidebar_mode": "toctree" +} +otcdocs_auto_name = False +project = 'ModelArts' +otcdocs_repo_name = 'opentelekomcloud-docs/modelarts' + + +# If extensions (or modules to document with autodoc) are in another directory, +# add these directories to sys.path here. If the directory is relative to the +# documentation root, use os.path.abspath to make it absolute, like shown here. +sys.path.insert(0, os.path.abspath('../../')) +sys.path.insert(0, os.path.abspath('../')) +sys.path.insert(0, os.path.abspath('./')) + +# -- General configuration ---------------------------------------------------- + +# Add any Sphinx extension module names here, as strings. They can be +# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones. + +# The suffix of source filenames. +source_suffix = '.rst' + +# The encoding of source files. +# +# source_encoding = 'utf-8' + +# The master toctree document. +master_doc = 'index' + +# General information about the project. +copyright = u'2022-present, Open Telekom Cloud' + +# The language for content autogenerated by Sphinx. Refer to documentation +# for a list of supported languages. +# +# language = None + +# There are two options for replacing |today|: either, you set today to some +# non-false value, then it is used: +# today = '' +# Else, today_fmt is used as the format for a strftime call. +# today_fmt = '%B %d, %Y' + +# The reST default role (used for this markup: `text`) to use +# for all documents. +# default_role = None + +# If true, '()' will be appended to :func: etc. cross-reference text. +# add_function_parentheses = True + +# If true, the current module name will be prepended to all description +# unit titles (such as .. function::). +add_module_names = False + +# If true, sectionauthor and moduleauthor directives will be shown in the +# output. They are ignored by default. +show_authors = False + +# The name of the Pygments (syntax highlighting) style to use. +pygments_style = 'native' + +# -- Options for man page output ---------------------------------------------- + +# Grouping the document tree for man pages. +# List of tuples 'sourcefile', 'target', u'title', u'Authors name', 'manual' + + +# -- Options for HTML output -------------------------------------------------- + +# The theme to use for HTML and HTML Help pages. Major themes that come with +# Sphinx are currently 'default' and 'sphinxdoc'. +# html_theme_path = ["."] +# html_theme = '_theme' + +# Theme options are theme-specific and customize the look and feel of a theme +# further. For a list of options available for each theme, see the +# documentation. +# html_theme_options = {} + +# Add any paths that contain custom themes here, relative to this directory. +# html_theme_path = [] + +# The name for this set of Sphinx documents. If None, it defaults to +# " v documentation". +# html_title = None + +# A shorter title for the navigation bar. Default is the same as html_title. +# html_short_title = None + +# The name of an image file (relative to this directory) to place at the top +# of the sidebar. +# html_logo = None + +# The name of an image file (within the static path) to use as favicon of the +# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 +# pixels large. +# html_favicon = None + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +# html_static_path = ['_static'] + +# If true, SmartyPants will be used to convert quotes and dashes to +# typographically correct entities. +# html_use_smartypants = True + +# Custom sidebar templates, maps document names to template names. +# html_sidebars = {} + +# Additional templates that should be rendered to pages, maps page names to +# template names. +# html_additional_pages = {} + +# If false, no module index is generated. +# html_use_modindex = True + +# If false, no index is generated. +# html_use_index = True + +# If true, the index is split into individual pages for each letter. +# html_split_index = False + +# If true, links to the reST sources are added to the pages. +# html_show_sourcelink = True + +# If true, an OpenSearch description file will be output, and all pages will +# contain a tag referring to it. The value of this option must be the +# base URL from which the finished HTML is served. +# html_use_opensearch = '' + +# If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml"). +# html_file_suffix = '' + +# Output file base name for HTML help builder. +htmlhelp_basename = 'madoc' + +latex_documents = [ + ('index', + 'api-ref-modelarts.tex', + u'%s API Reference Documentation' % project, + u'OpenTelekomCloud', 'manual'), +] diff --git a/api-ref/source/data_management/data_export_task/creating_a_dataset_export_task.rst b/api-ref/source/data_management/data_export_task/creating_a_dataset_export_task.rst new file mode 100644 index 0000000..67fdac9 --- /dev/null +++ b/api-ref/source/data_management/data_export_task/creating_a_dataset_export_task.rst @@ -0,0 +1,675 @@ +Creating a Dataset Export Task +============================== + +Function +-------- + +This API is used to create a dataset export task to export a dataset to OBS or new datasets. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/export-tasks + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _ExportTaskrequestExportReq: + +.. table:: **Table 2** Request body parameters + + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+=================+==========================================================+================================================================================================================================================================================================================================================================+ + | annotation_format | No | String | Labeling format. The options are as follows: | + | | | | | + | | | | - **VOC**: VOC | + | | | | | + | | | | - **COCO**: COCO | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | No | String | Dataset ID. | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_type | No | Integer | Dataset type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet | + | | | | | + | | | | - **200**: sound classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **400**: table dataset | + | | | | | + | | | | - **600**: video labeling | + | | | | | + | | | | - **900**: custom format | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_format | No | Integer | Format of the exported directory. The options are as follows: | + | | | | | + | | | | - **1**: tree structure. For example: cat/1.jpg,dog/2.jpg. | + | | | | | + | | | | - **2**: tile structure. For example: 1.jpg, 1.txt; 2.jpg,2.txt. | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_params | No | `ExportParams <#exporttaskrequestexportparams>`__ object | Parameters of a dataset export task. | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_type | No | Integer | Export type. The options are as follows: | + | | | | | + | | | | - **0**: labeled | + | | | | | + | | | | - **1**: unlabeled | + | | | | | + | | | | - **2**: all | + | | | | | + | | | | - **3**: conditional search | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | path | No | String | Export output path. | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | No | String | Sample status. The options are as follows: | + | | | | | + | | | | - **ALL**: labeled | + | | | | | + | | | | - **NONE**: unlabeled | + | | | | | + | | | | - **UNCHECK**: pending acceptance | + | | | | | + | | | | - **ACCEPTED**: accepted | + | | | | | + | | | | - **REJECTED**: rejected | + | | | | | + | | | | - **UNREVIEWED**: pending review | + | | | | | + | | | | - **REVIEWED**: reviewed | + | | | | | + | | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | | + | | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | | + | | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | | + | | | | - **AUTO_ANNOTATION**: to be confirmed | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_type_header | No | String | Prefix of the OBS path in the exported labeling file. The default value is **obs://**. You can set it to **s3://**. The image path starting with **obs** cannot be parsed during training. Set the path prefix in the exported **manifest** file to **s3://**. | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | No | Integer | Task status. | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | No | String | Task ID. | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_format | No | String | Format of a dataset version. The options are as follows: | + | | | | | + | | | | - **Default**: default format | + | | | | | + | | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | | + | | | | - **CSV**: CSV | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | No | String | Dataset version ID. | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | No | Boolean | Whether to write the column name in the first line of the CSV file during export. This field is valid for the table dataset. The options are as follows: | + | | | | | + | | | | - **true**: Write the column name in the first line of the CSV file. (Default value) | + | | | | | + | | | | - **false**: Do not write the column name in the first line of the CSV file. | + +--------------------+-----------------+----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ExportTaskrequestExportParams: + +.. table:: **Table 3** ExportParams + + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===============================+=================+==========================================================================+============================================================================================================================================================================+ + | clear_hard_property | No | Boolean | Whether to clear hard example attributes. The options are as follows: | + | | | | | + | | | | - **true**: Clear hard example attributes. (Default value) | + | | | | | + | | | | - **false**: Do not clear hard example attributes. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_format | No | String | Format of the dataset version to which data is exported. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_name | No | String | Name of the dataset version to which data is exported. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dest | No | String | Export destination. The options are as follows: | + | | | | | + | | | | - **DIR**: Export data to OBS. (Default value) | + | | | | | + | | | | - **NEW_DATASET**: Export data to a new dataset. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_name | No | String | Name of the new dataset to which data is exported. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_work_path | No | String | Working directory of the new dataset to which data is exported. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ratio_sample_usage | No | Boolean | Whether to randomly allocate the training set and validation set based on the specified ratio. The options are as follows: | + | | | | | + | | | | - **true**: Allocate the training set and validation set. | + | | | | | + | | | | - **false**: Do not allocate the training set and validation set. (Default value) | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | No | String | Sample status. The options are as follows: | + | | | | | + | | | | - **ALL**: labeled | + | | | | | + | | | | - **NONE**: unlabeled | + | | | | | + | | | | - **UNCHECK**: pending acceptance | + | | | | | + | | | | - **ACCEPTED**: accepted | + | | | | | + | | | | - **REJECTED**: rejected | + | | | | | + | | | | - **UNREVIEWED**: pending review | + | | | | | + | | | | - **REVIEWED**: reviewed | + | | | | | + | | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | | + | | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | | + | | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | | + | | | | - **AUTO_ANNOTATION**: to be confirmed | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | No | Array of strings | ID list of exported samples. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_conditions | No | Array of `SearchCondition <#exporttaskrequestsearchcondition>`__ objects | Exported search conditions. The relationship between multiple search conditions is OR. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_sample_ratio | No | String | Split ratio of training set and verification set during specified version release. The default value is **1.00**, indicating that all released versions are training sets. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ExportTaskrequestSearchCondition: + +.. table:: **Table 4** SearchCondition + + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==================+=================+==========================================================+==================================================================================================================================================================================================================================================================+ + | coefficient | No | String | Filter by coefficient of difficulty. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | frame_in_video | No | Integer | A frame in the video. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | hard | No | String | Whether a sample is a hard sample. The options are as follows: | + | | | | | + | | | | - **0**: non-hard sample | + | | | | | + | | | | - **1**: hard sample | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_origin | No | String | Filter by data source. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | kvp | No | String | CT dosage, filtered by dosage. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_list | No | `SearchLabels <#exporttaskrequestsearchlabels>`__ object | Label search criteria. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labeler | No | String | Labeler. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | No | `SearchProp <#exporttaskrequestsearchprop>`__ object | Search by sample attribute. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parent_sample_id | No | String | Parent sample ID. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | No | String | Directory where data samples are stored (the directory must end with a slash (/)). Only samples in the specified directory are searched for. Recursive search of directories is not supported. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | No | String | Search by sample name, including the file name extension. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | No | String | When a sample is added to the dataset, an index is created based on the last modification time (accurate to day) of the sample on OBS. You can search for the sample based on the time. The options are as follows: | + | | | | | + | | | | - **month**: Search for samples added from 30 days ago to the current day. | + | | | | | + | | | | - **day**: Search for samples added from yesterday (one day ago) to the current day. | + | | | | | + | | | | - **yyyyMMdd-yyyyMMdd**: Search for samples added in a specified period (at most 30 days), in the format of **Start date-End date**. For example, **20190901-2019091501** indicates that samples generated from September 1 to September 15, 2019 are searched. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | score | No | String | Search by confidence. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | slice_thickness | No | String | DICOM layer thickness. Samples are filtered by layer thickness. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | study_date | No | String | DICOM scanning time. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time_in_video | No | String | A time point in the video. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ExportTaskrequestSearchLabels: + +.. table:: **Table 5** SearchLabels + + +-----------------+-----------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+==================================================================+==============================================================================================================================================================+ + | labels | No | Array of `SearchLabel <#exporttaskrequestsearchlabel>`__ objects | List of label search criteria. | + +-----------------+-----------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | No | String | If you want to search for multiple labels, **op** must be specified. If you search for only one label, **op** can be left blank. The options are as follows: | + | | | | | + | | | | - **OR**: OR operation | + | | | | | + | | | | - **AND**: AND operation | + +-----------------+-----------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ExportTaskrequestSearchLabel: + +.. table:: **Table 6** SearchLabel + + +-----------------+-----------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===========================+========================================================================================================================================================================================================================================================================================+ + | name | No | String | Label name. | + +-----------------+-----------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | No | String | Operation type between multiple attributes. The options are as follows: | + | | | | | + | | | | - **OR**: OR operation | + | | | | | + | | | | - **AND**: AND operation | + +-----------------+-----------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | No | Map> | Label attribute, which is in the Object format and stores any key-value pairs. **key** indicates the attribute name, and **value** indicates the value list. If **value** is **null**, the search is not performed by value. Otherwise, the search value can be any value in the list. | + +-----------------+-----------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ExportTaskrequestSearchProp: + +.. table:: **Table 7** SearchProp + + +-----------------+-----------------+---------------------------+-----------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===========================+=======================================================================+ + | op | No | String | Relationship between attribute values. The options are as follows: | + | | | | | + | | | | - **AND**: AND relationship | + | | | | | + | | | | - **OR**: OR relationship | + +-----------------+-----------------+---------------------------+-----------------------------------------------------------------------+ + | props | No | Map> | Search criteria of an attribute. Multiple search criteria can be set. | + +-----------------+-----------------+---------------------------+-----------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ExportTaskresponseExportResp: + +.. table:: **Table 8** Response body parameters + + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================================================+===================================================================+ + | create_time | Long | Time when a task is created. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | error_code | String | Error code. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | export_format | Integer | Format of the exported directory. The options are as follows: | + | | | | + | | | - **1**: tree structure. For example: cat/1.jpg,dog/2.jpg. | + | | | | + | | | - **2**: tile structure. For example: 1.jpg, 1.txt; 2.jpg,2.txt. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | export_params | `ExportParams <#exporttaskresponseexportparams>`__ object | Parameters of a dataset export task. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | export_type | Integer | Export type. The options are as follows: | + | | | | + | | | - **0**: labeled | + | | | | + | | | - **1**: unlabeled | + | | | | + | | | - **2**: all | + | | | | + | | | - **3**: conditional search | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | finished_sample_count | Integer | Number of completed samples. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | path | String | Export output path. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | progress | Float | Percentage of current task progress. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | status | String | Task status. The options are as follows: | + | | | | + | | | - **INIT**: initialized | + | | | | + | | | - **RUNNING**: running | + | | | | + | | | - **FAILED**: failed | + | | | | + | | | - **SUCCESSED**: completed | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | task_id | String | Task ID. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of samples. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | update_time | Long | Time when a task is updated. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | version_format | String | Format of a dataset version. The options are as follows: | + | | | | + | | | - **Default**: default format | + | | | | + | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | + | | | - **CSV**: CSV | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + | version_id | String | Dataset version ID. | + +-----------------------+-----------------------------------------------------------+-------------------------------------------------------------------+ + + + +.. _ExportTaskresponseExportParams: + +.. table:: **Table 9** ExportParams + + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===============================+===========================================================================+============================================================================================================================================================================+ + | clear_hard_property | Boolean | Whether to clear hard example attributes. The options are as follows: | + | | | | + | | | - **true**: Clear hard example attributes. (Default value) | + | | | | + | | | - **false**: Do not clear hard example attributes. | + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_format | String | Format of the dataset version to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_name | String | Name of the dataset version to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dest | String | Export destination. The options are as follows: | + | | | | + | | | - **DIR**: Export data to OBS. (Default value) | + | | | | + | | | - **NEW_DATASET**: Export data to a new dataset. | + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_name | String | Name of the new dataset to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_work_path | String | Working directory of the new dataset to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ratio_sample_usage | Boolean | Whether to randomly allocate the training set and validation set based on the specified ratio. The options are as follows: | + | | | | + | | | - **true**: Allocate the training set and validation set. | + | | | | + | | | - **false**: Do not allocate the training set and validation set. (Default value) | + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | Array of strings | ID list of exported samples. | + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_conditions | Array of `SearchCondition <#exporttaskresponsesearchcondition>`__ objects | Exported search conditions. The relationship between multiple search conditions is OR. | + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_sample_ratio | String | Split ratio of training set and verification set during specified version release. The default value is **1.00**, indicating that all released versions are training sets. | + +-------------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ExportTaskresponseSearchCondition: + +.. table:: **Table 10** SearchCondition + + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================================================+==================================================================================================================================================================================================================================================================+ + | coefficient | String | Filter by coefficient of difficulty. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | frame_in_video | Integer | A frame in the video. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | hard | String | Whether a sample is a hard sample. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_origin | String | Filter by data source. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | kvp | String | CT dosage, filtered by dosage. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_list | `SearchLabels <#exporttaskresponsesearchlabels>`__ object | Label search criteria. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labeler | String | Labeler. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SearchProp <#exporttaskresponsesearchprop>`__ object | Search by sample attribute. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parent_sample_id | String | Parent sample ID. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Directory where data samples are stored (the directory must end with a slash (/)). Only samples in the specified directory are searched for. Recursive search of directories is not supported. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Search by sample name, including the file name extension. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | String | When a sample is added to the dataset, an index is created based on the last modification time (accurate to day) of the sample on OBS. You can search for the sample based on the time. The options are as follows: | + | | | | + | | | - **month**: Search for samples added from 30 days ago to the current day. | + | | | | + | | | - **day**: Search for samples added from yesterday (one day ago) to the current day. | + | | | | + | | | - **yyyyMMdd-yyyyMMdd**: Search for samples added in a specified period (at most 30 days), in the format of **Start date-End date**. For example, **20190901-2019091501** indicates that samples generated from September 1 to September 15, 2019 are searched. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Search by confidence. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | slice_thickness | String | DICOM layer thickness. Samples are filtered by layer thickness. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | study_date | String | DICOM scanning time. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time_in_video | String | A time point in the video. | + +-----------------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ExportTaskresponseSearchLabels: + +.. table:: **Table 11** SearchLabels + + +-----------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===================================================================+==============================================================================================================================================================+ + | labels | Array of `SearchLabel <#exporttaskresponsesearchlabel>`__ objects | List of label search criteria. | + +-----------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | If you want to search for multiple labels, **op** must be specified. If you search for only one label, **op** can be left blank. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ExportTaskresponseSearchLabel: + +.. table:: **Table 12** SearchLabel + + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+========================================================================================================================================================================================================================================================================================+ + | name | String | Label name. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | Operation type between multiple attributes. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | Map> | Label attribute, which is in the Object format and stores any key-value pairs. **key** indicates the attribute name, and **value** indicates the value list. If **value** is **null**, the search is not performed by value. Otherwise, the search value can be any value in the list. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ExportTaskresponseSearchProp: + +.. table:: **Table 13** SearchProp + + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+=======================================================================+ + | op | String | Relationship between attribute values. The options are as follows: | + | | | | + | | | - **AND**: AND relationship | + | | | | + | | | - **OR**: OR relationship | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | props | Map> | Search criteria of an attribute. Multiple search criteria can be set. | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + +Example Requests +---------------- + +- Creating an Export Task (Exporting Data to OBS) + + .. code-block:: + + { + "path" : "/test-obs/daoChu/", + "export_type" : 3, + "export_params" : { + "sample_state" : "", + "export_dest" : "DIR" + } + } + +- Creating an Export Task (Exporting Data to a New Dataset) + + .. code-block:: + + { + "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/" + } + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "task_id" : "rF9NNoB56k5rtYKg2Y7" + } + +Status Codes +------------ + + + +.. _ExportTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/data_export_task/index.rst b/api-ref/source/data_management/data_export_task/index.rst new file mode 100644 index 0000000..40b8740 --- /dev/null +++ b/api-ref/source/data_management/data_export_task/index.rst @@ -0,0 +1,10 @@ +================ +Data Export Task +================ + +.. toctree:: + :maxdepth: 1 + + querying_the_dataset_export_task_list + creating_a_dataset_export_task + querying_the_status_of_a_dataset_export_task diff --git a/api-ref/source/data_management/data_export_task/querying_the_dataset_export_task_list.rst b/api-ref/source/data_management/data_export_task/querying_the_dataset_export_task_list.rst new file mode 100644 index 0000000..453aefa --- /dev/null +++ b/api-ref/source/data_management/data_export_task/querying_the_dataset_export_task_list.rst @@ -0,0 +1,460 @@ +Querying the Dataset Export Task List +===================================== + +Function +-------- + +This API is used to query the dataset export task list by page. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/export-tasks + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+================================================================================================================================+ + | export_type | No | Integer | Export type. If this parameter is not specified, all types of export tasks are queried by default. The options are as follows: | + | | | | | + | | | | - **0**: labeled | + | | | | | + | | | | - **1**: unlabeled | + | | | | | + | | | | - **2**: all | + | | | | | + | | | | - **3**: conditional search | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _GetExportTasksStatusOfDatasetresponseExportTasksStatusResp: + +.. table:: **Table 3** Response body parameters + + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+========================================================================================================+===================================================================+ + | create_time | Long | Time when a task is created. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | error_code | String | Error code. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | export_format | Integer | Format of the exported directory. The options are as follows: | + | | | | + | | | - **1**: tree structure. For example: cat/1.jpg,dog/2.jpg. | + | | | | + | | | - **2**: tile structure. For example: 1.jpg, 1.txt; 2.jpg,2.txt. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | export_params | `ExportParams <#getexporttasksstatusofdatasetresponseexportparams>`__ object | Parameters of a dataset export task. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | export_tasks | Array of `ExportTaskStatusResp <#getexporttasksstatusofdatasetresponseexporttaskstatusresp>`__ objects | Export task list | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | export_type | Integer | Export type. The options are as follows: | + | | | | + | | | - **0**: labeled | + | | | | + | | | - **1**: unlabeled | + | | | | + | | | - **2**: all | + | | | | + | | | - **3**: conditional search | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | finished_sample_count | Integer | Number of completed samples. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | path | String | Export output path. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | progress | Float | Percentage of current task progress. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | status | String | Task status. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | task_id | String | Task ID. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | total_count | Integer | Total number of export tasks | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of samples. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | update_time | Long | Time when a task is updated. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | version_format | String | Format of a dataset version. The options are as follows: | + | | | | + | | | - **Default**: default format | + | | | | + | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | + | | | - **CSV**: CSV | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | version_id | String | Dataset version ID. | + +-----------------------+--------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + + + +.. _GetExportTasksStatusOfDatasetresponseExportParams: + +.. table:: **Table 4** ExportParams + + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===============================+==============================================================================================+============================================================================================================================================================================+ + | clear_hard_property | Boolean | Whether to clear hard example attributes. The options are as follows: | + | | | | + | | | - **true**: Clear hard example attributes. (Default value) | + | | | | + | | | - **false**: Do not clear hard example attributes. | + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_format | String | Format of the dataset version to which data is exported. | + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_name | String | Name of the dataset version to which data is exported. | + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dest | String | Export destination. The options are as follows: | + | | | | + | | | - **DIR**: Export data to OBS. (Default value) | + | | | | + | | | - **NEW_DATASET**: Export data to a new dataset. | + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_name | String | Name of the new dataset to which data is exported. | + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_work_path | String | Working directory of the new dataset to which data is exported. | + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ratio_sample_usage | Boolean | Whether to randomly allocate the training set and validation set based on the specified ratio. The options are as follows: | + | | | | + | | | - **true**: Allocate the training set and validation set. | + | | | | + | | | - **false**: Do not allocate the training set and validation set. (Default value) | + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | Array of strings | ID list of exported samples. | + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_conditions | Array of `SearchCondition <#getexporttasksstatusofdatasetresponsesearchcondition>`__ objects | Exported search conditions. The relationship between multiple search conditions is OR. | + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_sample_ratio | String | Split ratio of training set and verification set during specified version release. The default value is **1.00**, indicating that all released versions are training sets. | + +-------------------------------+----------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _GetExportTasksStatusOfDatasetresponseExportTaskStatusResp: + +.. table:: **Table 5** ExportTaskStatusResp + + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==============================================================================+===================================================================+ + | create_time | Long | Time when a task is created. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | error_code | String | Error code. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | export_format | Integer | Format of the exported directory. The options are as follows: | + | | | | + | | | - **1**: tree structure. For example: cat/1.jpg,dog/2.jpg. | + | | | | + | | | - **2**: tile structure. For example: 1.jpg, 1.txt; 2.jpg,2.txt. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | export_params | `ExportParams <#getexporttasksstatusofdatasetresponseexportparams>`__ object | Parameters of a dataset export task. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | export_type | Integer | Export type. The options are as follows: | + | | | | + | | | - **0**: labeled | + | | | | + | | | - **1**: unlabeled | + | | | | + | | | - **2**: all | + | | | | + | | | - **3**: conditional search | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | finished_sample_count | Integer | Number of completed samples. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | path | String | Export output path. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | progress | Float | Percentage of current task progress. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | status | String | Task status. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | task_id | String | Task ID. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of samples. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | update_time | Long | Time when a task is updated. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | version_format | String | Format of a dataset version. The options are as follows: | + | | | | + | | | - **Default**: default format | + | | | | + | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | + | | | - **CSV**: CSV | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | version_id | String | Dataset version ID. | + +-----------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------+ + + + +.. _GetExportTasksStatusOfDatasetresponseSearchCondition: + +.. table:: **Table 6** SearchCondition + + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==============================================================================+==================================================================================================================================================================================================================================================================+ + | coefficient | String | Filter by coefficient of difficulty. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | frame_in_video | Integer | A frame in the video. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | hard | String | Whether a sample is a hard sample. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_origin | String | Filter by data source. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | kvp | String | CT dosage, filtered by dosage. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_list | `SearchLabels <#getexporttasksstatusofdatasetresponsesearchlabels>`__ object | Label search criteria. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labeler | String | Labeler. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SearchProp <#getexporttasksstatusofdatasetresponsesearchprop>`__ object | Search by sample attribute. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parent_sample_id | String | Parent sample ID. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Directory where data samples are stored (the directory must end with a slash (/)). Only samples in the specified directory are searched for. Recursive search of directories is not supported. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Search by sample name, including the file name extension. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | String | When a sample is added to the dataset, an index is created based on the last modification time (accurate to day) of the sample on OBS. You can search for the sample based on the time. The options are as follows: | + | | | | + | | | - **month**: Search for samples added from 30 days ago to the current day. | + | | | | + | | | - **day**: Search for samples added from yesterday (one day ago) to the current day. | + | | | | + | | | - **yyyyMMdd-yyyyMMdd**: Search for samples added in a specified period (at most 30 days), in the format of **Start date-End date**. For example, **20190901-2019091501** indicates that samples generated from September 1 to September 15, 2019 are searched. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Search by confidence. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | slice_thickness | String | DICOM layer thickness. Samples are filtered by layer thickness. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | study_date | String | DICOM scanning time. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time_in_video | String | A time point in the video. | + +-----------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _GetExportTasksStatusOfDatasetresponseSearchLabels: + +.. table:: **Table 7** SearchLabels + + +-----------------------+--------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+======================================================================================+==============================================================================================================================================================+ + | labels | Array of `SearchLabel <#getexporttasksstatusofdatasetresponsesearchlabel>`__ objects | List of label search criteria. | + +-----------------------+--------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | If you want to search for multiple labels, **op** must be specified. If you search for only one label, **op** can be left blank. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+--------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _GetExportTasksStatusOfDatasetresponseSearchLabel: + +.. table:: **Table 8** SearchLabel + + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+========================================================================================================================================================================================================================================================================================+ + | name | String | Label name. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | Operation type between multiple attributes. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | Map> | Label attribute, which is in the Object format and stores any key-value pairs. **key** indicates the attribute name, and **value** indicates the value list. If **value** is **null**, the search is not performed by value. Otherwise, the search value can be any value in the list. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _GetExportTasksStatusOfDatasetresponseSearchProp: + +.. table:: **Table 9** SearchProp + + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+=======================================================================+ + | op | String | Relationship between attribute values. The options are as follows: | + | | | | + | | | - **AND**: AND relationship | + | | | | + | | | - **OR**: OR relationship | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | props | Map> | Search criteria of an attribute. Multiple search criteria can be set. | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the Export Task List by Page + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/export-tasks + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "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, + "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" : 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 + } ] + } + +Status Codes +------------ + + + +.. _GetExportTasksStatusOfDatasetstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/data_export_task/querying_the_status_of_a_dataset_export_task.rst b/api-ref/source/data_management/data_export_task/querying_the_status_of_a_dataset_export_task.rst new file mode 100644 index 0000000..e1d609d --- /dev/null +++ b/api-ref/source/data_management/data_export_task/querying_the_status_of_a_dataset_export_task.rst @@ -0,0 +1,353 @@ +Querying the Status of a Dataset Export Task +============================================ + +Function +-------- + +This API is used to query the status of a dataset export task. + +URI +--- + +GET /v2/{project_id}/datasets/{resource_id}/export-tasks/{task_id} + +.. table:: **Table 1** Path parameters + + +-------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource_id | Yes | String | Resource ID. Currently, the dataset ID can be specified. | + +-------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | ID of an export task. | + +-------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _GetExportTaskStatusOfDatasetresponseExportTaskStatusResp: + +.. table:: **Table 2** Response body parameters + + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=============================================================================+===================================================================+ + | create_time | Long | Time when a task is created. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | error_code | String | Error code. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | export_format | Integer | Format of the exported directory. The options are as follows: | + | | | | + | | | - **1**: tree structure. For example: cat/1.jpg,dog/2.jpg. | + | | | | + | | | - **2**: tile structure. For example: 1.jpg, 1.txt; 2.jpg,2.txt. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | export_params | `ExportParams <#getexporttaskstatusofdatasetresponseexportparams>`__ object | Parameters of a dataset export task. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | export_type | Integer | Export type. The options are as follows: | + | | | | + | | | - **0**: labeled | + | | | | + | | | - **1**: unlabeled | + | | | | + | | | - **2**: all | + | | | | + | | | - **3**: conditional search | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | finished_sample_count | Integer | Number of completed samples. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | path | String | Export output path. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | progress | Float | Percentage of current task progress. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | status | String | Task status. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | task_id | String | Task ID. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of samples. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | update_time | Long | Time when a task is updated. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | version_format | String | Format of a dataset version. The options are as follows: | + | | | | + | | | - **Default**: default format | + | | | | + | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | + | | | - **CSV**: CSV | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + | version_id | String | Dataset version ID. | + +-----------------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------+ + + + +.. _GetExportTaskStatusOfDatasetresponseExportParams: + +.. table:: **Table 3** ExportParams + + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===============================+=============================================================================================+============================================================================================================================================================================+ + | clear_hard_property | Boolean | Whether to clear hard example attributes. The options are as follows: | + | | | | + | | | - **true**: Clear hard example attributes. (Default value) | + | | | | + | | | - **false**: Do not clear hard example attributes. | + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_format | String | Format of the dataset version to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_name | String | Name of the dataset version to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dest | String | Export destination. The options are as follows: | + | | | | + | | | - **DIR**: Export data to OBS. (Default value) | + | | | | + | | | - **NEW_DATASET**: Export data to a new dataset. | + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_name | String | Name of the new dataset to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_work_path | String | Working directory of the new dataset to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ratio_sample_usage | Boolean | Whether to randomly allocate the training set and validation set based on the specified ratio. The options are as follows: | + | | | | + | | | - **true**: Allocate the training set and validation set. | + | | | | + | | | - **false**: Do not allocate the training set and validation set. (Default value) | + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | Array of strings | ID list of exported samples. | + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_conditions | Array of `SearchCondition <#getexporttaskstatusofdatasetresponsesearchcondition>`__ objects | Exported search conditions. The relationship between multiple search conditions is OR. | + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_sample_ratio | String | Split ratio of training set and verification set during specified version release. The default value is **1.00**, indicating that all released versions are training sets. | + +-------------------------------+---------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _GetExportTaskStatusOfDatasetresponseSearchCondition: + +.. table:: **Table 4** SearchCondition + + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=============================================================================+==================================================================================================================================================================================================================================================================+ + | coefficient | String | Filter by coefficient of difficulty. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | frame_in_video | Integer | A frame in the video. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | hard | String | Whether a sample is a hard sample. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_origin | String | Filter by data source. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | kvp | String | CT dosage, filtered by dosage. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_list | `SearchLabels <#getexporttaskstatusofdatasetresponsesearchlabels>`__ object | Label search criteria. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labeler | String | Labeler. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SearchProp <#getexporttaskstatusofdatasetresponsesearchprop>`__ object | Search by sample attribute. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parent_sample_id | String | Parent sample ID. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Directory where data samples are stored (the directory must end with a slash (/)). Only samples in the specified directory are searched for. Recursive search of directories is not supported. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Search by sample name, including the file name extension. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | String | When a sample is added to the dataset, an index is created based on the last modification time (accurate to day) of the sample on OBS. You can search for the sample based on the time. The options are as follows: | + | | | | + | | | - **month**: Search for samples added from 30 days ago to the current day. | + | | | | + | | | - **day**: Search for samples added from yesterday (one day ago) to the current day. | + | | | | + | | | - **yyyyMMdd-yyyyMMdd**: Search for samples added in a specified period (at most 30 days), in the format of **Start date-End date**. For example, **20190901-2019091501** indicates that samples generated from September 1 to September 15, 2019 are searched. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Search by confidence. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | slice_thickness | String | DICOM layer thickness. Samples are filtered by layer thickness. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | study_date | String | DICOM scanning time. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time_in_video | String | A time point in the video. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _GetExportTaskStatusOfDatasetresponseSearchLabels: + +.. table:: **Table 5** SearchLabels + + +-----------------------+-------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=====================================================================================+==============================================================================================================================================================+ + | labels | Array of `SearchLabel <#getexporttaskstatusofdatasetresponsesearchlabel>`__ objects | List of label search criteria. | + +-----------------------+-------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | If you want to search for multiple labels, **op** must be specified. If you search for only one label, **op** can be left blank. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+-------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _GetExportTaskStatusOfDatasetresponseSearchLabel: + +.. table:: **Table 6** SearchLabel + + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+========================================================================================================================================================================================================================================================================================+ + | name | String | Label name. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | Operation type between multiple attributes. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | Map> | Label attribute, which is in the Object format and stores any key-value pairs. **key** indicates the attribute name, and **value** indicates the value list. If **value** is **null**, the search is not performed by value. Otherwise, the search value can be any value in the list. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _GetExportTaskStatusOfDatasetresponseSearchProp: + +.. table:: **Table 7** SearchProp + + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+=======================================================================+ + | op | String | Relationship between attribute values. The options are as follows: | + | | | | + | | | - **AND**: AND relationship | + | | | | + | | | - **OR**: OR relationship | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | props | Map> | Search criteria of an attribute. Multiple search criteria can be set. | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the Status of an Export Task (Exporting Data to OBS) + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/export-tasks/{task_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "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" : "RUNNING", + "progress" : 0.0, + "create_time" : 1606103424662, + "update_time" : 1606103494124 + } + +Status Codes +------------ + + + +.. _GetExportTaskStatusOfDatasetstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/data_import_task/creating_an_import_task.rst b/api-ref/source/data_management/data_import_task/creating_an_import_task.rst new file mode 100644 index 0000000..84cf842 --- /dev/null +++ b/api-ref/source/data_management/data_import_task/creating_an_import_task.rst @@ -0,0 +1,409 @@ +Creating an Import Task +======================= + +Function +-------- + +This API is used to create a dataset import task to import samples and labels from the storage system to the dataset. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/import-tasks + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _ImportTaskrequestImportReq: + +.. table:: **Table 2** Request body parameters + + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+=================+========================================================+=================================================================================================================================================================================================================================+ + | annotation_format | No | String | Format of the labeling information. Currently, only object detection is supported. The options are as follows: | + | | | | | + | | | | - **VOC**: VOC | + | | | | | + | | | | - **COCO**: COCO | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | No | `DataSource <#importtaskrequestdatasource>`__ object | Data source. | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | difficult_only | No | Boolean | Whether to import only hard examples. The options are as follows: | + | | | | | + | | | | - **true**: Only difficult samples are imported. | + | | | | | + | | | | - **false**: All samples are imported. (Default value) | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | excluded_labels | No | Array of `Label <#importtaskrequestlabel>`__ objects | Do not import samples containing the specified label. | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | final_annotation | No | Boolean | Whether to import data to the final state. The options are as follows: | + | | | | | + | | | | - **true**: Import data to the final state. (Default value) | + | | | | | + | | | | - **false**: Do not import data to the final state. | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_annotations | No | Boolean | Whether to import labels. The options are as follows: | + | | | | | + | | | | - **true**: Import labels. (Default value) | + | | | | | + | | | | - **false**: Do not import labels. | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_folder | No | String | Name of the subdirectory in the dataset storage directory after import. You can specify the same subdirectory for multiple import tasks to avoid repeated import of the same samples. This field is invalid for table datasets. | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_origin | No | String | Data source. The options are as follows: | + | | | | | + | | | | - **obs**: OBS bucket (default value) | + | | | | | + | | | | - **dws**: GaussDB(DWS) | + | | | | | + | | | | - **dli**: DLI | + | | | | | + | | | | - **rds**: RDS | + | | | | | + | | | | - **mrs**: MRS | + | | | | | + | | | | - **inference**: Inference service | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_path | No | String | OBS path or **manifest** path to be imported. | + | | | | | + | | | | - When importing a manifest file, ensure that the path is accurate to the manifest file. | + | | | | | + | | | | - When a path is imported as a directory, the dataset type can only support image classification, object detection, text classification, or sound classification. | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_samples | No | Boolean | Whether to import samples. The options are as follows: | + | | | | | + | | | | - **true**: Import samples. (Default value) | + | | | | | + | | | | - **false**: Do not import samples. | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_type | No | String | Import mode. The options are as follows: | + | | | | | + | | | | - **0**: Import by directory. | + | | | | | + | | | | - **1**: Import by manifest file. | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | included_labels | No | Array of `Label <#importtaskrequestlabel>`__ objects | Import samples containing the specified label. | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_format | No | `LabelFormat <#importtaskrequestlabelformat>`__ object | Label format. This parameter is used only for text datasets. | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | No | Boolean | Whether the first row in the file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | | + | | | | - **true**: The first row in the file is the column name. | + | | | | | + | | | | - **false**: The first row in the file is not the column name. (Default value) | + +--------------------+-----------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ImportTaskrequestDataSource: + +.. table:: **Table 3** DataSource + + +--------------------+-----------------+--------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+=================+==============================================================+============================================================================================================================+ + | data_path | No | String | Data source path. | + +--------------------+-----------------+--------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | data_type | No | Integer | Data type. The options are as follows: | + | | | | | + | | | | - **0**: OBS bucket (default value) | + | | | | | + | | | | - **1**: GaussDB(DWS) | + | | | | | + | | | | - **2**: DLI | + | | | | | + | | | | - **3**: RDS | + | | | | | + | | | | - **4**: MRS | + | | | | | + | | | | - **5**: AI Gallery | + | | | | | + | | | | - **6**: Inference service | + +--------------------+-----------------+--------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | schema_maps | No | Array of `SchemaMap <#importtaskrequestschemamap>`__ objects | Schema mapping information corresponding to the table data. | + +--------------------+-----------------+--------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | source_info | No | `SourceInfo <#importtaskrequestsourceinfo>`__ object | Information required for importing a table data source. | + +--------------------+-----------------+--------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | No | Boolean | Whether the first row in the file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | | + | | | | - **true**: The first row in the file is the column name. | + | | | | | + | | | | - **false**: The first row in the file is not the column name. | + +--------------------+-----------------+--------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ImportTaskrequestSchemaMap: + +.. table:: **Table 4** SchemaMap + + ========= ========= ====== =============================== + Parameter Mandatory Type Description + ========= ========= ====== =============================== + dest_name No String Name of the destination column. + src_name No String Name of the source column. + ========= ========= ====== =============================== + + + +.. _ImportTaskrequestSourceInfo: + +.. table:: **Table 5** SourceInfo + + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==============================================================+ + | cluster_id | No | String | ID of an MRS cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | cluster_mode | No | String | Running mode of an MRS cluster. The options are as follows: | + | | | | | + | | | | - **0**: normal cluster | + | | | | | + | | | | - **1**: security cluster | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | cluster_name | No | String | Name of an MRS cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | database_name | No | String | Name of the database to which the table dataset is imported. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | input | No | String | HDFS path of a table dataset. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | ip | No | String | IP address of your GaussDB(DWS) cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | port | No | String | Port number of your GaussDB(DWS) cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | queue_name | No | String | DLI queue name of a table dataset. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | subnet_id | No | String | Subnet ID of an MRS cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | table_name | No | String | Name of the table to which a table dataset is imported. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | user_name | No | String | Username, which is mandatory for GaussDB(DWS) data. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | user_password | No | String | User password, which is mandatory for GaussDB(DWS) data. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | vpc_id | No | String | ID of the VPC where an MRS cluster resides. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + + + +.. _ImportTaskrequestLabel: + +.. table:: **Table 6** Label + + +-----------------+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+========================================================================+==================================================================================================================================+ + | attributes | No | Array of `LabelAttribute <#importtaskrequestlabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Label name. | + +-----------------+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | No | `LabelProperty <#importtaskrequestlabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ImportTaskrequestLabelAttribute: + +.. table:: **Table 7** LabelAttribute + + +-----------------+-----------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+==================================================================================+===================================================+ + | default_value | No | String | Default value of a label attribute. | + +-----------------+-----------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + | id | No | String | Label attribute ID. | + +-----------------+-----------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + | name | No | String | Label attribute name. | + +-----------------+-----------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + | type | No | String | Label attribute type. The options are as follows: | + | | | | | + | | | | - **text**: text | + | | | | | + | | | | - **select**: single-choice drop-down list | + +-----------------+-----------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + | values | No | Array of `LabelAttributeValue <#importtaskrequestlabelattributevalue>`__ objects | List of label attribute values. | + +-----------------+-----------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _ImportTaskrequestLabelAttributeValue: + +.. table:: **Table 8** LabelAttributeValue + + ========= ========= ====== ========================= + Parameter Mandatory Type Description + ========= ========= ====== ========================= + id No String Label attribute value ID. + value No String Label attribute value. + ========= ========= ====== ========================= + + + +.. _ImportTaskrequestLabelProperty: + +.. table:: **Table 9** LabelProperty + + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==========================+=================+=================+================================================================================================================================================================================================================+ + | @modelarts:color | No | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | No | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | | + | | | | - **bndbox**: rectangle | + | | | | | + | | | | - **polygon**: polygon | + | | | | | + | | | | - **circle**: circle | + | | | | | + | | | | - **line**: straight line | + | | | | | + | | | | - **dashed**: dotted line | + | | | | | + | | | | - **point**: point | + | | | | | + | | | | - **polyline**: polyline | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | No | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | No | String | Default attribute: The new name of the label. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | No | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | No | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ImportTaskrequestLabelFormat: + +.. table:: **Table 10** LabelFormat + + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=======================+=================+=================+=========================================================================================================================================================================================================================================================================+ + | label_type | No | String | Label type of text classification. The options are as follows: | + | | | | | + | | | | - **0**: The label is separated from the text, and they are distinguished by the fixed suffix **\_result**. For example, the text file is **abc.txt**, and the label file is **abc_result.txt**. | + | | | | | + | | | | - **1**: Default value. Labels and texts are stored in the same file and separated by separators. You can use **text_sample_separator** to specify the separator between the text and label and **text_label_separator** to specify the separator between labels. | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | text_label_separator | No | String | Separator between labels. By default, the comma (,) is used as the separator. The separator needs to be escaped. Only one character can be used as the separator. The value must contain letters, digits, and one special character (!@#$%^&*_=|?/':.;,). | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | text_sample_separator | No | String | Separator between the text and label. By default, the **Tab** key is used as the separator. The separator needs to be escaped. Only one character can be used as the separator. The value must contain letters, digits, and one special character (!@#$%^&*_=|?/':.;,). | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ImportTaskresponseImportResp: + +.. table:: **Table 11** Response body parameters + + ========= ====== ===================== + Parameter Type Description + ========= ====== ===================== + task_id String ID of an import task. + ========= ====== ===================== + +Example Requests +---------------- + +- Creating an Import Task (Importing Data from OBS) + + .. code-block:: + + { + "import_type" : "dir", + "import_path" : "s3://test-obs/daoLu_images/cat-dog/", + "included_tags" : [ ], + "import_annotations" : false, + "difficult_only" : false + } + +- Creating an Import Task (Importing Data from Manifest) + + .. code-block:: + + { + "import_type" : "manifest", + "import_path" : "s3://test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V002/V002.manifest", + "included_tags" : [ "cat", "dog", "Cat", "Dog" ], + "import_annotations" : true, + "difficult_only" : false + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "task_id" : "gfghHSokody6AJigS5A_m1dYqOw8vWCAznw1V28" + } + +Status Codes +------------ + + + +.. _ImportTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/data_import_task/index.rst b/api-ref/source/data_management/data_import_task/index.rst new file mode 100644 index 0000000..02729d7 --- /dev/null +++ b/api-ref/source/data_management/data_import_task/index.rst @@ -0,0 +1,10 @@ +================ +Data Import Task +================ + +.. toctree:: + :maxdepth: 1 + + querying_the_dataset_import_task_list + creating_an_import_task + querying_details_about_a_dataset_import_task diff --git a/api-ref/source/data_management/data_import_task/querying_details_about_a_dataset_import_task.rst b/api-ref/source/data_management/data_import_task/querying_details_about_a_dataset_import_task.rst new file mode 100644 index 0000000..4c0a132 --- /dev/null +++ b/api-ref/source/data_management/data_import_task/querying_details_about_a_dataset_import_task.rst @@ -0,0 +1,282 @@ +Querying Details About a Dataset Import Task +============================================ + +Function +-------- + +This API is used to query details about a dataset import task. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/import-tasks/{task_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | Task ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DescImportTaskresponseImportTaskStatusResp: + +.. table:: **Table 2** Response body parameters + + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========================+=======================================================================+====================================================================================================================================================================+ + | annotated_sample_count | Long | Number of labeled samples. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a task is created. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | `DataSource <#descimporttaskresponsedatasource>`__ object | Data source. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | String | Dataset ID. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | elapsed_time | Long | Task running time, in seconds. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | file_statistics | `FileCopyProgress <#descimporttaskresponsefilecopyprogress>`__ object | Progress of file copy. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | finished_file_count | Long | Number of files that have been transferred. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | finished_file_size | Long | Size of the file that has been transferred, in bytes. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_path | String | OBS path or **manifest** path to be imported. | + | | | | + | | | - When importing a manifest file, ensure that the path is accurate to the manifest file. | + | | | | + | | | - When a path is imported as a directory, the dataset type can only support image classification, object detection, text classification, or sound classification. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_type | Integer | Import mode. The options are as follows: | + | | | | + | | | - **0**: Import by directory. | + | | | | + | | | - **1**: Import by manifest file. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | imported_sample_count | Long | Number of imported samples. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | imported_sub_sample_count | Long | Number of imported subsamples. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_id | String | ID of a preprocessing task. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_status | Integer | Status of a preprocessing task. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Status of an import task. The options are as follows: | + | | | | + | | | - **QUEUING**: queuing | + | | | | + | | | - **STARTING**: execution started | + | | | | + | | | - **RUNNING**: running | + | | | | + | | | - **COMPLETED**: completed | + | | | | + | | | - **FAILED**: failed | + | | | | + | | | - **NOT_EXIST**: not found | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | String | Task ID. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_file_count | Long | Total number of files. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_file_size | Long | Total file size, in bytes. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sample_count | Long | Total number of samples. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sub_sample_count | Long | Total number of subsamples generated from the parent samples. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | unconfirmed_sample_count | Long | Number of samples to be confirmed. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_ms | Long | Time when a task is updated. | + +---------------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescImportTaskresponseDataSource: + +.. table:: **Table 3** DataSource + + +-----------------------+-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===================================================================+============================================================================================================================+ + | data_path | String | Data source path. | + +-----------------------+-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | data_type | Integer | Data type. The options are as follows: | + | | | | + | | | - **0**: OBS bucket (default value) | + | | | | + | | | - **1**: GaussDB(DWS) | + | | | | + | | | - **2**: DLI | + | | | | + | | | - **3**: RDS | + | | | | + | | | - **4**: MRS | + | | | | + | | | - **5**: AI Gallery | + | | | | + | | | - **6**: Inference service | + +-----------------------+-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | schema_maps | Array of `SchemaMap <#descimporttaskresponseschemamap>`__ objects | Schema mapping information corresponding to the table data. | + +-----------------------+-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | source_info | `SourceInfo <#descimporttaskresponsesourceinfo>`__ object | Information required for importing a table data source. | + +-----------------------+-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | Boolean | Whether the first row in the file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | + | | | - **true**: The first row in the file is the column name. | + | | | | + | | | - **false**: The first row in the file is not the column name. | + +-----------------------+-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescImportTaskresponseSchemaMap: + +.. table:: **Table 4** SchemaMap + + ========= ====== =============================== + Parameter Type Description + ========= ====== =============================== + dest_name String Name of the destination column. + src_name String Name of the source column. + ========= ====== =============================== + + + +.. _DescImportTaskresponseSourceInfo: + +.. table:: **Table 5** SourceInfo + + +-----------------------+-----------------------+--------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==============================================================+ + | cluster_id | String | ID of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | cluster_mode | String | Running mode of an MRS cluster. The options are as follows: | + | | | | + | | | - **0**: normal cluster | + | | | | + | | | - **1**: security cluster | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | cluster_name | String | Name of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | database_name | String | Name of the database to which the table dataset is imported. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | input | String | HDFS path of a table dataset. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | ip | String | IP address of your GaussDB(DWS) cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | port | String | Port number of your GaussDB(DWS) cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | queue_name | String | DLI queue name of a table dataset. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | subnet_id | String | Subnet ID of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | table_name | String | Name of the table to which a table dataset is imported. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | user_name | String | Username, which is mandatory for GaussDB(DWS) data. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | user_password | String | User password, which is mandatory for GaussDB(DWS) data. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | vpc_id | String | ID of the VPC where an MRS cluster resides. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + + + +.. _DescImportTaskresponseFileCopyProgress: + +.. table:: **Table 6** FileCopyProgress + + +--------------------+------+-------------------------------------------------------+ + | Parameter | Type | Description | + +====================+======+=======================================================+ + | file_num_finished | Long | Number of files that have been transferred. | + +--------------------+------+-------------------------------------------------------+ + | file_num_total | Long | Total number of files. | + +--------------------+------+-------------------------------------------------------+ + | file_size_finished | Long | Size of the file that has been transferred, in bytes. | + +--------------------+------+-------------------------------------------------------+ + | file_size_total | Long | Total file size, in bytes. | + +--------------------+------+-------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About an Import Task + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/import-tasks/{task_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "status" : "COMPLETED", + "task_id" : "gfghHSokody6AJigS5A_RHJ1zOkIoI3Nzwxj8nh", + "dataset_id" : "gfghHSokody6AJigS5A", + "import_path" : "obs://test-obs/daoLu_images/cat-dog/", + "import_type" : 0, + "total_sample_count" : 20, + "imported_sample_count" : 20, + "annotated_sample_count" : 20, + "total_sub_sample_count" : 0, + "imported_sub_sample_count" : 0, + "total_file_size" : 0, + "finished_file_count" : 0, + "finished_file_size" : 0, + "total_file_count" : 0, + "update_ms" : 1606114833955, + "create_time" : 1606114833874, + "elapsed_time" : 2 + } + +Status Codes +------------ + + + +.. _DescImportTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/data_import_task/querying_the_dataset_import_task_list.rst b/api-ref/source/data_management/data_import_task/querying_the_dataset_import_task_list.rst new file mode 100644 index 0000000..ad56e17 --- /dev/null +++ b/api-ref/source/data_management/data_import_task/querying_the_dataset_import_task_list.rst @@ -0,0 +1,306 @@ +Querying the Dataset Import Task List +===================================== + +Function +-------- + +This API is used to query the dataset import task list by page. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/import-tasks + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------+-----------+---------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+=========+===============================================================================================================+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-----------+-----------+---------+---------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-----------+-----------+---------+---------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListImportTasksresponseImportTasksStatusResp: + +.. table:: **Table 3** Response body parameters + + +--------------+------------------------------------------------------------------------------------------+-------------------------+ + | Parameter | Type | Description | + +==============+==========================================================================================+=========================+ + | import_tasks | Array of `ImportTaskStatusResp <#listimporttasksresponseimporttaskstatusresp>`__ objects | List of import tasks. | + +--------------+------------------------------------------------------------------------------------------+-------------------------+ + | total_count | Integer | Number of import tasks. | + +--------------+------------------------------------------------------------------------------------------+-------------------------+ + + + +.. _ListImportTasksresponseImportTaskStatusResp: + +.. table:: **Table 4** ImportTaskStatusResp + + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========================+========================================================================+====================================================================================================================================================================+ + | annotated_sample_count | Long | Number of labeled samples. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a task is created. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | `DataSource <#listimporttasksresponsedatasource>`__ object | Data source. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | String | Dataset ID. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | elapsed_time | Long | Task running time, in seconds. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | file_statistics | `FileCopyProgress <#listimporttasksresponsefilecopyprogress>`__ object | Progress of file copy. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | finished_file_count | Long | Number of files that have been transferred. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | finished_file_size | Long | Size of the file that has been transferred, in bytes. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_path | String | OBS path or **manifest** path to be imported. | + | | | | + | | | - When importing a manifest file, ensure that the path is accurate to the manifest file. | + | | | | + | | | - When a path is imported as a directory, the dataset type can only support image classification, object detection, text classification, or sound classification. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_type | Integer | Import mode. The options are as follows: | + | | | | + | | | - **0**: Import by directory. | + | | | | + | | | - **1**: Import by manifest file. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | imported_sample_count | Long | Number of imported samples. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | imported_sub_sample_count | Long | Number of imported subsamples. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_id | String | ID of a preprocessing task. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_status | Integer | Status of a preprocessing task. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Status of an import task. The options are as follows: | + | | | | + | | | - **QUEUING**: queuing | + | | | | + | | | - **STARTING**: execution started | + | | | | + | | | - **RUNNING**: running | + | | | | + | | | - **COMPLETED**: completed | + | | | | + | | | - **FAILED**: failed | + | | | | + | | | - **NOT_EXIST**: not found | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | String | Task ID. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_file_count | Long | Total number of files. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_file_size | Long | Total file size, in bytes. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sample_count | Long | Total number of samples. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sub_sample_count | Long | Total number of subsamples generated from the parent samples. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | unconfirmed_sample_count | Long | Number of samples to be confirmed. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_ms | Long | Time when a task is updated. | + +---------------------------+------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListImportTasksresponseDataSource: + +.. table:: **Table 5** DataSource + + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+====================================================================+============================================================================================================================+ + | data_path | String | Data source path. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | data_type | Integer | Data type. The options are as follows: | + | | | | + | | | - **0**: OBS bucket (default value) | + | | | | + | | | - **1**: GaussDB(DWS) | + | | | | + | | | - **2**: DLI | + | | | | + | | | - **3**: RDS | + | | | | + | | | - **4**: MRS | + | | | | + | | | - **5**: AI Gallery | + | | | | + | | | - **6**: Inference service | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | schema_maps | Array of `SchemaMap <#listimporttasksresponseschemamap>`__ objects | Schema mapping information corresponding to the table data. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | source_info | `SourceInfo <#listimporttasksresponsesourceinfo>`__ object | Information required for importing a table data source. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | Boolean | Whether the first row in the file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | + | | | - **true**: The first row in the file is the column name. | + | | | | + | | | - **false**: The first row in the file is not the column name. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListImportTasksresponseSchemaMap: + +.. table:: **Table 6** SchemaMap + + ========= ====== =============================== + Parameter Type Description + ========= ====== =============================== + dest_name String Name of the destination column. + src_name String Name of the source column. + ========= ====== =============================== + + + +.. _ListImportTasksresponseSourceInfo: + +.. table:: **Table 7** SourceInfo + + +-----------------------+-----------------------+--------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==============================================================+ + | cluster_id | String | ID of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | cluster_mode | String | Running mode of an MRS cluster. The options are as follows: | + | | | | + | | | - **0**: normal cluster | + | | | | + | | | - **1**: security cluster | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | cluster_name | String | Name of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | database_name | String | Name of the database to which the table dataset is imported. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | input | String | HDFS path of a table dataset. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | ip | String | IP address of your GaussDB(DWS) cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | port | String | Port number of your GaussDB(DWS) cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | queue_name | String | DLI queue name of a table dataset. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | subnet_id | String | Subnet ID of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | table_name | String | Name of the table to which a table dataset is imported. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | user_name | String | Username, which is mandatory for GaussDB(DWS) data. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | user_password | String | User password, which is mandatory for GaussDB(DWS) data. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | vpc_id | String | ID of the VPC where an MRS cluster resides. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + + + +.. _ListImportTasksresponseFileCopyProgress: + +.. table:: **Table 8** FileCopyProgress + + +--------------------+------+-------------------------------------------------------+ + | Parameter | Type | Description | + +====================+======+=======================================================+ + | file_num_finished | Long | Number of files that have been transferred. | + +--------------------+------+-------------------------------------------------------+ + | file_num_total | Long | Total number of files. | + +--------------------+------+-------------------------------------------------------+ + | file_size_finished | Long | Size of the file that has been transferred, in bytes. | + +--------------------+------+-------------------------------------------------------+ + | file_size_total | Long | Total file size, in bytes. | + +--------------------+------+-------------------------------------------------------+ + +Example Requests +---------------- + +Obtaining the Dataset Import Task List + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/import-tasks + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "total_count" : 1, + "import_tasks" : [ { + "status" : "COMPLETED", + "task_id" : "gfghHSokody6AJigS5A_RHJ1zOkIoI3Nzwxj8nh", + "dataset_id" : "gfghHSokody6AJigS5A", + "import_path" : "obs://test-obs/daoLu_images/cat-dog/", + "import_type" : 0, + "total_sample_count" : 20, + "imported_sample_count" : 20, + "annotated_sample_count" : 20, + "total_sub_sample_count" : 0, + "imported_sub_sample_count" : 0, + "total_file_size" : 0, + "finished_file_count" : 0, + "finished_file_size" : 0, + "total_file_count" : 0, + "create_time" : 1606114833874, + "elapsed_time" : 2 + } ] + } + +Status Codes +------------ + + + +.. _ListImportTasksstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/data_management_apis.rst b/api-ref/source/data_management/data_management_apis.rst new file mode 100644 index 0000000..0ae7fdc --- /dev/null +++ b/api-ref/source/data_management/data_management_apis.rst @@ -0,0 +1,178 @@ +Data Management APIs +==================== + + + +.. _modelarts030299enustopic0000001132278507enustopic0000001074274966table19560011132619: + +.. table:: **Table 1** Data management APIs + + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Type | API | Description | + +===========================+====================================================================================================================================================================================================+=====================================================================================================================================================================================================================================================================================+ + | Dataset Management | `Querying the Dataset List <../data_management/dataset_management/response_body_for_querying_the_dataset_list..html>`__ | Query created datasets by page based on specified conditions. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Creating a Dataset <../data_management/dataset_management/creating_a_dataset.html>`__ | Create a new dataset and determine whether to enable team labeling as needed. | + | | | | + | | | - Enable team labeling. The subsequent operations vary depending on the specified role. | + | | | | + | | | If a team is specified to assign labeling tasks, the team labeling task is started after the dataset is created. | + | | | | + | | | If a task manager is specified to assign labeling tasks, the manager calls the API in `Starting a Team Labeling Task <../data_management/labeling_task_management/starting_a_team_labeling_task.html>`__ to assign and start the team labeling tasks. | + | | | | + | | | - Disable team labeling. To enable team labeling later, call the API in `Creating a Team Labeling Task <../data_management/labeling_task_management/creating_a_team_labeling_task.html>`__ to create team labeling tasks for the dataset. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Details About a Dataset <../data_management/dataset_management/querying_details_about_a_dataset.html>`__ | Query details about a dataset, including the dataset name, type, and version name based on the dataset ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Modifying a Dataset <../data_management/dataset_management/modifying_a_dataset.html>`__ | Modify basic information about a dataset, such as the dataset name, description, version, or labels. | + | | | | + | | | The modification takes effect in the entire dataset, including the samples in the dataset. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Deleting a Dataset <../data_management/dataset_management/deleting_a_dataset.html>`__ | Delete a dataset based on the dataset ID to release resources. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Dataset Statistics <../data_management/dataset_management/querying_dataset_statistics.html>`__ | Query dataset statistics, such as sample statistics, label statistics, or hard examples based on specified conditions. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying the Monitoring Data of a Dataset <../data_management/dataset_management/querying_the_monitoring_data_of_a_dataset.html>`__ | Query the monitoring data of a dataset within a specified period, such as the number of labeled samples, number of unlabeled samples, and total number of samples at each time point within the period. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Data Synchronization | `Synchronizing a Dataset <../data_management/data_synchronization_task/synchronizing_a_dataset.html>`__ | Synchronize data and labels from the dataset input path to the dataset. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying the Status of a Dataset Synchronization Task <../data_management/data_synchronization_task/querying_the_status_of_a_dataset_synchronization_task.html>`__ | Query the status of a data source synchronization task based on the dataset ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Labeling Data | `Updating Sample Labels in Batches <../data_management/manual_labeling/updating_sample_labels_in_batches.html>`__ | Label multiple samples in a dataset in batches. | + | | | | + | | | - Label unlabeled samples. You can use an existing label or create a new label. | + | | | - Add, modify, or delete labels for labeled samples. You can use an existing label or newly added label to modify an original label. Additionally, you can add an existing label or a new label to a sample. | + | | | | + | | | This API uses a new label list to overwrite the original one to update the sample label. For example, if an empty label list is used to overwrite the original one, all sample labels will be deleted. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying the Sample List <../data_management/sample_management/querying_the_sample_list.html>`__ | Query dataset samples by page based on specified conditions. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Adding Samples in Batches <../data_management/sample_management/adding_samples_in_batches.html>`__ | Add samples to a dataset in batches for data labeling. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Deleting Samples in Batches <../data_management/sample_management/deleting_samples_in_batches.html>`__ | Delete unused samples from a dataset in batches. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Details About a Sample <../data_management/sample_management/querying_details_about_a_sample.html>`__ | Query a single sample based on the sample ID, including the sample status and labels. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Sample Search Criteria <../data_management/sample_management/obtaining_sample_search_condition.html>`__ | Obtain sample search criteria, such as the label list and attribute key-value pairs of the dataset based on the dataset ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Label Management | `Querying the Dataset Label List <../data_management/label_management/querying_the_dataset_label_list.html>`__ | Query the labels in a specified dataset version. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Creating a Dataset Label <../data_management/label_management/creating_a_dataset_label.html>`__ | During dataset labeling, new labels can be created. This function is available only in datasets of the text classification and named entity types. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Modifying Labels in Batches <../data_management/label_management/modifying_labels_in_batches.html>`__ | Modify dataset labels in batches. The modification takes effect in the entire dataset, including the samples in the dataset. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Deleting Labels in Batches <../data_management/label_management/deleting_labels_in_batches.html>`__ | Delete dataset labels in batches and ask you to determine whether to delete the samples with the labels. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Updating a Label by Label Name <../data_management/label_management/updating_a_label_by_label_names.html>`__ | Modify a label in a dataset based on the label name. The modification takes effect in the entire dataset, including the samples in the dataset. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Deleting a Label and the Files with This Label Only <../data_management/label_management/deleting_a_label_and_the_files_that_only_contain_the_label.html>`__ | Delete a label in a dataset based on the label name and ask you to determine whether to delete the samples with the label. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Importing Data | `Querying the Dataset Import Task List <../data_management/data_import_task/querying_the_dataset_import_task_list.html>`__ | Query historical tasks imported to a dataset by page based on the dataset ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Creating a Dataset Import Task <../data_management/data_import_task/creating_an_import_task.html>`__ | Create a dataset import task to import labels and data (such as Manifest files and OBS data) from a storage system to the dataset. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Details About a Dataset Import Task <../data_management/data_import_task/querying_details_about_a_dataset_import_task.html>`__ | Query details about a dataset import task based on the dataset ID and task ID to learn about the data source, import mode, and task status. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Exporting Data | `Querying the Dataset Export Task List <../data_management/data_export_task/querying_the_dataset_export_task_list.html>`__ | Query historical tasks exported from a dataset by page based on the dataset ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Creating a Dataset Export Task <../data_management/data_export_task/creating_a_dataset_export_task.html>`__ | Export certain data as a new dataset or to OBS. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying the Status of a Dataset Export Task <../data_management/data_export_task/querying_the_status_of_a_dataset_export_task.html>`__ | Query details about a dataset export task based on the dataset ID and task ID to learn about the export type, task status, and number of samples. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Publishing a Dataset | `Creating a Dataset Labeling Version <../data_management/dataset_version_management/creating_a_dataset_labeling_version.html>`__ | Publish the labeled dataset as a new version for model building. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Managing Dataset Versions | `Querying the Dataset Version List <../data_management/dataset_version_management/querying_the_dataset_version_list.html>`__ | Query the versions of a dataset based on the dataset ID to learn about the dataset version evolution. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Creating a Dataset Labeling Version <../data_management/dataset_version_management/creating_a_dataset_labeling_version.html>`__ | Publish a modified dataset as a new version. The modification includes labeling samples, adding samples, and deleting samples in the dataset. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Details About a Dataset Labeling Version <../data_management/dataset_version_management/querying_details_about_a_dataset_version.html>`__ | Query details about a specified dataset labeling version, including the name, description, number of files, and storage path based on the dataset ID and version ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Deleting a Dataset Labeling Version <../data_management/dataset_version_management/deleting_a_dataset_labeling_version.html>`__ | Delete a dataset version based on the dataset ID and version ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Auto Labeling | `Querying the Auto Labeling Sample List <../data_management/intelligent_task/querying_auto_labeling_sample_list.html>`__ | Query the to-be-confirmed auto labeling samples in a dataset by page based on the dataset ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Details About an Auto Labeling Sample <../data_management/intelligent_task/querying_details_about_an_auto_labeling_sample.html>`__ | Query information of a single auto labeling sample based on the dataset ID and sample ID, such as the sample labels, hard example details, and sample type. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Auto Labeling Tasks by Page <../data_management/intelligent_task/querying_the_intelligent_task_list_by_page.html>`__ | Query all auto labeling tasks by page based on the dataset ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Starting an Auto Labeling Task <../data_management/intelligent_task/starting_intelligent_tasks.html>`__ | Start an auto labeling task for unlabeled data to quickly label the data. After the auto labeling task is complete, call the API in `Updating Sample Labels in Batches <../data_management/manual_labeling/updating_sample_labels_in_batches.html>`__ to check the labeling result. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Details About an Auto Labeling Task <../data_management/intelligent_task/obtaining_information_about_intelligent_tasks.html>`__ | Query details about an auto labeling task based on the dataset ID and task ID to learn about the task configuration, name, and status. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Stopping an Auto Labeling Task <../data_management/intelligent_task/stopping_an_intelligent_task.html>`__ | Stop an ongoing auto labeling task based on the dataset ID and task ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Auto Grouping | `Querying Auto Grouping Tasks by Page <../data_management/intelligent_task/querying_the_intelligent_task_list_by_page.html>`__ | Query all auto grouping tasks by page based on the dataset ID. | + | | | | + | | | In auto grouping, unlabeled images are clustered using a clustering algorithm and then processed based on the clustering result. Images can be labeled by group or cleaned. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Starting an Auto Grouping Task <../data_management/intelligent_task/starting_intelligent_tasks.html>`__ | Execute an auto grouping task based on selected data samples to improve data labeling efficiency. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Details About an Auto Grouping Task <../data_management/intelligent_task/obtaining_information_about_intelligent_tasks.html>`__ | Query details about an auto grouping task based on the dataset ID and task ID to learn about the task configuration, name, and status. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Stopping an Auto Grouping Task <../data_management/intelligent_task/stopping_an_intelligent_task.html>`__ | Stop an ongoing auto grouping task based on the dataset ID and task ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Team Labeling | `Querying Statistics for a Team Labeling Task <../data_management/dataset_management/querying_details_about_team_labeling_task_statistics.html>`__ | Query statistics for a team labeling task on the data labeling platform, such as the sample statistics, label statistics, and hard example set based on the dataset ID and team labeling task ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Statistics for the Member Labeling Progresses in a Team Labeling Task <../data_management/dataset_management/querying_details_about_the_progress_of_a_team_labeling_task_member.html>`__ | Query statistics for the member labeling progresses in a team labeling task based on the dataset ID and team labeling task ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying the Team Labeling Task List of a Dataset <../data_management/labeling_task_management/querying_the_team_labeling_task_list_of_a_dataset.html>`__ | Query the team labeling tasks of a dataset based on the dataset ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Creating a Team Labeling Task <../data_management/labeling_task_management/creating_a_team_labeling_task.html>`__ | Create a team labeling task based on an existing dataset so that multiple members can concurrently label the dataset. | + | | | | + | | | - If a team is specified to assign labeling tasks, the team labeling task is started after the task is created. | + | | | - If a task manager is specified to assign labeling tasks, the manager calls the API in `Starting a Team Labeling Task <../data_management/labeling_task_management/starting_a_team_labeling_task.html>`__ to assign and start the team labeling tasks. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Details About a Team Labeling Task <../data_management/labeling_task_management/querying_details_about_a_team_labeling_task.html>`__ | Query details about a team labeling task based on the dataset ID and team labeling task ID, including the task name, data, and team information. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Starting a Team Labeling Task <../data_management/labeling_task_management/starting_a_team_labeling_task.html>`__ | The team labeling task manager assigns and starts a team labeling task on the data labeling platform based on the dataset ID and team labeling task ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Updating a Team Labeling Task <../data_management/labeling_task_management/updating_a_team_labeling_task.html>`__ | Update the description, name, and team information of a team labeling task based on the dataset ID and team labeling task ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Deleting a Team Labeling Task <../data_management/labeling_task_management/deleting_a_team_labeling_task.html>`__ | Delete a team labeling task based on the dataset ID and team labeling task ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Creating a Team Labeling Acceptance Task <../data_management/labeling_task_management/creating_a_team_labeling_acceptance_task.html>`__ | Initiate an acceptance task for a team labeling task based on the dataset ID and team labeling task ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying the Acceptance Report of a Team Labeling Task <../data_management/labeling_task_management/querying_the_report_of_a_team_labeling_acceptance_task.html>`__ | Query the acceptance report and statistics for a team labeling task based on the dataset ID and team labeling task ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Updating the Status of a Team Labeling Acceptance Task <../data_management/labeling_task_management/updating_the_status_of_a_team_labeling_acceptance_task.html>`__ | Determine the acceptance scope for a team labeling task, including all labeled data, and update the sample data accordingly. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying the Sample List of a Team Labeling Task by Page <../data_management/sample_management/querying_the_sample_list_of_a_team_labeling_task_by_page.html>`__ | Query the samples of a team labeling task on the data labeling platform by page based on the dataset ID and team labeling task ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Details About a Team Labeling Sample <../data_management/sample_management/querying_details_about_team_labeling_samples.html>`__ | Query details about a sample in a team labeling task on the data labeling platform based on the dataset ID, team labeling task ID, and sample ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Team Labeling Tasks by Team Member <../data_management/labeling_task_management/querying_the_team_labeling_task_list_by_a_team_member.html>`__ | Members in a team labeling task query all team labeling tasks on the data labeling platform by page. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Submitting Sample Review Comments for Acceptance <../data_management/team_labeling_process_management/submitting_sample_review_comments_of_an_acceptance_task.html>`__ | During the acceptance of a team labeling task, provide review comments on samples, including the review result and score. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Reviewing Team Labeling Results <../data_management/team_labeling_process_management/reviewing_team_labeling_results.html>`__ | The manager of a team labeling task reviews the team labeling task on the data labeling platform based on the dataset ID and team labeling task ID, determines the review result, and provides review comments. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Updating Labels of Team Labeling Samples in Batches <../data_management/team_labeling_process_management/updating_labels_of_team_labeling_samples_in_batches.html>`__ | Update sample labels on the data labeling platform in batches, including adding, modifying, and deleting the sample labels. Ensure that only the labels in the dataset can be added or modified. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Labeling Team | `Querying the Labeling Team List <../data_management/labeling_team_management/querying_the_labeling_team_list.html>`__ | Query all labeling teams by page. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Creating a Labeling Team <../data_management/labeling_team_management/creating_a_labeling_team.html>`__ | Add a labeling team. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Details About a Labeling Team <../data_management/labeling_team_management/querying_details_about_a_labeling_team.html>`__ | Query details about a labeling team, including the team name, description, and total number of members based on the team ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Updating a Labeling Team <../data_management/labeling_team_management/updating_a_labeling_team.html>`__ | Update the name and description of a labeling team based on the team ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Deleting a Labeling Team <../data_management/labeling_team_management/deleting_a_labeling_team.html>`__ | Delete a labeling team based on the team ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Sending an Email to Labeling Team Members <../data_management/labeling_team_member_management/sending_an_email_to_a_labeling_team_member.html>`__ | Enable automatic email sending to members in a labeling team to notify them of starting the team labeling task after the task is created. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying All Labeling Team Members <../data_management/labeling_team_member_management/querying_the_list_of_all_labeling_team_members.html>`__ | Query all labeling team members by page based on specified conditions. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Members in a Labeling Team <../data_management/labeling_team_member_management/querying_the_list_of_labeling_team_members.html>`__ | Query members in a labeling team by page based on the team ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Creating a Labeling Team Member <../data_management/labeling_team_member_management/creating_a_labeling_team_member.html>`__ | Add new members to a labeling team. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Deleting Labeling Team Members in Batches <../data_management/labeling_team_member_management/deleting_labeling_team_members_in_batches.html>`__ | Delete multiple members from a labeling team in batches. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Querying Details About a Labeling Team Member <../data_management/labeling_team_member_management/querying_details_about_labeling_team_members.html>`__ | Query details about a member in a labeling team, including the member description, email address, and role based on the team ID and member ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Updating Labeling Team Members <../data_management/labeling_team_member_management/updating_a_labeling_team_member.html>`__ | Update the description and role of a member in a labeling team based on the team ID and member ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | | `Deleting a Labeling Team Member <../data_management/labeling_team_member_management/deleting_a_labeling_team_member.html>`__ | Delete a member from a labeling team based on the team ID and member ID. | + +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + diff --git a/api-ref/source/data_management/data_synchronization_task/index.rst b/api-ref/source/data_management/data_synchronization_task/index.rst new file mode 100644 index 0000000..766acd3 --- /dev/null +++ b/api-ref/source/data_management/data_synchronization_task/index.rst @@ -0,0 +1,9 @@ +========================= +Data Synchronization Task +========================= + +.. toctree:: + :maxdepth: 1 + + synchronizing_a_dataset + querying_the_status_of_a_dataset_synchronization_task diff --git a/api-ref/source/data_management/data_synchronization_task/querying_the_status_of_a_dataset_synchronization_task.rst b/api-ref/source/data_management/data_synchronization_task/querying_the_status_of_a_dataset_synchronization_task.rst new file mode 100644 index 0000000..1a49c69 --- /dev/null +++ b/api-ref/source/data_management/data_synchronization_task/querying_the_status_of_a_dataset_synchronization_task.rst @@ -0,0 +1,120 @@ +Querying the Status of a Dataset Synchronization Task +===================================================== + +Function +-------- + +This API is used to query the status of a dataset synchronization task. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/sync-data/status + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _SyncDataSourceStateresponseSyncDataSourceStatusResp: + +.. table:: **Table 2** Response body parameters + + +-----------------------+-----------------------+-----------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================+ + | add_sample_count | Long | Number of added samples. | + +-----------------------+-----------------------+-----------------------------------------------+ + | create_time | Long | Task creation time. | + +-----------------------+-----------------------+-----------------------------------------------+ + | dataset_id | String | Dataset ID. | + +-----------------------+-----------------------+-----------------------------------------------+ + | deleted_sample_count | Long | Number of deleted samples. | + +-----------------------+-----------------------+-----------------------------------------------+ + | duration_time | Long | Task running time. | + +-----------------------+-----------------------+-----------------------------------------------+ + | error_code | String | Error code. | + +-----------------------+-----------------------+-----------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+-----------------------------------------------+ + | status | String | Status of a task. The options are as follows: | + | | | | + | | | - **QUEUING**: queuing | + | | | | + | | | - **STARTING**: execution started | + | | | | + | | | - **RUNNING**: running | + | | | | + | | | - **COMPLETED**: completed | + | | | | + | | | - **FAILED**: failed | + | | | | + | | | - **NOT_EXIST**: not found | + +-----------------------+-----------------------+-----------------------------------------------+ + | task_id | String | Synchronization task ID. | + +-----------------------+-----------------------+-----------------------------------------------+ + | total_sample_count | Long | Total number of samples. | + +-----------------------+-----------------------+-----------------------------------------------+ + +Example Requests +---------------- + +Obtaining the Status of a Dataset Synchronization + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/sync-data/status + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "status" : "COMPLETED", + "dataset_id" : "gfghHSokody6AJigS5A" + } + +Status Codes +------------ + + + +.. _SyncDataSourceStatestatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/data_synchronization_task/synchronizing_a_dataset.rst b/api-ref/source/data_management/data_synchronization_task/synchronizing_a_dataset.rst new file mode 100644 index 0000000..273cb39 --- /dev/null +++ b/api-ref/source/data_management/data_synchronization_task/synchronizing_a_dataset.rst @@ -0,0 +1,69 @@ +Synchronizing a Dataset +======================= + +Function +-------- + +This API is used to synchronize samples and labeling information from the input dataset path to the dataset. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/sync-data + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Synchronizing a Dataset + +.. code-block:: + + POST https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/sync-data + +Example Responses +----------------- + +None + +Status Codes +------------ + + + +.. _SyncDataSourcestatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_management/creating_a_dataset.rst b/api-ref/source/data_management/dataset_management/creating_a_dataset.rst new file mode 100644 index 0000000..5de3696 --- /dev/null +++ b/api-ref/source/data_management/dataset_management/creating_a_dataset.rst @@ -0,0 +1,619 @@ +Creating a Dataset +================== + +Function +-------- + +This API is used to create a dataset. + +URI +--- + +POST /v2/{project_id}/datasets + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateDatasetrequestCreateDatasetReq: + +.. table:: **Table 2** Request body parameters + + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=======================+=================+=============================================================================+===============================================================================================================================================================================================================================================================================================================================+ + | data_format | No | String | Data format. The options are as follows: | + | | | | | + | | | | - **Default**: default format | + | | | | | + | | | | - **CarbonData**: CarbonData (supported only by table datasets) | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_sources | No | Array of `DataSource <#createdatasetrequestdatasource>`__ objects | Input dataset path, which is used to synchronize source data (such as images, text files, and audio files) in the directory and its subdirectories to the dataset. For a table dataset, this parameter indicates the import directory. The work directory of a table dataset cannot be an OBS path in a KMS-encrypted bucket. | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_name | Yes | String | Dataset name. The value contains 1 to 100 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed, for example, dataset-9f3b. | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_type | No | Integer | Dataset type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet | + | | | | | + | | | | - **200**: sound classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **400**: table dataset | + | | | | | + | | | | - **600**: video labeling | + | | | | | + | | | | - **900**: custom format | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Dataset description. The value is empty by default. The description contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_annotations | No | Boolean | Whether to automatically import the labeling information in the input directory, supporting detection, image classification, and text classification. The options are as follows: | + | | | | | + | | | | - **true**: Import labeling information in the input directory. (Default value) | + | | | | | + | | | | - **false**: Do not import labeling information in the input directory. | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_data | No | Boolean | Whether to import data. This parameter is used only for table datasets. The options are as follows: | + | | | | | + | | | | - **true**: Import data when creating a database. | + | | | | | + | | | | - **false**: Do not import data when creating a database. (Default value) | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_format | No | `LabelFormat <#createdatasetrequestlabelformat>`__ object | Label format information. This parameter is used only for text datasets. | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labels | No | Array of `Label <#createdatasetrequestlabel>`__ objects | Dataset label list. | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | managed | No | Boolean | Whether to host a dataset. The options are as follows: | + | | | | | + | | | | - **true**: Host a dataset. | + | | | | | + | | | | - **false**: Do not host a dataset. (Default value) | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | schema | No | Array of `Field <#createdatasetrequestfield>`__ objects | Schema list. | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | work_path | Yes | String | Output dataset path, which is used to store output files such as label files. | + | | | | | + | | | | - The format is /*Bucket name*/*File path*, for example, /**obs-bucket**/**flower**/**rose**/. (The directory is used as the path.) | + | | | | | + | | | | - A bucket cannot be directly used as a path. | + | | | | | + | | | | - The output dataset path is different from the input dataset path or its subdirectory. | + | | | | | + | | | | - The value contains 3 to 700 characters. | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | work_path_type | Yes | Integer | Type of the dataset output path. The options are as follows: | + | | | | | + | | | | - **0**: OBS bucket (default value) | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_information | No | `WorkforceInformation <#createdatasetrequestworkforceinformation>`__ object | Team labeling information. | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +-----------------------+-----------------+-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateDatasetrequestDataSource: + +.. table:: **Table 3** DataSource + + +--------------------+-----------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+=================+=================================================================+============================================================================================================================+ + | data_path | No | String | Data source path. | + +--------------------+-----------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | data_type | No | Integer | Data type. The options are as follows: | + | | | | | + | | | | - **0**: OBS bucket (default value) | + | | | | | + | | | | - **1**: GaussDB(DWS) | + | | | | | + | | | | - **2**: DLI | + | | | | | + | | | | - **3**: RDS | + | | | | | + | | | | - **4**: MRS | + | | | | | + | | | | - **5**: AI Gallery | + | | | | | + | | | | - **6**: Inference service | + +--------------------+-----------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | schema_maps | No | Array of `SchemaMap <#createdatasetrequestschemamap>`__ objects | Schema mapping information corresponding to the table data. | + +--------------------+-----------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | source_info | No | `SourceInfo <#createdatasetrequestsourceinfo>`__ object | Information required for importing a table data source. | + +--------------------+-----------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | No | Boolean | Whether the first row in the file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | | + | | | | - **true**: The first row in the file is the column name. | + | | | | | + | | | | - **false**: The first row in the file is not the column name. | + +--------------------+-----------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateDatasetrequestSchemaMap: + +.. table:: **Table 4** SchemaMap + + ========= ========= ====== =============================== + Parameter Mandatory Type Description + ========= ========= ====== =============================== + dest_name No String Name of the destination column. + src_name No String Name of the source column. + ========= ========= ====== =============================== + + + +.. _CreateDatasetrequestSourceInfo: + +.. table:: **Table 5** SourceInfo + + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==============================================================+ + | cluster_id | No | String | ID of an MRS cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | cluster_mode | No | String | Running mode of an MRS cluster. The options are as follows: | + | | | | | + | | | | - **0**: normal cluster | + | | | | | + | | | | - **1**: security cluster | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | cluster_name | No | String | Name of an MRS cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | database_name | No | String | Name of the database to which the table dataset is imported. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | input | No | String | HDFS path of a table dataset. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | ip | No | String | IP address of your GaussDB(DWS) cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | port | No | String | Port number of your GaussDB(DWS) cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | queue_name | No | String | DLI queue name of a table dataset. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | subnet_id | No | String | Subnet ID of an MRS cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | table_name | No | String | Name of the table to which a table dataset is imported. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | user_name | No | String | Username, which is mandatory for GaussDB(DWS) data. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | user_password | No | String | User password, which is mandatory for GaussDB(DWS) data. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | vpc_id | No | String | ID of the VPC where an MRS cluster resides. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + + + +.. _CreateDatasetrequestLabelFormat: + +.. table:: **Table 6** LabelFormat + + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=======================+=================+=================+=========================================================================================================================================================================================================================================================================+ + | label_type | No | String | Label type of text classification. The options are as follows: | + | | | | | + | | | | - **0**: The label is separated from the text, and they are distinguished by the fixed suffix **\_result**. For example, the text file is **abc.txt**, and the label file is **abc_result.txt**. | + | | | | | + | | | | - **1**: Default value. Labels and texts are stored in the same file and separated by separators. You can use **text_sample_separator** to specify the separator between the text and label and **text_label_separator** to specify the separator between labels. | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | text_label_separator | No | String | Separator between labels. By default, the comma (,) is used as the separator. The separator needs to be escaped. Only one character can be used as the separator. The value must contain letters, digits, and one special character (!@#$%^&*_=|?/':.;,). | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | text_sample_separator | No | String | Separator between the text and label. By default, the **Tab** key is used as the separator. The separator needs to be escaped. Only one character can be used as the separator. The value must contain letters, digits, and one special character (!@#$%^&*_=|?/':.;,). | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateDatasetrequestLabel: + +.. table:: **Table 7** Label + + +-----------------+-----------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===========================================================================+==================================================================================================================================+ + | attributes | No | Array of `LabelAttribute <#createdatasetrequestlabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------+-----------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Label name. | + +-----------------+-----------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | No | `LabelProperty <#createdatasetrequestlabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------+-----------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateDatasetrequestLabelAttribute: + +.. table:: **Table 8** LabelAttribute + + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=====================================================================================+===================================================+ + | default_value | No | String | Default value of a label attribute. | + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | No | String | Label attribute ID. | + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | No | String | Label attribute name. | + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | No | String | Label attribute type. The options are as follows: | + | | | | | + | | | | - **text**: text | + | | | | | + | | | | - **select**: single-choice drop-down list | + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | No | Array of `LabelAttributeValue <#createdatasetrequestlabelattributevalue>`__ objects | List of label attribute values. | + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _CreateDatasetrequestLabelAttributeValue: + +.. table:: **Table 9** LabelAttributeValue + + ========= ========= ====== ========================= + Parameter Mandatory Type Description + ========= ========= ====== ========================= + id No String Label attribute value ID. + value No String Label attribute value. + ========= ========= ====== ========================= + + + +.. _CreateDatasetrequestLabelProperty: + +.. table:: **Table 10** LabelProperty + + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==========================+=================+=================+================================================================================================================================================================================================================+ + | @modelarts:color | No | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | No | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | | + | | | | - **bndbox**: rectangle | + | | | | | + | | | | - **polygon**: polygon | + | | | | | + | | | | - **circle**: circle | + | | | | | + | | | | - **line**: straight line | + | | | | | + | | | | - **dashed**: dotted line | + | | | | | + | | | | - **point**: point | + | | | | | + | | | | - **polyline**: polyline | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | No | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | No | String | Default attribute: The new name of the label. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | No | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | No | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateDatasetrequestField: + +.. table:: **Table 11** Field + + =========== ========= ======= =================== + Parameter Mandatory Type Description + =========== ========= ======= =================== + description No String Schema description. + name No String Schema name. + schema_id No Integer Schema ID. + type No String Schema value type. + =========== ========= ======= =================== + + + +.. _CreateDatasetrequestWorkforceInformation: + +.. table:: **Table 12** WorkforceInformation + + +--------------------------------+-----------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +================================+=================+=====================================================================+===============================================================================================================================================================================+ + | data_sync_type | No | Integer | Synchronization type. The options are as follows: | + | | | | | + | | | | - **0**: not to be synchronized | + | | | | | + | | | | - **1**: data to be synchronized | + | | | | | + | | | | - **2**: label to be synchronized | + | | | | | + | | | | - **3**: data and label to be synchronized | + +--------------------------------+-----------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | repetition | No | Integer | Number of persons who label each sample. The minimum value is **1**. | + +--------------------------------+-----------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | synchronize_auto_labeling_data | No | Boolean | Whether to synchronously update auto labeling data. The options are as follows: | + | | | | | + | | | | - **true**: Update auto labeling data synchronously. | + | | | | | + | | | | - **false**: Do not update auto labeling data synchronously. | + +--------------------------------+-----------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | synchronize_data | No | Boolean | Whether to synchronize updated data, such as uploading files, synchronizing data sources, and assigning imported unlabeled files to team members. The options are as follows: | + | | | | | + | | | | - **true**: Synchronize updated data to team members. | + | | | | | + | | | | - **false**: Do not synchronize updated data to team members. | + +--------------------------------+-----------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | No | String | ID of a team labeling task. | + +--------------------------------+-----------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_name | Yes | String | Name of a team labeling task. The value contains 1 to 64 characters, including only letters, digits, underscores (_), and hyphens (-). | + +--------------------------------+-----------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforces_config | No | `WorkforcesConfig <#createdatasetrequestworkforcesconfig>`__ object | Manpower assignment of a team labeling task. You can delegate the administrator to assign the manpower or do it by yourself. | + +--------------------------------+-----------------+---------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateDatasetrequestWorkforcesConfig: + +.. table:: **Table 13** WorkforcesConfig + + +------------+-----------+-----------------------------------------------------------------------------+--------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+=============================================================================+============================================+ + | agency | No | String | Administrator. | + +------------+-----------+-----------------------------------------------------------------------------+--------------------------------------------+ + | workforces | No | Array of `WorkforceConfig <#createdatasetrequestworkforceconfig>`__ objects | List of teams that execute labeling tasks. | + +------------+-----------+-----------------------------------------------------------------------------+--------------------------------------------+ + + + +.. _CreateDatasetrequestWorkforceConfig: + +.. table:: **Table 14** WorkforceConfig + + +----------------+-----------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +================+===========+===========================================================+=================================================================================================================================+ + | workers | No | Array of `Worker <#createdatasetrequestworker>`__ objects | List of labeling team members. | + +----------------+-----------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | No | String | ID of a labeling team. | + +----------------+-----------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | No | String | Name of a labeling team. The value contains 0 to 1024 characters and does not support the following special characters: !<>=&"' | + +----------------+-----------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateDatasetrequestWorker: + +.. table:: **Table 15** Worker + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==========================================================================================================================================+ + | create_time | No | Long | Creation time. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | No | String | Email address of a labeling team member. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | No | Integer | Role. The options are as follows: | + | | | | | + | | | | - **0**: labeling personnel | + | | | | | + | | | | - **1**: reviewer | + | | | | | + | | | | - **2**: team administrator | + | | | | | + | | | | - **3**: dataset owner | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | No | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | | + | | | | - **0**: The invitation email has not been sent. | + | | | | | + | | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | | + | | | | - **2**: The user has logged in. | + | | | | | + | | | | - **3**: The labeling team member has been deleted. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | No | Long | Update time. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | No | String | ID of a labeling team member. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | No | String | ID of a labeling team. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 201** + + + +.. _CreateDatasetresponseCreateDatasetResp: + +.. table:: **Table 16** Response body parameters + + ============== ====== ===================== + Parameter Type Description + ============== ====== ===================== + dataset_id String Dataset ID. + error_code String Error code. + error_msg String Error message. + import_task_id String ID of an import task. + ============== ====== ===================== + +Example Requests +---------------- + +- Creating an Image Classification Dataset + + .. code-block:: + + { + "workspace_id" : "0", + "dataset_name" : "dataset-457f", + "dataset_type" : 0, + "data_sources" : [ { + "data_type" : 0, + "data_path" : "/test-obs/classify/input/cat-dog/" + } ], + "description" : "", + "work_path" : "/test-obs/classify/output/", + "work_path_type" : 0, + "labels" : [ { + "name" : "Cat", + "type" : 0, + "property" : { + "@modelarts:color" : "#3399ff" + } + }, { + "name" : "Dog", + "type" : 0, + "property" : { + "@modelarts:color" : "#3399ff" + } + } ] + } + +- Creating an Object Detection Dataset + + .. code-block:: + + { + "workspace_id" : "0", + "dataset_name" : "dataset-95a6", + "dataset_type" : 1, + "data_sources" : [ { + "data_type" : 0, + "data_path" : "/test-obs/detect/input/cat-dog/" + } ], + "description" : "", + "work_path" : "/test-obs/detect/output/", + "work_path_type" : 0, + "labels" : [ { + "name" : "Cat", + "type" : 1, + "property" : { + "@modelarts:color" : "#3399ff" + } + }, { + "name" : "Dog", + "type" : 1, + "property" : { + "@modelarts:color" : "#3399ff" + } + } ] + } + +- Creating a Table Dataset + + .. code-block:: + + { + "workspace_id" : "0", + "dataset_name" : "dataset-de83", + "dataset_type" : 400, + "data_sources" : [ { + "data_type" : 0, + "data_path" : "/test-obs/table/input/", + "with_column_header" : true + } ], + "description" : "", + "work_path" : "/test-obs/table/output/", + "work_path_type" : 0, + "schema" : [ { + "schema_id" : 1, + "name" : "150", + "type" : "STRING" + }, { + "schema_id" : 2, + "name" : "4", + "type" : "STRING" + }, { + "schema_id" : 3, + "name" : "setosa", + "type" : "STRING" + }, { + "schema_id" : 4, + "name" : "versicolor", + "type" : "STRING" + }, { + "schema_id" : 5, + "name" : "virginica", + "type" : "STRING" + } ], + "import_data" : true + } + +Example Responses +----------------- + +**Status code: 201** + +Created + +.. code-block:: + + { + "dataset_id" : "WxCREuCkBSAlQr9xrde" + } + +Status Codes +------------ + + + +.. _CreateDatasetstatuscode: + +=========== ============ +Status Code Description +=========== ============ +201 Created +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_management/deleting_a_dataset.rst b/api-ref/source/data_management/dataset_management/deleting_a_dataset.rst new file mode 100644 index 0000000..083e39a --- /dev/null +++ b/api-ref/source/data_management/dataset_management/deleting_a_dataset.rst @@ -0,0 +1,74 @@ +Deleting a Dataset +================== + +Function +-------- + +This API is used to delete a dataset without deleting the source data of the dataset. + +URI +--- + +DELETE /v2/{project_id}/datasets/{dataset_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Deleting a Dataset + +.. code-block:: + + DELETE https://{endpoint}/v2/{project_id}/datasets/{dataset_id} + +Example Responses +----------------- + +**Status code: 204** + +No Content + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _DeleteDatasetstatuscode: + +=========== ============ +Status Code Description +=========== ============ +204 No Content +401 Unauthorized +403 Forbidden +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_management/index.rst b/api-ref/source/data_management/dataset_management/index.rst new file mode 100644 index 0000000..83073aa --- /dev/null +++ b/api-ref/source/data_management/dataset_management/index.rst @@ -0,0 +1,16 @@ +================== +Dataset Management +================== + +.. toctree:: + :maxdepth: 1 + + response_body_for_querying_the_dataset_list. + creating_a_dataset + querying_details_about_a_dataset + modifying_a_dataset + deleting_a_dataset + querying_dataset_statistics + querying_the_monitoring_data_of_a_dataset + querying_details_about_team_labeling_task_statistics + querying_details_about_the_progress_of_a_team_labeling_task_member diff --git a/api-ref/source/data_management/dataset_management/modifying_a_dataset.rst b/api-ref/source/data_management/dataset_management/modifying_a_dataset.rst new file mode 100644 index 0000000..50fd29a --- /dev/null +++ b/api-ref/source/data_management/dataset_management/modifying_a_dataset.rst @@ -0,0 +1,230 @@ +Modifying a Dataset +=================== + +Function +-------- + +This API is used to modify basic information about a dataset, such as the dataset name, description, current version, and labels. + +URI +--- + +PUT /v2/{project_id}/datasets/{dataset_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateDatasetrequestUpdateDatasetReq: + +.. table:: **Table 2** Request body parameters + + +--------------------+-----------+---------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+===========+=========================================================+=============================================================================================================================+ + | add_labels | No | Array of `Label <#updatedatasetrequestlabel>`__ objects | List of added labels. | + +--------------------+-----------+---------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | current_version_id | No | String | ID of current dataset version. | + +--------------------+-----------+---------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | dataset_name | No | String | Dataset name. | + +--------------------+-----------+---------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | delete_labels | No | Array of `Label <#updatedatasetrequestlabel>`__ objects | List of deleted labels. | + +--------------------+-----------+---------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Dataset description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +--------------------+-----------+---------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | update_labels | No | Array of `Label <#updatedatasetrequestlabel>`__ objects | List of updated labels. | + +--------------------+-----------+---------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateDatasetrequestLabel: + +.. table:: **Table 3** Label + + +-----------------+-----------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===========================================================================+==================================================================================================================================+ + | attributes | No | Array of `LabelAttribute <#updatedatasetrequestlabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------+-----------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Label name. | + +-----------------+-----------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | No | `LabelProperty <#updatedatasetrequestlabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------+-----------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateDatasetrequestLabelAttribute: + +.. table:: **Table 4** LabelAttribute + + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=====================================================================================+===================================================+ + | default_value | No | String | Default value of a label attribute. | + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | No | String | Label attribute ID. | + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | No | String | Label attribute name. | + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | No | String | Label attribute type. The options are as follows: | + | | | | | + | | | | - **text**: text | + | | | | | + | | | | - **select**: single-choice drop-down list | + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | No | Array of `LabelAttributeValue <#updatedatasetrequestlabelattributevalue>`__ objects | List of label attribute values. | + +-----------------+-----------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _UpdateDatasetrequestLabelAttributeValue: + +.. table:: **Table 5** LabelAttributeValue + + ========= ========= ====== ========================= + Parameter Mandatory Type Description + ========= ========= ====== ========================= + id No String Label attribute value ID. + value No String Label attribute value. + ========= ========= ====== ========================= + + + +.. _UpdateDatasetrequestLabelProperty: + +.. table:: **Table 6** LabelProperty + + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==========================+=================+=================+================================================================================================================================================================================================================+ + | @modelarts:color | No | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | No | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | | + | | | | - **bndbox**: rectangle | + | | | | | + | | | | - **polygon**: polygon | + | | | | | + | | | | - **circle**: circle | + | | | | | + | | | | - **line**: straight line | + | | | | | + | | | | - **dashed**: dotted line | + | | | | | + | | | | - **point**: point | + | | | | | + | | | | - **polyline**: polyline | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | No | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | No | String | Default attribute: The new name of the label. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | No | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | No | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _UpdateDatasetresponseUpdateDatasetResp: + +.. table:: **Table 7** Response body parameters + + ========== ====== =========== + Parameter Type Description + ========== ====== =========== + dataset_id String Dataset ID. + ========== ====== =========== + +Example Requests +---------------- + +Modifying a Dataset + +.. code-block:: + + { + "dataset_id" : "gfghHSokody6AJigS5A", + "description" : "just a test", + "add_tags" : [ { + "name" : "Pig", + "type" : 0, + "property" : { + "@modelarts:color" : "#3399ff" + } + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "dataset_id" : "gfghHSokody6AJigS5A" + } + +Status Codes +------------ + + + +.. _UpdateDatasetstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_management/querying_dataset_statistics.rst b/api-ref/source/data_management/dataset_management/querying_dataset_statistics.rst new file mode 100644 index 0000000..328cf74 --- /dev/null +++ b/api-ref/source/data_management/dataset_management/querying_dataset_statistics.rst @@ -0,0 +1,318 @@ +Querying Dataset Statistics +=========================== + +Function +-------- + +This API is used to query dataset statistics. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/data-annotations/stats + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+===============================================================================+ + | email | No | String | Email address of a labeling team member. | + +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------+ + | locale | No | String | Language. The options are as follows: | + | | | | | + | | | | - **zh-cn**: Chinese | + | | | | | + | | | | - **en-us**: English (default value) | + +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------+ + | sample_state | No | String | Query statistics on samples in a specified state. The options are as follows: | + | | | | | + | | | | - **ALL**: labeled | + | | | | | + | | | | - **NONE**: unlabeled | + | | | | | + | | | | - **UNCHECK**: pending acceptance | + | | | | | + | | | | - **ACCEPTED**: accepted | + | | | | | + | | | | - **REJECTED**: rejected | + | | | | | + | | | | - **UNREVIEWED**: pending review | + | | | | | + | | | | - **REVIEWED**: reviewed | + | | | | | + | | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | | + | | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | | + | | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | | + | | | | - **AUTO_ANNOTATION**: to be confirmed | + +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListStatsresponseListStatsResp: + +.. table:: **Table 3** Response body parameters + + +-----------------------+----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+================================================================+==================================================================================================================================================================================================================================================================================================================+ + | data_path | String | Path for storing data of a dataset. | + +-----------------------+----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_spliting_enable | Boolean | Whether the dataset can be split into training set and validation set based on the sample labeling statistics. The options are as follows: | + | | | | + | | | - **true**: The dataset can be split into training set and validation set. | + | | | | + | | | - **false**: The dataset cannot be split into training set and validation set. | + +-----------------------+----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | grouped_label_stats | Map> | Label statistics grouped by labeling type. | + +-----------------------+----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | hard_detail_stats | Map | Statistics on hard example reasons. The type is **Map>**. The **key** of Map indicates the ID of the hard example reason, the **key** of Pair indicates the number of times that the hard example reason occurs, and the **value** of Pair indicates the hard example reason. | + +-----------------------+----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | key_sample_stats | Map | Statistics on hard examples. | + +-----------------------+----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_stats | Array of `LabelStats <#liststatsresponselabelstats>`__ objects | List of label statistics. | + +-----------------------+----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata_stats | Map | Statistics on sample metadata, in JSON format. | + +-----------------------+----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_stats | Map | Statistics on sample status. | + +-----------------------+----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListStatsresponseLabelStats: + +.. table:: **Table 4** LabelStats + + +-----------------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+========================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#liststatsresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | count | Integer | Number of labels. | + +-----------------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#liststatsresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | sample_count | Integer | Number of samples containing the label. | + +-----------------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListStatsresponseLabelProperty: + +.. table:: **Table 5** LabelProperty + + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+=======================+================================================================================================================================================================================================================+ + | @modelarts:color | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | String | Default attribute: The new name of the label. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListStatsresponsePairOfintAndHardDetail: + +.. table:: **Table 6** PairOfintAndHardDetail + + +-----------+------------------------------------------------------+----------------------------------------------------+ + | Parameter | Type | Description | + +===========+======================================================+====================================================+ + | key | Integer | Number of times that a hard example reason occurs. | + +-----------+------------------------------------------------------+----------------------------------------------------+ + | value | `HardDetail <#liststatsresponseharddetail>`__ object | Reason for a hard example. | + +-----------+------------------------------------------------------+----------------------------------------------------+ + + + +.. _ListStatsresponseHardDetail: + +.. table:: **Table 7** HardDetail + + ========== ======= ==================== + Parameter Type Description + ========== ======= ==================== + alo_name String Alias. + id Integer Reason ID. + reason String Reason description. + suggestion String Handling suggestion. + ========== ======= ==================== + + + +.. _ListStatsresponseLabelAttribute: + +.. table:: **Table 8** LabelAttribute + + +-----------------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==================================================================================+===================================================+ + | default_value | String | Default value of a label attribute. | + +-----------------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + | id | String | Label attribute ID. | + +-----------------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + | name | String | Label attribute name. | + +-----------------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + | type | String | Label attribute type. The options are as follows: | + | | | | + | | | - **text**: text | + | | | | + | | | - **select**: single-choice drop-down list | + +-----------------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + | values | Array of `LabelAttributeValue <#liststatsresponselabelattributevalue>`__ objects | List of label attribute values. | + +-----------------------+----------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _ListStatsresponseLabelAttributeValue: + +.. table:: **Table 9** LabelAttributeValue + + ========= ====== ========================= + Parameter Type Description + ========= ====== ========================= + id String Label attribute value ID. + value String Label attribute value. + ========= ====== ========================= + +Example Requests +---------------- + +Querying Dataset Statistics + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/WxCREuCkBSAlQr9xrde/data-annotations/stats + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "label_stats" : [ { + "name" : "Dog", + "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 + }, + "deletion_stats" : { }, + "metadata_stats" : { }, + "data_spliting_enable" : false + } + +Status Codes +------------ + + + +.. _ListStatsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_management/querying_details_about_a_dataset.rst b/api-ref/source/data_management/dataset_management/querying_details_about_a_dataset.rst new file mode 100644 index 0000000..4f97b8b --- /dev/null +++ b/api-ref/source/data_management/dataset_management/querying_details_about_a_dataset.rst @@ -0,0 +1,870 @@ +Querying Details About a Dataset +================================ + +Function +-------- + +This API is used to query details about a dataset. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +--------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+=================+=================+=====================================================================================================================+ + | check_running_task | No | Boolean | Whether to detect tasks (including initialization tasks) that are running in a dataset. The options are as follows: | + | | | | | + | | | | - **true**: Detect tasks (including initialization tasks) that are running in the dataset. | + | | | | | + | | | | - **false**: Do not detect tasks that are running in the dataset. (Default value) | + +--------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------+ + | running_task_type | No | Integer | Type of the running tasks (including initialization tasks) to be detected. The options are as follows: | + | | | | | + | | | | - **0**: auto labeling | + | | | | | + | | | | - **1**: pre-labeling | + | | | | | + | | | | - **2**: export | + | | | | | + | | | | - **3**: version switch | + | | | | | + | | | | - **4**: manifest file export | + | | | | | + | | | | - **5**: manifest file import | + | | | | | + | | | | - **6**: version publishing | + | | | | | + | | | | - **7**: auto grouping | + | | | | | + | | | | - **10**: one-click model deployment (default value) | + +--------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DescDatasetresponseDescDatasetResp: + +.. table:: **Table 3** Response body parameters + + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +============================+==========================================================================+==================================================================================================================================================================================+ + | annotated_sample_count | Integer | Number of labeled samples in a dataset. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotated_sub_sample_count | Integer | Number of labeled subsamples. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | content_labeling | Boolean | Whether to enable content labeling for the speech paragraph labeling dataset. This function is enabled by default. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a dataset is created. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | current_version_id | String | Current version ID of a dataset. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | current_version_name | String | Current version name of a dataset. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_format | String | Data format. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_sources | Array of `DataSource <#descdatasetresponsedatasource>`__ objects | Data source list. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_statistics | Map | Sample statistics on a dataset, including the statistics on sample metadata. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_update_time | Long | Time when a sample and a label are updated. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_format | Integer | Dataset format. The options are as follows: | + | | | | + | | | - **0**: file | + | | | | + | | | - **1**: table | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | String | Dataset ID. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_name | String | Dataset name. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_tags | Array of strings | Key identifier list of a dataset, for example, ["Image","Object detection"]. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_type | Integer | Dataset type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet | + | | | | + | | | - **200**: sound classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **400**: table dataset | + | | | | + | | | - **600**: video labeling | + | | | | + | | | - **900**: custom format | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_count | Integer | Number of dataset versions. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deleted_sample_count | Integer | Number of deleted samples. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_stats | Map | Deletion reason statistics. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Dataset description. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | enterprise_project_id | String | Enterprise project ID. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | exist_running_task | Boolean | Whether the dataset contains running (including initialization) tasks. The options are as follows: | + | | | | + | | | - **true**: The dataset contains running tasks. | + | | | | + | | | - **false**: The dataset does not contain running tasks. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | exist_workforce_task | Boolean | Whether the dataset contains team labeling tasks. The options are as follows: | + | | | | + | | | - **true**: The dataset contains team labeling tasks. | + | | | | + | | | - **false**: The dataset does not contain team labeling tasks. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | feature_supports | Array of strings | List of features supported by the dataset. Currently, only the value **0** is supported, indicating that the OBS file size is limited. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_data | Boolean | Whether to import data. The options are as follows: | + | | | | + | | | - **true**: Import data. | + | | | | + | | | - **false**: Do not import data. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_task_id | String | ID of an import task. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_annotation_path | String | Path for storing the labeling result of a dataset. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_data_path | String | Path for storing the internal data of a dataset. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_log_path | String | Path for storing internal logs of a dataset. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_task_path | String | Path for internal task of a dataset. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_temp_path | String | Path for storing internal temporary files of a dataset. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_work_path | String | Output directory of a dataset. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_task_count | Integer | Number of labeling tasks. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labels | Array of `Label <#descdatasetresponselabel>`__ objects | Dataset label list. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | loading_sample_count | Integer | Number of loading samples. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | managed | Boolean | Whether a dataset is hosted. The options are as follows: | + | | | | + | | | - **true**: The dataset is hosted. | + | | | | + | | | - **false**: The dataset is not hosted. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | next_version_num | Integer | Number of next versions of a dataset. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | running_tasks_id | Array of strings | ID list of running (including initialization) tasks. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | schema | Array of `Field <#descdatasetresponsefield>`__ objects | Schema list. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Dataset status. The options are as follows: | + | | | | + | | | - **0**: creating dataset | + | | | | + | | | - **1**: normal dataset | + | | | | + | | | - **2**: deleting dataset | + | | | | + | | | - **3**: deleted dataset | + | | | | + | | | - **4**: abnormal dataset | + | | | | + | | | - **5**: synchronizing dataset | + | | | | + | | | - **6**: releasing dataset | + | | | | + | | | - **7**: dataset in version switching | + | | | | + | | | - **8**: importing dataset | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | third_path | String | Third-party path. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of dataset samples. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sub_sample_count | Integer | Total number of subsamples generated from the parent samples. For example, the total number of key frame images extracted from the video labeling dataset is that of subsamples. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | unconfirmed_sample_count | Integer | Number of auto labeling samples to be confirmed. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a dataset is updated. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | versions | Array of `DatasetVersion <#descdatasetresponsedatasetversion>`__ objects | Dataset version information. Currently, only the current version information of a dataset is recorded. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | work_path | String | Output dataset path, which is used to store output files such as label files. The path is an OBS path in the format of /*Bucket name*/*File path*. For example: /**obs-bucket**. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | work_path_type | Integer | Type of the dataset output path. The options are as follows: | + | | | | + | | | - **0**: OBS bucket (default value) | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_descriptor | `WorkforceDescriptor <#descdatasetresponseworkforcedescriptor>`__ object | Team labeling information. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_count | Integer | Number of team labeling tasks of a dataset. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +----------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescDatasetresponseDataSource: + +.. table:: **Table 4** DataSource + + +-----------------------+----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+================================================================+============================================================================================================================+ + | data_path | String | Data source path. | + +-----------------------+----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | data_type | Integer | Data type. The options are as follows: | + | | | | + | | | - **0**: OBS bucket (default value) | + | | | | + | | | - **1**: GaussDB(DWS) | + | | | | + | | | - **2**: DLI | + | | | | + | | | - **3**: RDS | + | | | | + | | | - **4**: MRS | + | | | | + | | | - **5**: AI Gallery | + | | | | + | | | - **6**: Inference service | + +-----------------------+----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | schema_maps | Array of `SchemaMap <#descdatasetresponseschemamap>`__ objects | Schema mapping information corresponding to the table data. | + +-----------------------+----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | source_info | `SourceInfo <#descdatasetresponsesourceinfo>`__ object | Information required for importing a table data source. | + +-----------------------+----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | Boolean | Whether the first row in the file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | + | | | - **true**: The first row in the file is the column name. | + | | | | + | | | - **false**: The first row in the file is not the column name. | + +-----------------------+----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescDatasetresponseSchemaMap: + +.. table:: **Table 5** SchemaMap + + ========= ====== =============================== + Parameter Type Description + ========= ====== =============================== + dest_name String Name of the destination column. + src_name String Name of the source column. + ========= ====== =============================== + + + +.. _DescDatasetresponseSourceInfo: + +.. table:: **Table 6** SourceInfo + + +-----------------------+-----------------------+--------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==============================================================+ + | cluster_id | String | ID of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | cluster_mode | String | Running mode of an MRS cluster. The options are as follows: | + | | | | + | | | - **0**: normal cluster | + | | | | + | | | - **1**: security cluster | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | cluster_name | String | Name of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | database_name | String | Name of the database to which the table dataset is imported. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | input | String | HDFS path of a table dataset. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | ip | String | IP address of your GaussDB(DWS) cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | port | String | Port number of your GaussDB(DWS) cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | queue_name | String | DLI queue name of a table dataset. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | subnet_id | String | Subnet ID of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | table_name | String | Name of the table to which a table dataset is imported. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | user_name | String | Username, which is mandatory for GaussDB(DWS) data. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | user_password | String | User password, which is mandatory for GaussDB(DWS) data. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | vpc_id | String | ID of the VPC where an MRS cluster resides. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + + + +.. _DescDatasetresponseLabel: + +.. table:: **Table 7** Label + + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==========================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#descdatasetresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#descdatasetresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescDatasetresponseLabelProperty: + +.. table:: **Table 8** LabelProperty + + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+=======================+================================================================================================================================================================================================================+ + | @modelarts:color | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | String | Default attribute: The new name of the label. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescDatasetresponseField: + +.. table:: **Table 9** Field + + =========== ======= =================== + Parameter Type Description + =========== ======= =================== + description String Schema description. + name String Schema name. + schema_id Integer Schema ID. + type String Schema value type. + =========== ======= =================== + + + +.. _DescDatasetresponseDatasetVersion: + +.. table:: **Table 10** DatasetVersion + + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=================================+==================================================================+==========================================================================================================================================================================+ + | add_sample_count | Integer | Number of added samples. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotated_sample_count | Integer | Number of samples with labeled versions. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotated_sub_sample_count | Integer | Number of labeled subsamples. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | clear_hard_property | Boolean | Whether to clear hard example properties during release. The options are as follows: | + | | | | + | | | - **true**: Clear hard example properties. (Default value) | + | | | | + | | | - **false**: Do not clear hard example properties. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | code | String | Status code of a preprocessing task such as rotation and cropping. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a version is created. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop | Boolean | Whether to crop the image. This field is valid only for the object detection dataset whose labeling box is in the rectangle shape. The options are as follows: | + | | | | + | | | - **true**: Crop the image. | + | | | | + | | | - **false**: Do not crop the image. (Default value) | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop_path | String | Path for storing cropped files. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop_rotate_cache_path | String | Temporary directory for executing the rotation and cropping task. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_path | String | Path for storing data. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_statistics | Map | Sample statistics on a dataset, including the statistics on sample metadata in JSON format. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_validate | Boolean | Whether data is validated by the validation algorithm before release. The options are as follows: | + | | | | + | | | - **true**: The data has been validated. | + | | | | + | | | - **false**: The data has not been validated. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deleted_sample_count | Integer | Number of deleted samples. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_stats | Map | Deletion reason statistics. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description of a version. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_images | Boolean | Whether to export images to the version output directory during release. The options are as follows: | + | | | | + | | | - **true**: Export images to the version output directory. | + | | | | + | | | - **false**: Do not export images to the version output directory. (Default value) | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | extract_serial_number | Boolean | Whether to parse the subsample number during release. The field is valid for the healthcare dataset. The options are as follows: | + | | | | + | | | - **true**: Parse the subsample number. | + | | | | + | | | - **false**: Do not parse the subsample number. (Default value) | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | include_dataset_data | Boolean | Whether to include the source data of a dataset during release. The options are as follows: | + | | | | + | | | - **true**: The source data of a dataset is included. | + | | | | + | | | - **false**: The source data of a dataset is not included. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_current | Boolean | Whether the current dataset version is used. The options are as follows: | + | | | | + | | | - **true**: The current dataset version is used. | + | | | | + | | | - **false**: The current dataset version is not used. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_stats | Array of `LabelStats <#descdatasetresponselabelstats>`__ objects | Label statistics list of a released version. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_type | String | Label type of a released version. The options are as follows: | + | | | | + | | | - **multi**: Multi-label samples are included. | + | | | | + | | | - **single**: All samples are single-labeled. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | manifest_cache_input_path | String | Input path for the **manifest** file cache during version release. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | manifest_path | String | Path for storing the **manifest** file with the released version. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | message | String | Task information recorded during release (for example, error information). | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | modified_sample_count | Integer | Number of modified samples. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_annotated_sample_count | Integer | Number of labeled samples of parent versions. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_total_sample_count | Integer | Total samples of parent versions. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_version_id | String | Parent version ID | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_id | String | ID of a preprocessing task such as rotation and cropping. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_status | Integer | Status of a preprocessing task such as rotation and cropping. The options are as follows: | + | | | | + | | | - **0**: initialized | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: completed | + | | | | + | | | - **3**: failed | + | | | | + | | | - **4**: stopped | + | | | | + | | | - **5**: timeout | + | | | | + | | | - **6**: deletion failed | + | | | | + | | | - **7**: stop failed | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | remove_sample_usage | Boolean | Whether to clear the existing usage information of a dataset during release. The options are as follows: | + | | | | + | | | - **true**: Clear the existing usage information of a dataset. (Default value) | + | | | | + | | | - **false**: Do not clear the existing usage information of a dataset. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rotate | Boolean | Whether to rotate the image. The options are as follows: | + | | | | + | | | - **true**: Rotate the image. | + | | | | + | | | - **false**: Do not rotate the image. (Default value) | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rotate_path | String | Path for storing the rotated file. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Status of a dataset version. The options are as follows: | + | | | | + | | | - **0**: creating | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: deleting | + | | | | + | | | - **3**: deleted | + | | | | + | | | - **4**: error | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | tags | Array of strings | Key identifier list of the dataset. The labeling type is used as the default label when the labeling task releases a version. For example, ["Image","Object detection"]. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_type | Integer | Labeling task type of the released version, which is the same as the dataset type. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of version samples. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sub_sample_count | Integer | Total number of subsamples generated from the parent samples. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_evaluate_sample_ratio | String | Split training and verification ratio during version release. The default value is **1.00**, indicating that all labeled samples are split into the training set. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a version is updated. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_format | String | Format of a dataset version. The options are as follows: | + | | | | + | | | - **Default**: default format | + | | | | + | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | + | | | - **CSV**: CSV | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Dataset version ID. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | Boolean | Whether the first row in the released CSV file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | + | | | - **true**: The first row in the released CSV file is a column name. | + | | | | + | | | - **false**: The first row in the released CSV file is not a column name. | + +---------------------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescDatasetresponseLabelStats: + +.. table:: **Table 11** LabelStats + + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==========================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#descdatasetresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | count | Integer | Number of labels. | + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#descdatasetresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | sample_count | Integer | Number of samples containing the label. | + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescDatasetresponseLabelAttribute: + +.. table:: **Table 12** LabelAttribute + + +-----------------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Type | Description | + +=======================+====================================================================================+===================================================+ + | default_value | String | Default value of a label attribute. | + +-----------------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | String | Label attribute ID. | + +-----------------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | String | Label attribute name. | + +-----------------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | String | Label attribute type. The options are as follows: | + | | | | + | | | - **text**: text | + | | | | + | | | - **select**: single-choice drop-down list | + +-----------------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | Array of `LabelAttributeValue <#descdatasetresponselabelattributevalue>`__ objects | List of label attribute values. | + +-----------------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _DescDatasetresponseLabelAttributeValue: + +.. table:: **Table 13** LabelAttributeValue + + ========= ====== ========================= + Parameter Type Description + ========= ====== ========================= + id String Label attribute value ID. + value String Label attribute value. + ========= ====== ========================= + + + +.. _DescDatasetresponseWorkforceDescriptor: + +.. table:: **Table 14** WorkforceDescriptor + + +-----------------------------------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===================================+==========================================================+===============================================================================================================================================================================+ + | current_task_id | String | ID of a team labeling task. | + +-----------------------------------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | current_task_name | String | Name of a team labeling task. | + +-----------------------------------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | reject_num | Integer | Number of rejected samples. | + +-----------------------------------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | repetition | Integer | Number of persons who label each sample. The minimum value is **1**. | + +-----------------------------------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_synchronize_auto_labeling_data | Boolean | Whether to synchronously update auto labeling data. The options are as follows: | + | | | | + | | | - **true**: Update auto labeling data synchronously. | + | | | | + | | | - **false**: Do not update auto labeling data synchronously. | + +-----------------------------------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_synchronize_data | Boolean | Whether to synchronize updated data, such as uploading files, synchronizing data sources, and assigning imported unlabeled files to team members. The options are as follows: | + | | | | + | | | - **true**: Synchronize updated data to team members. | + | | | | + | | | - **false**: Do not synchronize updated data to team members. | + +-----------------------------------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workers | Array of `Worker <#descdatasetresponseworker>`__ objects | List of labeling team members. | + +-----------------------------------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------------------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | String | Name of a labeling team. | + +-----------------------------------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescDatasetresponseWorker: + +.. table:: **Table 15** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About a Dataset + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "dataset_id" : "gfghHSokody6AJigS5A", + "dataset_name" : "dataset-f9e8", + "dataset_type" : 0, + "data_format" : "Default", + "next_version_num" : 4, + "status" : 1, + "data_sources" : [ { + "data_type" : 0, + "data_path" : "/test-obs/classify/input/catDog4/" + } ], + "create_time" : 1605690595404, + "update_time" : 1605690595404, + "description" : "", + "current_version_id" : "54IXbeJhfttGpL46lbv", + "current_version_name" : "V003", + "total_sample_count" : 10, + "annotated_sample_count" : 10, + "unconfirmed_sample_count" : 0, + "work_path" : "/test-obs/classify/output/", + "inner_work_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/", + "inner_annotation_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/", + "inner_data_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/data/", + "inner_log_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/logs/", + "inner_temp_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/temp/", + "inner_task_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/task/", + "work_path_type" : 0, + "workspace_id" : "0", + "enterprise_project_id" : "0", + "workforce_task_count" : 0, + "feature_supports" : [ "0" ], + "managed" : false, + "import_data" : false, + "ai_project" : "default-ai-project", + "label_task_count" : 1, + "dataset_format" : 0, + "dataset_version_count" : 3, + "dataset_version" : "v1", + "content_labeling" : true, + "labels" : [ { + "name" : "Cat", + "type" : 0, + "property" : { + "@modelarts:color" : "#3399ff" + } + }, { + "name" : "Dog", + "type" : 0, + "property" : { + "@modelarts:color" : "#3399ff" + } + } ] + } + +Status Codes +------------ + + + +.. _DescDatasetstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_management/querying_details_about_team_labeling_task_statistics.rst b/api-ref/source/data_management/dataset_management/querying_details_about_team_labeling_task_statistics.rst new file mode 100644 index 0000000..733eea7 --- /dev/null +++ b/api-ref/source/data_management/dataset_management/querying_details_about_team_labeling_task_statistics.rst @@ -0,0 +1,320 @@ +Querying Details About Team Labeling Task Statistics +==================================================== + +Function +-------- + +This API is used to query details about team labeling task statistics. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/stats + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a team labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=======================================================================+ + | sample_state | No | String | Statistics on the specified sample state. The options are as follows: | + | | | | | + | | | | - **ALL**: labeled | + | | | | | + | | | | - **NONE**: unlabeled | + | | | | | + | | | | - **UNCHECK**: pending acceptance | + | | | | | + | | | | - **ACCEPTED**: accepted | + | | | | | + | | | | - **REJECTED**: rejected | + | | | | | + | | | | - **UNREVIEWED**: pending review | + | | | | | + | | | | - **REVIEWED**: reviewed | + | | | | | + | | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | | + | | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | | + | | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | | + | | | | - **AUTO_ANNOTATION**: to be confirmed | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListWorkforceTaskStatsresponseListStatsResp: + +.. table:: **Table 3** Response body parameters + + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=============================================================================+==================================================================================================================================================================================================================================================================================================================+ + | data_path | String | Path for storing data of a dataset. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_spliting_enable | Boolean | Whether the dataset can be split into training set and validation set based on the sample labeling statistics. The options are as follows: | + | | | | + | | | - **true**: The dataset can be split into training set and validation set. | + | | | | + | | | - **false**: The dataset cannot be split into training set and validation set. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | grouped_label_stats | Map> | Label statistics grouped by labeling type. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | hard_detail_stats | Map | Statistics on hard example reasons. The type is **Map>**. The **key** of Map indicates the ID of the hard example reason, the **key** of Pair indicates the number of times that the hard example reason occurs, and the **value** of Pair indicates the hard example reason. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | key_sample_stats | Map | Statistics on hard examples. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_stats | Array of `LabelStats <#listworkforcetaskstatsresponselabelstats>`__ objects | List of label statistics. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata_stats | Map | Statistics on sample metadata, in JSON format. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_stats | Map | Statistics on sample status. | + +-----------------------+-----------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTaskStatsresponseLabelStats: + +.. table:: **Table 4** LabelStats + + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=====================================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#listworkforcetaskstatsresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | count | Integer | Number of labels. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#listworkforcetaskstatsresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | sample_count | Integer | Number of samples containing the label. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTaskStatsresponseLabelProperty: + +.. table:: **Table 5** LabelProperty + + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+=======================+================================================================================================================================================================================================================+ + | @modelarts:color | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | String | Default attribute: The new name of the label. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTaskStatsresponsePairOfintAndHardDetail: + +.. table:: **Table 6** PairOfintAndHardDetail + + +-----------+-------------------------------------------------------------------+----------------------------------------------------+ + | Parameter | Type | Description | + +===========+===================================================================+====================================================+ + | key | Integer | Number of times that a hard example reason occurs. | + +-----------+-------------------------------------------------------------------+----------------------------------------------------+ + | value | `HardDetail <#listworkforcetaskstatsresponseharddetail>`__ object | Reason for a hard example. | + +-----------+-------------------------------------------------------------------+----------------------------------------------------+ + + + +.. _ListWorkforceTaskStatsresponseHardDetail: + +.. table:: **Table 7** HardDetail + + ========== ======= ==================== + Parameter Type Description + ========== ======= ==================== + alo_name String Alias. + id Integer Reason ID. + reason String Reason description. + suggestion String Handling suggestion. + ========== ======= ==================== + + + +.. _ListWorkforceTaskStatsresponseLabelAttribute: + +.. table:: **Table 8** LabelAttribute + + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===============================================================================================+===================================================+ + | default_value | String | Default value of a label attribute. | + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | String | Label attribute ID. | + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | String | Label attribute name. | + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | String | Label attribute type. The options are as follows: | + | | | | + | | | - **text**: text | + | | | | + | | | - **select**: single-choice drop-down list | + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | Array of `LabelAttributeValue <#listworkforcetaskstatsresponselabelattributevalue>`__ objects | List of label attribute values. | + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _ListWorkforceTaskStatsresponseLabelAttributeValue: + +.. table:: **Table 9** LabelAttributeValue + + ========= ====== ========================= + Parameter Type Description + ========= ====== ========================= + id String Label attribute value ID. + value String Label attribute value. + ========= ====== ========================= + +Example Requests +---------------- + +Querying Statistics on Unapproved Samples of a Team Labeling Task + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/WxCREuCkBSAlQr9xrde/workforce-tasks/tY330MHxV9dqIPVaTRM/data-annotations/stats?sample_state=__unreviewed__ + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "label_stats" : [ { + "name" : "Cat", + "type" : 1, + "property" : { + "@modelarts:color" : "#3399ff" + }, + "count" : 0, + "sample_count" : 0 + }, { + "name" : "Dog", + "type" : 1, + "property" : { + "@modelarts:color" : "#3399ff" + }, + "count" : 1, + "sample_count" : 1 + } ], + "sample_stats" : { + "un_annotation" : 308, + "total" : 309, + "rejected" : 0, + "unreviewed" : 1, + "accepted" : 0, + "auto_annotation" : 0, + "uncheck" : 0 + }, + "key_sample_stats" : { + "total" : 309, + "non_key_sample" : 309, + "key_sample" : 0 + }, + "deletion_stats" : { }, + "metadata_stats" : { }, + "data_spliting_enable" : false + } + +Status Codes +------------ + + + +.. _ListWorkforceTaskStatsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_management/querying_details_about_the_progress_of_a_team_labeling_task_member.rst b/api-ref/source/data_management/dataset_management/querying_details_about_the_progress_of_a_team_labeling_task_member.rst new file mode 100644 index 0000000..2c10d88 --- /dev/null +++ b/api-ref/source/data_management/dataset_management/querying_details_about_the_progress_of_a_team_labeling_task_member.rst @@ -0,0 +1,100 @@ +Querying Details About the Progress of a Team Labeling Task Member +================================================================== + +Function +-------- + +This API is used to query details about the progress of a team labeling task member. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/metrics + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a team labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _GetWorkforceTaskMetricsresponseGetWorkforceTaskMetricResp: + +.. table:: **Table 2** Response body parameters + + +--------------+---------------------------------+-------------------------------------------+ + | Parameter | Type | Description | + +==============+=================================+===========================================+ + | sample_stats | Map> | Statistics on team labeling task members. | + +--------------+---------------------------------+-------------------------------------------+ + +Example Requests +---------------- + +Querying Details About the Progress of a Team Labeling Task Member + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/metrics + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "sample_stats" : { + "xxx@xxx.com" : { + "un_annotation" : 51, + "rejected" : 0, + "unreviewed" : 0, + "accepted" : 0, + "auto_annotation" : 0, + "uncheck" : 0 + } + } + } + +Status Codes +------------ + + + +.. _GetWorkforceTaskMetricsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_management/querying_the_monitoring_data_of_a_dataset.rst b/api-ref/source/data_management/dataset_management/querying_the_monitoring_data_of_a_dataset.rst new file mode 100644 index 0000000..271d7a1 --- /dev/null +++ b/api-ref/source/data_management/dataset_management/querying_the_monitoring_data_of_a_dataset.rst @@ -0,0 +1,120 @@ +Querying the Monitoring Data of a Dataset +========================================= + +Function +-------- + +This API is used to query the monitoring data of a dataset within a specified time range. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/metrics + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-------------------+-----------+--------+-------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+===========================================+ + | end_time | Yes | Long | End time of the monitoring information. | + +-------------------+-----------+--------+-------------------------------------------+ + | start_time | Yes | Long | Start time of the monitoring information. | + +-------------------+-----------+--------+-------------------------------------------+ + | workforce_task_id | No | String | ID of a team labeling task. | + +-------------------+-----------+--------+-------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _GetDatasetMetricsresponseGetDatasetMetricResp: + +.. table:: **Table 3** Response body parameters + + +-----------+---------------------------------+---------------------------------+ + | Parameter | Type | Description | + +===========+=================================+=================================+ + | metrics | Map> | Dataset monitoring information. | + +-----------+---------------------------------+---------------------------------+ + +Example Requests +---------------- + +Querying the Monitoring Data of a Dataset + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/metrics + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "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" : { } + } + } + +Status Codes +------------ + + + +.. _GetDatasetMetricsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_management/response_body_for_querying_the_dataset_list..rst b/api-ref/source/data_management/dataset_management/response_body_for_querying_the_dataset_list..rst new file mode 100644 index 0000000..7d5cc79 --- /dev/null +++ b/api-ref/source/data_management/dataset_management/response_body_for_querying_the_dataset_list..rst @@ -0,0 +1,1001 @@ +Response body for querying the dataset list. +============================================ + +Function +-------- + +This API is used to query the created datasets that meet the search criteria by page. + +URI +--- + +GET /v2/{project_id}/datasets + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +======================+=================+=================+==============================================================================================================================================================================================================================================================================================================================================================================+ + | check_running_task | No | Boolean | Whether to detect tasks (including initialization tasks) that are running in a dataset. The options are as follows: | + | | | | | + | | | | - **true**: Detect tasks (including initialization tasks) that are running in the dataset. | + | | | | | + | | | | - **false**: Do not detect tasks (including initialization tasks) that are running in the dataset. (Default value) | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | contain_versions | No | Boolean | Whether the dataset contains a version. | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_type | No | Integer | Dataset type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet | + | | | | | + | | | | - **200**: sound classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **400**: table dataset | + | | | | | + | | | | - **600**: video labeling | + | | | | | + | | | | - **900**: custom format | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | file_preview | No | Boolean | Whether a dataset supports preview when it is queried. The options are as follows: | + | | | | | + | | | | - **true**: Preview is supported and the list of four dataset files is returned. | + | | | | | + | | | | - **false**: Preview is not supported. (Default value) | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting sequence of the query. The options are as follows: | + | | | | | + | | | | - **asc**: ascending order | + | | | | | + | | | | - **desc**: descending order (default value) | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | running_task_type | No | Integer | Type of the running tasks (including initialization tasks) to be detected. The options are as follows: | + | | | | | + | | | | - **0**: auto labeling | + | | | | | + | | | | - **1**: pre-labeling | + | | | | | + | | | | - **2**: export | + | | | | | + | | | | - **3**: version switch | + | | | | | + | | | | - **4**: manifest file export | + | | | | | + | | | | - **5**: manifest file import | + | | | | | + | | | | - **6**: version publishing | + | | | | | + | | | | - **7**: auto grouping | + | | | | | + | | | | - **10**: one-click model deployment (default value) | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_content | No | String | Fuzzy search keyword. By default, this parameter is left blank. | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Sorting mode of the query. The options are as follows: | + | | | | | + | | | | - **create_time**: Sort by creation time. (Default value) | + | | | | | + | | | | - **dataset_name**: Sort by dataset name. | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | support_export | No | Boolean | Whether to filter datasets that can be exported only (including datasets of image classification, object detection, and custom format). If this parameter is left blank or the value is set to **false**, no filtering is performed. The options are as follows: | + | | | | | + | | | | - **true**: Filter datasets that can be exported only. | + | | | | | + | | | | - **false**: Do not filter datasets that can be exported only. (Default value) | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_evaluate_ratio | No | String | Version split ratio for dataset filtering. The numbers before and after the comma indicate the minimum and maximum split ratios, and the versions whose split ratios are within the range are filtered out, for example, **0.0,1.0**. Note: If this parameter is left blank or unavailable, the system does not filter datasets based on the version split ratio by default. | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_format | No | Integer | Dataset version format for dataset filtering. This parameter is used to filter datasets that meet the filter criteria. The options are as follows: | + | | | | | + | | | | - **0**: default format | + | | | | | + | | | | - **1**: CarbonData (supported only by table datasets) | + | | | | | + | | | | - **2**: CSV | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | with_labels | No | Boolean | Whether to return dataset labels. The options are as follows: | + | | | | | + | | | | - **true**: Return label information. | + | | | | | + | | | | - **false**: Do not return label information. (Default value) | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListDatasetsresponseListDatasetsResp: + +.. table:: **Table 3** Response body parameters + + +--------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============+=========================================================================================+=================================================================================================================================+ + | datasets | Array of `DatasetAndFilePreview <#listdatasetsresponsedatasetandfilepreview>`__ objects | Dataset list queried by page. | + +--------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | total_number | Integer | Total number of datasets. | + +--------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workspaceId | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +--------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListDatasetsresponseDatasetAndFilePreview: + +.. table:: **Table 4** DatasetAndFilePreview + + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +============================+===========================================================================+==================================================================================================================================================================================+ + | annotated_sample_count | Integer | Number of labeled samples in a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotated_sub_sample_count | Integer | Number of labeled subsamples. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | content_labeling | Boolean | Whether to enable content labeling for the speech paragraph labeling dataset. This function is enabled by default. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a dataset is created. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | current_version_id | String | Current version ID of a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | current_version_name | String | Current version name of a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_format | String | Data format. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_sources | Array of `DataSource <#listdatasetsresponsedatasource>`__ objects | Data source list. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_statistics | Map | Sample statistics on a dataset, including the statistics on sample metadata in JSON format. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_update_time | Long | Time when a sample and a label are updated. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | String | Data path for training. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_format | Integer | Dataset format. The options are as follows: | + | | | | + | | | - **0**: file | + | | | | + | | | - **1**: table | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | String | Dataset ID. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_name | String | Dataset name. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_tags | Array of strings | Key identifier list of a dataset, for example, ["Image","Object detection"]. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_type | Integer | Dataset type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet | + | | | | + | | | - **200**: sound classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **400**: table dataset | + | | | | + | | | - **600**: video labeling | + | | | | + | | | - **900**: custom format | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_count | Integer | Version number of a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deleted_sample_count | Integer | Number of deleted samples. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_stats | Map | Deletion reason statistics. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Dataset description. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | enterprise_project_id | String | Enterprise project ID. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | exist_running_task | Boolean | Whether the dataset contains running (including initialization) tasks. The options are as follows: | + | | | | + | | | - **true**: The dataset contains running tasks. | + | | | | + | | | - **false**: The dataset does not contain running tasks. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | exist_workforce_task | Boolean | Whether the dataset contains team labeling tasks. The options are as follows: | + | | | | + | | | - **true**: The dataset contains team labeling tasks. | + | | | | + | | | - **false**: The dataset does not contain team labeling tasks. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | feature_supports | Array of strings | List of features supported by the dataset. Currently, only the value **0** is supported, indicating that the OBS file size is limited. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_data | Boolean | Whether to import data. The options are as follows: | + | | | | + | | | - **true**: Import data. | + | | | | + | | | - **false**: Do not import data. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_task_id | String | ID of an import task. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_annotation_path | String | Path for storing the labeling result of a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_data_path | String | Path for storing the internal data of a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_log_path | String | Path for storing internal logs of a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_task_path | String | Path for internal task of a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_temp_path | String | Path for storing internal temporary files of a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inner_work_path | String | Output directory of a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_task_count | Integer | Number of labeling tasks. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labels | Array of `Label <#listdatasetsresponselabel>`__ objects | Dataset label list. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | loading_sample_count | Integer | Number of loading samples. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | managed | Boolean | Whether a dataset is hosted. The options are as follows: | + | | | | + | | | - **true**: The dataset is hosted. | + | | | | + | | | - **false**: The dataset is not hosted. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | next_version_num | Integer | Number of next versions of a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | running_tasks_id | Array of strings | ID list of running (including initialization) tasks. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | Array of `AnnotationFile <#listdatasetsresponseannotationfile>`__ objects | Sample list. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | schema | Array of `Field <#listdatasetsresponsefield>`__ objects | Schema list. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Dataset status. The options are as follows: | + | | | | + | | | - **0**: creating dataset | + | | | | + | | | - **1**: normal dataset | + | | | | + | | | - **2**: deleting dataset | + | | | | + | | | - **3**: deleted dataset | + | | | | + | | | - **4**: abnormal dataset | + | | | | + | | | - **5**: synchronizing dataset | + | | | | + | | | - **6**: releasing dataset | + | | | | + | | | - **7**: dataset in version switching | + | | | | + | | | - **8**: importing dataset | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | third_path | String | Third-party path. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of dataset samples. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sub_sample_count | Integer | Total number of subsamples generated from the parent samples. For example, the total number of key frame images extracted from the video labeling dataset is that of subsamples. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | unconfirmed_sample_count | Integer | Number of auto labeling samples to be confirmed. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a dataset is updated. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | versions | Array of `DatasetVersion <#listdatasetsresponsedatasetversion>`__ objects | Dataset version information. Currently, only the current version information of a dataset is recorded. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | work_path | String | Output dataset path, which is used to store output files such as label files. The path is an OBS path in the format of /*Bucket name*/*File path*. For example: /**obs-bucket**. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | work_path_type | Integer | Type of the dataset output path. The options are as follows: | + | | | | + | | | - **0**: OBS bucket (default value) | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_descriptor | `WorkforceDescriptor <#listdatasetsresponseworkforcedescriptor>`__ object | Team labeling information. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_count | Integer | Number of team labeling tasks of a dataset. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +----------------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListDatasetsresponseDataSource: + +.. table:: **Table 5** DataSource + + +-----------------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=================================================================+============================================================================================================================+ + | data_path | String | Data source path. | + +-----------------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | data_type | Integer | Data type. The options are as follows: | + | | | | + | | | - **0**: OBS bucket (default value) | + | | | | + | | | - **1**: GaussDB(DWS) | + | | | | + | | | - **2**: DLI | + | | | | + | | | - **3**: RDS | + | | | | + | | | - **4**: MRS | + | | | | + | | | - **5**: AI Gallery | + | | | | + | | | - **6**: Inference service | + +-----------------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | schema_maps | Array of `SchemaMap <#listdatasetsresponseschemamap>`__ objects | Schema mapping information corresponding to the table data. | + +-----------------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | source_info | `SourceInfo <#listdatasetsresponsesourceinfo>`__ object | Information required for importing a table data source. | + +-----------------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | Boolean | Whether the first row in the file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | + | | | - **true**: The first row in the file is the column name. | + | | | | + | | | - **false**: The first row in the file is not the column name. | + +-----------------------+-----------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListDatasetsresponseSchemaMap: + +.. table:: **Table 6** SchemaMap + + ========= ====== =============================== + Parameter Type Description + ========= ====== =============================== + dest_name String Name of the destination column. + src_name String Name of the source column. + ========= ====== =============================== + + + +.. _ListDatasetsresponseSourceInfo: + +.. table:: **Table 7** SourceInfo + + +-----------------------+-----------------------+--------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==============================================================+ + | cluster_id | String | ID of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | cluster_mode | String | Running mode of an MRS cluster. The options are as follows: | + | | | | + | | | - **0**: normal cluster | + | | | | + | | | - **1**: security cluster | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | cluster_name | String | Name of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | database_name | String | Name of the database to which the table dataset is imported. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | input | String | HDFS path of a table dataset. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | ip | String | IP address of your GaussDB(DWS) cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | port | String | Port number of your GaussDB(DWS) cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | queue_name | String | DLI queue name of a table dataset. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | subnet_id | String | Subnet ID of an MRS cluster. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | table_name | String | Name of the table to which a table dataset is imported. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | user_name | String | Username, which is mandatory for GaussDB(DWS) data. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | user_password | String | User password, which is mandatory for GaussDB(DWS) data. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + | vpc_id | String | ID of the VPC where an MRS cluster resides. | + +-----------------------+-----------------------+--------------------------------------------------------------+ + + + +.. _ListDatasetsresponseLabel: + +.. table:: **Table 8** Label + + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#listdatasetsresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#listdatasetsresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListDatasetsresponseLabelProperty: + +.. table:: **Table 9** LabelProperty + + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+=======================+================================================================================================================================================================================================================+ + | @modelarts:color | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | String | Default attribute: The new name of the label. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListDatasetsresponseAnnotationFile: + +.. table:: **Table 10** AnnotationFile + + =========== ================== ================================== + Parameter Type Description + =========== ================== ================================== + create_time Long Time when a sample is created. + dataset_id String Dataset ID. + depth Integer Number of image sample channels. + file_Name String Sample name. + file_id String Sample ID. + file_type String File type. + height Integer Image sample height. + size Long Image sample size. + tags Map Label information of a sample. + url String OBS address of the preview sample. + width Integer Image sample width. + =========== ================== ================================== + + + +.. _ListDatasetsresponseField: + +.. table:: **Table 11** Field + + =========== ======= =================== + Parameter Type Description + =========== ======= =================== + description String Schema description. + name String Schema name. + schema_id Integer Schema ID. + type String Schema value type. + =========== ======= =================== + + + +.. _ListDatasetsresponseDatasetVersion: + +.. table:: **Table 12** DatasetVersion + + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=================================+===================================================================+==========================================================================================================================================================================+ + | add_sample_count | Integer | Number of added samples. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotated_sample_count | Integer | Number of samples with labeled versions. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotated_sub_sample_count | Integer | Number of labeled subsamples. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | clear_hard_property | Boolean | Whether to clear hard example properties during release. The options are as follows: | + | | | | + | | | - **true**: Clear hard example properties. (Default value) | + | | | | + | | | - **false**: Do not clear hard example properties. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | code | String | Status code of a preprocessing task such as rotation and cropping. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a version is created. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop | Boolean | Whether to crop the image. This field is valid only for the object detection dataset whose labeling box is in the rectangle shape. The options are as follows: | + | | | | + | | | - **true**: Crop the image. | + | | | | + | | | - **false**: Do not crop the image. (Default value) | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop_path | String | Path for storing cropped files. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop_rotate_cache_path | String | Temporary directory for executing the rotation and cropping task. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_path | String | Path for storing data. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_statistics | Map | Sample statistics on a dataset, including the statistics on sample metadata in JSON format. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_validate | Boolean | Whether data is validated by the validation algorithm before release. The options are as follows: | + | | | | + | | | - **true**: The data has been validated. | + | | | | + | | | - **false**: The data has not been validated. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deleted_sample_count | Integer | Number of deleted samples. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_stats | Map | Deletion reason statistics. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description of a version. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_images | Boolean | Whether to export images to the version output directory during release. The options are as follows: | + | | | | + | | | - **true**: Export images to the version output directory. | + | | | | + | | | - **false**: Do not export images to the version output directory. (Default value) | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | extract_serial_number | Boolean | Whether to parse the subsample number during release. The field is valid for the healthcare dataset. The options are as follows: | + | | | | + | | | - **true**: Parse the subsample number. | + | | | | + | | | - **false**: Do not parse the subsample number. (Default value) | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | include_dataset_data | Boolean | Whether to include the source data of a dataset during release. The options are as follows: | + | | | | + | | | - **true**: The source data of a dataset is included. | + | | | | + | | | - **false**: The source data of a dataset is not included. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_current | Boolean | Whether the current dataset version is used. The options are as follows: | + | | | | + | | | - **true**: The current dataset version is used. | + | | | | + | | | - **false**: The current dataset version is not used. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_stats | Array of `LabelStats <#listdatasetsresponselabelstats>`__ objects | Label statistics list of a released version. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_type | String | Label type of a released version. The options are as follows: | + | | | | + | | | - **multi**: Multi-label samples are included. | + | | | | + | | | - **single**: All samples are single-labeled. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | manifest_cache_input_path | String | Input path for the **manifest** file cache during version release. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | manifest_path | String | Path for storing the **manifest** file with the released version. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | message | String | Task information recorded during release (for example, error information). | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | modified_sample_count | Integer | Number of modified samples. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_annotated_sample_count | Integer | Number of labeled samples of parent versions. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_total_sample_count | Integer | Total samples of parent versions. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_version_id | String | Parent version ID | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_id | String | ID of a preprocessing task such as rotation and cropping. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_status | Integer | Status of a preprocessing task such as rotation and cropping. The options are as follows: | + | | | | + | | | - **0**: initialized | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: completed | + | | | | + | | | - **3**: failed | + | | | | + | | | - **4**: stopped | + | | | | + | | | - **5**: timeout | + | | | | + | | | - **6**: deletion failed | + | | | | + | | | - **7**: stop failed | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | remove_sample_usage | Boolean | Whether to clear the existing usage information of a dataset during release. The options are as follows: | + | | | | + | | | - **true**: Clear the existing usage information of a dataset. (Default value) | + | | | | + | | | - **false**: Do not clear the existing usage information of a dataset. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rotate | Boolean | Whether to rotate the image. The options are as follows: | + | | | | + | | | - **true**: Rotate the image. | + | | | | + | | | - **false**: Do not rotate the image. (Default value) | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rotate_path | String | Path for storing the rotated file. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Status of a dataset version. The options are as follows: | + | | | | + | | | - **0**: creating | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: deleting | + | | | | + | | | - **3**: deleted | + | | | | + | | | - **4**: error | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | tags | Array of strings | Key identifier list of the dataset. The labeling type is used as the default label when the labeling task releases a version. For example, ["Image","Object detection"]. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_type | Integer | Labeling task type of the released version, which is the same as the dataset type. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of version samples. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sub_sample_count | Integer | Total number of subsamples generated from the parent samples. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_evaluate_sample_ratio | String | Split training and verification ratio during version release. The default value is **1.00**, indicating that all labeled samples are split into the training set. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a version is updated. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_format | String | Format of a dataset version. The options are as follows: | + | | | | + | | | - **Default**: default format | + | | | | + | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | + | | | - **CSV**: CSV | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Dataset version ID. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | Boolean | Whether the first row in the released CSV file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | + | | | - **true**: The first row in the released CSV file is a column name. | + | | | | + | | | - **false**: The first row in the released CSV file is not a column name. | + +---------------------------------+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListDatasetsresponseLabelStats: + +.. table:: **Table 13** LabelStats + + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#listdatasetsresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | count | Integer | Number of labels. | + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#listdatasetsresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | sample_count | Integer | Number of samples containing the label. | + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListDatasetsresponseLabelAttribute: + +.. table:: **Table 14** LabelAttribute + + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=====================================================================================+===================================================+ + | default_value | String | Default value of a label attribute. | + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | String | Label attribute ID. | + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | String | Label attribute name. | + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | String | Label attribute type. The options are as follows: | + | | | | + | | | - **text**: text | + | | | | + | | | - **select**: single-choice drop-down list | + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | Array of `LabelAttributeValue <#listdatasetsresponselabelattributevalue>`__ objects | List of label attribute values. | + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _ListDatasetsresponseLabelAttributeValue: + +.. table:: **Table 15** LabelAttributeValue + + ========= ====== ========================= + Parameter Type Description + ========= ====== ========================= + id String Label attribute value ID. + value String Label attribute value. + ========= ====== ========================= + + + +.. _ListDatasetsresponseWorkforceDescriptor: + +.. table:: **Table 16** WorkforceDescriptor + + +-----------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===================================+===========================================================+===============================================================================================================================================================================+ + | current_task_id | String | ID of a team labeling task. | + +-----------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | current_task_name | String | Name of a team labeling task. | + +-----------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | reject_num | Integer | Number of rejected samples. | + +-----------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | repetition | Integer | Number of persons who label each sample. The minimum value is **1**. | + +-----------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_synchronize_auto_labeling_data | Boolean | Whether to synchronously update auto labeling data. The options are as follows: | + | | | | + | | | - **true**: Update auto labeling data synchronously. | + | | | | + | | | - **false**: Do not update auto labeling data synchronously. | + +-----------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_synchronize_data | Boolean | Whether to synchronize updated data, such as uploading files, synchronizing data sources, and assigning imported unlabeled files to team members. The options are as follows: | + | | | | + | | | - **true**: Synchronize updated data to team members. | + | | | | + | | | - **false**: Do not synchronize updated data to team members. | + +-----------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workers | Array of `Worker <#listdatasetsresponseworker>`__ objects | List of labeling team members. | + +-----------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | String | Name of a labeling team. | + +-----------------------------------+-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListDatasetsresponseWorker: + +.. table:: **Table 17** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the Dataset List + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets?offset=0&limit=10&sort_by=create_time&order=desc&dataset_type=0&file_preview=true + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "total_number" : 1, + "datasets" : [ { + "dataset_id" : "gfghHSokody6AJigS5A", + "dataset_name" : "dataset-f9e8", + "dataset_type" : 0, + "data_format" : "Default", + "next_version_num" : 4, + "status" : 1, + "data_sources" : [ { + "data_type" : 0, + "data_path" : "/test-obs/classify/input/catDog4/" + } ], + "create_time" : 1605690595404, + "update_time" : 1605690595404, + "description" : "", + "current_version_id" : "54IXbeJhfttGpL46lbv", + "current_version_name" : "V003", + "total_sample_count" : 10, + "annotated_sample_count" : 10, + "work_path" : "/test-obs/classify/output/", + "inner_work_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/", + "inner_annotation_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/", + "inner_data_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/data/", + "inner_log_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/logs/", + "inner_temp_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/temp/", + "inner_task_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/task/", + "work_path_type" : 0, + "workspace_id" : "0", + "enterprise_project_id" : "0", + "exist_running_task" : false, + "exist_workforce_task" : false, + "running_tasks_id" : [ ], + "workforce_task_count" : 0, + "feature_supports" : [ "0" ], + "managed" : false, + "import_data" : false, + "ai_project" : "default-ai-project", + "label_task_count" : 1, + "dataset_format" : 0, + "dataset_version" : "v1", + "content_labeling" : true, + "samples" : [ { + "url" : "https://test-obs.obs.xxx.com:443/classify/input/catDog4/15.jpg?AccessKeyId=vprCCTY1NmHudlvC0bXr&Expires=1606100112&Signature=tuUo9jl6lqoMKAwNBz5g8dxO%2FdE%3D", + "create_time" : 1605690596035 + }, { + "url" : "https://test-obs.obs.xxx.com:443/classify/input/catDog4/8.jpg?AccessKeyId=vprCCTY1NmHudlvC0bXr&Expires=1606100112&Signature=NITOdBnkUXtdnKuEgDzZpkQzNfM%3D", + "create_time" : 1605690596046 + }, { + "url" : "https://test-obs.obs.xxx.com:443/classify/input/catDog4/9.jpg?AccessKeyId=vprCCTY1NmHudlvC0bXr&Expires=1606100112&Signature=%2BwUo1BL38%2F2d7p7anPi4fNzm1VU%3D", + "create_time" : 1605690596050 + }, { + "url" : "https://test-obs.obs.xxx.com:443/classify/input/catDog4/7.jpg?AccessKeyId=vprCCTY1NmHudlvC0bXr&Expires=1606100112&Signature=tOrHfcWo%2FEJ0wRzfi1M5Wk2MrXg%3D", + "create_time" : 1605690596043 + } ], + "files" : [ { + "url" : "https://test-obs.obs.xxx.com:443/classify/input/catDog4/15.jpg?AccessKeyId=vprCCTY1NmHudlvC0bXr&Expires=1606100112&Signature=tuUo9jl6lqoMKAwNBz5g8dxO%2FdE%3D", + "create_time" : 1605690596035 + }, { + "url" : "https://test-obs.obs.xxx.com:443/classify/input/catDog4/8.jpg?AccessKeyId=vprCCTY1NmHudlvC0bXr&Expires=1606100112&Signature=NITOdBnkUXtdnKuEgDzZpkQzNfM%3D", + "create_time" : 1605690596046 + }, { + "url" : "https://test-obs.obs.xxx.com:443/classify/input/catDog4/9.jpg?AccessKeyId=vprCCTY1NmHudlvC0bXr&Expires=1606100112&Signature=%2BwUo1BL38%2F2d7p7anPi4fNzm1VU%3D", + "create_time" : 1605690596050 + }, { + "url" : "https://test-obs.obs.xxx.com:443/classify/input/catDog4/7.jpg?AccessKeyId=vprCCTY1NmHudlvC0bXr&Expires=1606100112&Signature=tOrHfcWo%2FEJ0wRzfi1M5Wk2MrXg%3D", + "create_time" : 1605690596043 + } ] + } ] + } + +Status Codes +------------ + + + +.. _ListDatasetsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_version_management/creating_a_dataset_labeling_version.rst b/api-ref/source/data_management/dataset_version_management/creating_a_dataset_labeling_version.rst new file mode 100644 index 0000000..ee68571 --- /dev/null +++ b/api-ref/source/data_management/dataset_version_management/creating_a_dataset_labeling_version.rst @@ -0,0 +1,140 @@ +Creating a Dataset Labeling Version +=================================== + +Function +-------- + +This API is used to create a dataset labeling version. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/versions + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateDatasetVersionrequestCreateDatasetVersionReq: + +.. table:: **Table 2** Request body parameters + + +-----------------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============================+=================+=================+===================================================================================================================================================================+ + | clear_hard_property | No | Boolean | Whether to clear hard example properties. The options are as follows: | + | | | | | + | | | | - **true**: Clear hard example properties. (Default value) | + | | | | | + | | | | - **false**: Do not clear hard example properties. | + +-----------------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Version description. The value is empty by default. The description contains 0 to 256 characters and does not support the following special characters: !<>=&"' | + +-----------------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_images | No | Boolean | Whether to export images to the version output directory during release. The options are as follows: | + | | | | | + | | | | - **true**: Export images to the version output directory. | + | | | | | + | | | | - **false**: Do not export images to the version output directory. (Default value) | + +-----------------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | remove_sample_usage | No | Boolean | Whether to clear the existing usage information of a dataset during release. The options are as follows: | + | | | | | + | | | | - **true**: Clear the existing usage information of a dataset. (Default value) | + | | | | | + | | | | - **false**: Do not clear the existing usage information of a dataset. | + +-----------------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_evaluate_sample_ratio | No | String | Split training and verification ratio during version release. The default value is **1.00**, indicating that all labeled samples are split into the training set. | + +-----------------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_format | No | String | Format of a dataset version. The options are as follows: | + | | | | | + | | | | - **Default**: default format | + | | | | | + | | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | | + | | | | - **CSV**: CSV | + +-----------------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | No | String | Version name. The value contains 1 to 32 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed. | + +-----------------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | No | Boolean | Whether to write the column name in the first line of the CSV file during release. This field is valid for the table dataset. The options are as follows: | + | | | | | + | | | | - **true**: Write the column name in the first line of the CSV file. (Default value) | + | | | | | + | | | | - **false**: Do not write the column name in the first line of the CSV file. | + +-----------------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 201** + + + +.. _CreateDatasetVersionresponseCreateDatasetVersionResp: + +.. table:: **Table 3** Response body parameters + + ========== ====== =================== + Parameter Type Description + ========== ====== =================== + version_id String Dataset version ID. + ========== ====== =================== + +Example Requests +---------------- + +Creating a Dataset Labeling Version + +.. code-block:: + + { + "version_name" : "V004", + "version_format" : "Default", + "description" : "", + "clear_hard_property" : true + } + +Example Responses +----------------- + +**Status code: 201** + +Created + +.. code-block:: + + { + "version_id" : "sntOdOuB0D9C6fC4TXs" + } + +Status Codes +------------ + + + +.. _CreateDatasetVersionstatuscode: + +=========== ============ +Status Code Description +=========== ============ +201 Created +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_version_management/deleting_a_dataset_labeling_version.rst b/api-ref/source/data_management/dataset_version_management/deleting_a_dataset_labeling_version.rst new file mode 100644 index 0000000..d70412a --- /dev/null +++ b/api-ref/source/data_management/dataset_version_management/deleting_a_dataset_labeling_version.rst @@ -0,0 +1,76 @@ +Deleting a Dataset Labeling Version +=================================== + +Function +-------- + +This API is used to delete a dataset labeling version. + +URI +--- + +DELETE /v2/{project_id}/datasets/{dataset_id}/versions/{version_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | String | Dataset version ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Deleting a Dataset Labeling Version + +.. code-block:: + + DELETE https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/versions/{version_id} + +Example Responses +----------------- + +**Status code: 204** + +No Content + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _DeleteDatasetVersionstatuscode: + +=========== ============ +Status Code Description +=========== ============ +204 No Content +401 Unauthorized +403 Forbidden +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_version_management/index.rst b/api-ref/source/data_management/dataset_version_management/index.rst new file mode 100644 index 0000000..2867727 --- /dev/null +++ b/api-ref/source/data_management/dataset_version_management/index.rst @@ -0,0 +1,11 @@ +========================== +Dataset Version Management +========================== + +.. toctree:: + :maxdepth: 1 + + querying_the_dataset_version_list + creating_a_dataset_labeling_version + querying_details_about_a_dataset_version + deleting_a_dataset_labeling_version diff --git a/api-ref/source/data_management/dataset_version_management/querying_details_about_a_dataset_version.rst b/api-ref/source/data_management/dataset_version_management/querying_details_about_a_dataset_version.rst new file mode 100644 index 0000000..6dd331e --- /dev/null +++ b/api-ref/source/data_management/dataset_version_management/querying_details_about_a_dataset_version.rst @@ -0,0 +1,432 @@ +Querying Details About a Dataset Version +======================================== + +Function +-------- + +This API is used to query the details about a dataset version. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/versions/{version_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | String | Dataset version ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DescribeDatasetVersionresponseDatasetVersion: + +.. table:: **Table 2** Response body parameters + + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=================================+=============================================================================+==========================================================================================================================================================================+ + | add_sample_count | Integer | Number of added samples. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotated_sample_count | Integer | Number of samples with labeled versions. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotated_sub_sample_count | Integer | Number of labeled subsamples. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | clear_hard_property | Boolean | Whether to clear hard example properties during release. The options are as follows: | + | | | | + | | | - **true**: Clear hard example properties. (Default value) | + | | | | + | | | - **false**: Do not clear hard example properties. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | code | String | Status code of a preprocessing task such as rotation and cropping. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a version is created. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop | Boolean | Whether to crop the image. This field is valid only for the object detection dataset whose labeling box is in the rectangle shape. The options are as follows: | + | | | | + | | | - **true**: Crop the image. | + | | | | + | | | - **false**: Do not crop the image. (Default value) | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop_path | String | Path for storing cropped files. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop_rotate_cache_path | String | Temporary directory for executing the rotation and cropping task. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_path | String | Path for storing data. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_statistics | Map | Sample statistics on a dataset, including the statistics on sample metadata in JSON format. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_validate | Boolean | Whether data is validated by the validation algorithm before release. The options are as follows: | + | | | | + | | | - **true**: The data has been validated. | + | | | | + | | | - **false**: The data has not been validated. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deleted_sample_count | Integer | Number of deleted samples. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_stats | Map | Deletion reason statistics. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description of a version. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_images | Boolean | Whether to export images to the version output directory during release. The options are as follows: | + | | | | + | | | - **true**: Export images to the version output directory. | + | | | | + | | | - **false**: Do not export images to the version output directory. (Default value) | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | extract_serial_number | Boolean | Whether to parse the subsample number during release. The field is valid for the healthcare dataset. The options are as follows: | + | | | | + | | | - **true**: Parse the subsample number. | + | | | | + | | | - **false**: Do not parse the subsample number. (Default value) | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | include_dataset_data | Boolean | Whether to include the source data of a dataset during release. The options are as follows: | + | | | | + | | | - **true**: The source data of a dataset is included. | + | | | | + | | | - **false**: The source data of a dataset is not included. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_current | Boolean | Whether the current dataset version is used. The options are as follows: | + | | | | + | | | - **true**: The current dataset version is used. | + | | | | + | | | - **false**: The current dataset version is not used. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_stats | Array of `LabelStats <#describedatasetversionresponselabelstats>`__ objects | Label statistics list of a released version. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_type | String | Label type of a released version. The options are as follows: | + | | | | + | | | - **multi**: Multi-label samples are included. | + | | | | + | | | - **single**: All samples are single-labeled. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | manifest_cache_input_path | String | Input path for the **manifest** file cache during version release. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | manifest_path | String | Path for storing the **manifest** file with the released version. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | message | String | Task information recorded during release (for example, error information). | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | modified_sample_count | Integer | Number of modified samples. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_annotated_sample_count | Integer | Number of labeled samples of parent versions. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_total_sample_count | Integer | Total samples of parent versions. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_version_id | String | Parent version ID | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_id | String | ID of a preprocessing task such as rotation and cropping. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_status | Integer | Status of a preprocessing task such as rotation and cropping. The options are as follows: | + | | | | + | | | - **0**: initialized | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: completed | + | | | | + | | | - **3**: failed | + | | | | + | | | - **4**: stopped | + | | | | + | | | - **5**: timeout | + | | | | + | | | - **6**: deletion failed | + | | | | + | | | - **7**: stop failed | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | remove_sample_usage | Boolean | Whether to clear the existing usage information of a dataset during release. The options are as follows: | + | | | | + | | | - **true**: Clear the existing usage information of a dataset. (Default value) | + | | | | + | | | - **false**: Do not clear the existing usage information of a dataset. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rotate | Boolean | Whether to rotate the image. The options are as follows: | + | | | | + | | | - **true**: Rotate the image. | + | | | | + | | | - **false**: Do not rotate the image. (Default value) | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rotate_path | String | Path for storing the rotated file. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Status of a dataset version. The options are as follows: | + | | | | + | | | - **0**: creating | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: deleting | + | | | | + | | | - **3**: deleted | + | | | | + | | | - **4**: error | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | tags | Array of strings | Key identifier list of the dataset. The labeling type is used as the default label when the labeling task releases a version. For example, ["Image","Object detection"]. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_type | Integer | Labeling task type of the released version, which is the same as the dataset type. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of version samples. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sub_sample_count | Integer | Total number of subsamples generated from the parent samples. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_evaluate_sample_ratio | String | Split training and verification ratio during version release. The default value is **1.00**, indicating that all labeled samples are split into the training set. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a version is updated. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_format | String | Format of a dataset version. The options are as follows: | + | | | | + | | | - **Default**: default format | + | | | | + | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | + | | | - **CSV**: CSV | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Dataset version ID. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | Boolean | Whether the first row in the released CSV file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | + | | | - **true**: The first row in the released CSV file is a column name. | + | | | | + | | | - **false**: The first row in the released CSV file is not a column name. | + +---------------------------------+-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeDatasetVersionresponseLabelStats: + +.. table:: **Table 3** LabelStats + + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=====================================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#describedatasetversionresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | count | Integer | Number of labels. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#describedatasetversionresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | sample_count | Integer | Number of samples containing the label. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeDatasetVersionresponseLabelAttribute: + +.. table:: **Table 4** LabelAttribute + + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===============================================================================================+===================================================+ + | default_value | String | Default value of a label attribute. | + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | String | Label attribute ID. | + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | String | Label attribute name. | + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | String | Label attribute type. The options are as follows: | + | | | | + | | | - **text**: text | + | | | | + | | | - **select**: single-choice drop-down list | + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | Array of `LabelAttributeValue <#describedatasetversionresponselabelattributevalue>`__ objects | List of label attribute values. | + +-----------------------+-----------------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _DescribeDatasetVersionresponseLabelAttributeValue: + +.. table:: **Table 5** LabelAttributeValue + + ========= ====== ========================= + Parameter Type Description + ========= ====== ========================= + id String Label attribute value ID. + value String Label attribute value. + ========= ====== ========================= + + + +.. _DescribeDatasetVersionresponseLabelProperty: + +.. table:: **Table 6** LabelProperty + + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+=======================+================================================================================================================================================================================================================+ + | @modelarts:color | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | String | Default attribute: The new name of the label. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About a Dataset Version + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/versions/{version_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "version_id" : "eSOKEQaXhKzxN00WKoV", + "version_name" : "V002", + "version_format" : "Default", + "previous_version_id" : "vlGvUqOcxxGPIB0ugeE", + "status" : 1, + "create_time" : 1605691027084, + "total_sample_count" : 10, + "annotated_sample_count" : 10, + "total_sub_sample_count" : 0, + "annotated_sub_sample_count" : 0, + "manifest_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V002/V002.manifest", + "data_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V002/data/", + "is_current" : true, + "train_evaluate_sample_ratio" : "0.9999", + "remove_sample_usage" : false, + "export_images" : false, + "description" : "", + "label_stats" : [ { + "name" : "Cat", + "type" : 0, + "property" : { + "@modelarts:color" : "#3399ff" + }, + "count" : 5, + "sample_count" : 5 + }, { + "name" : "Dog", + "type" : 0, + "property" : { + "@modelarts:color" : "#3399ff" + }, + "count" : 5, + "sample_count" : 5 + } ], + "label_type" : "single", + "task_type" : 0, + "extract_serial_number" : false + } + +Status Codes +------------ + + + +.. _DescribeDatasetVersionstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/dataset_version_management/querying_the_dataset_version_list.rst b/api-ref/source/data_management/dataset_version_management/querying_the_dataset_version_list.rst new file mode 100644 index 0000000..8265593 --- /dev/null +++ b/api-ref/source/data_management/dataset_version_management/querying_the_dataset_version_list.rst @@ -0,0 +1,496 @@ +Querying the Dataset Version List +================================= + +Function +-------- + +This API is used to query the version list of a specific dataset. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/versions + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +======================+=================+=================+==============================================================================================================================================================================================================================================================================================================================================================================+ + | status | No | Integer | Status of a dataset version. The options are as follows: | + | | | | | + | | | | - **0**: creating | + | | | | | + | | | | - **1**: running | + | | | | | + | | | | - **2**: deleting | + | | | | | + | | | | - **3**: deleted | + | | | | | + | | | | - **4**: error | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_evaluate_ratio | No | String | Version split ratio for version filtering. The numbers before and after the comma indicate the minimum and maximum split ratios, and the versions whose split ratios are within the range are filtered out, for example, **0.0,1.0**. Note: If this parameter is left blank or unavailable, the system does not filter datasets based on the version split ratio by default. | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_format | No | Integer | Format of a dataset version. The options are as follows: | + | | | | | + | | | | - **0**: default format | + | | | | | + | | | | - **1**: CarbonData (supported only by table datasets) | + | | | | | + | | | | - **2**: CSV | + +----------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListDatasetVersionsresponseListDatasetVersionsResp: + +.. table:: **Table 3** Response body parameters + + +--------------+----------------------------------------------------------------------------------+-----------------------------------+ + | Parameter | Type | Description | + +==============+==================================================================================+===================================+ + | total_number | Integer | Total number of dataset versions. | + +--------------+----------------------------------------------------------------------------------+-----------------------------------+ + | versions | Array of `DatasetVersion <#listdatasetversionsresponsedatasetversion>`__ objects | Dataset version list. | + +--------------+----------------------------------------------------------------------------------+-----------------------------------+ + + + +.. _ListDatasetVersionsresponseDatasetVersion: + +.. table:: **Table 4** DatasetVersion + + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=================================+==========================================================================+==========================================================================================================================================================================+ + | add_sample_count | Integer | Number of added samples. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotated_sample_count | Integer | Number of samples with labeled versions. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotated_sub_sample_count | Integer | Number of labeled subsamples. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | clear_hard_property | Boolean | Whether to clear hard example properties during release. The options are as follows: | + | | | | + | | | - **true**: Clear hard example properties. (Default value) | + | | | | + | | | - **false**: Do not clear hard example properties. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | code | String | Status code of a preprocessing task such as rotation and cropping. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a version is created. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop | Boolean | Whether to crop the image. This field is valid only for the object detection dataset whose labeling box is in the rectangle shape. The options are as follows: | + | | | | + | | | - **true**: Crop the image. | + | | | | + | | | - **false**: Do not crop the image. (Default value) | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop_path | String | Path for storing cropped files. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | crop_rotate_cache_path | String | Temporary directory for executing the rotation and cropping task. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_path | String | Path for storing data. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_statistics | Map | Sample statistics on a dataset, including the statistics on sample metadata in JSON format. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_validate | Boolean | Whether data is validated by the validation algorithm before release. The options are as follows: | + | | | | + | | | - **true**: The data has been validated. | + | | | | + | | | - **false**: The data has not been validated. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deleted_sample_count | Integer | Number of deleted samples. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_stats | Map | Deletion reason statistics. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description of a version. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_images | Boolean | Whether to export images to the version output directory during release. The options are as follows: | + | | | | + | | | - **true**: Export images to the version output directory. | + | | | | + | | | - **false**: Do not export images to the version output directory. (Default value) | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | extract_serial_number | Boolean | Whether to parse the subsample number during release. The field is valid for the healthcare dataset. The options are as follows: | + | | | | + | | | - **true**: Parse the subsample number. | + | | | | + | | | - **false**: Do not parse the subsample number. (Default value) | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | include_dataset_data | Boolean | Whether to include the source data of a dataset during release. The options are as follows: | + | | | | + | | | - **true**: The source data of a dataset is included. | + | | | | + | | | - **false**: The source data of a dataset is not included. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_current | Boolean | Whether the current dataset version is used. The options are as follows: | + | | | | + | | | - **true**: The current dataset version is used. | + | | | | + | | | - **false**: The current dataset version is not used. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_stats | Array of `LabelStats <#listdatasetversionsresponselabelstats>`__ objects | Label statistics list of a released version. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_type | String | Label type of a released version. The options are as follows: | + | | | | + | | | - **multi**: Multi-label samples are included. | + | | | | + | | | - **single**: All samples are single-labeled. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | manifest_cache_input_path | String | Input path for the **manifest** file cache during version release. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | manifest_path | String | Path for storing the **manifest** file with the released version. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | message | String | Task information recorded during release (for example, error information). | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | modified_sample_count | Integer | Number of modified samples. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_annotated_sample_count | Integer | Number of labeled samples of parent versions. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_total_sample_count | Integer | Total samples of parent versions. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | previous_version_id | String | Parent version ID | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_id | String | ID of a preprocessing task such as rotation and cropping. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | processor_task_status | Integer | Status of a preprocessing task such as rotation and cropping. The options are as follows: | + | | | | + | | | - **0**: initialized | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: completed | + | | | | + | | | - **3**: failed | + | | | | + | | | - **4**: stopped | + | | | | + | | | - **5**: timeout | + | | | | + | | | - **6**: deletion failed | + | | | | + | | | - **7**: stop failed | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | remove_sample_usage | Boolean | Whether to clear the existing usage information of a dataset during release. The options are as follows: | + | | | | + | | | - **true**: Clear the existing usage information of a dataset. (Default value) | + | | | | + | | | - **false**: Do not clear the existing usage information of a dataset. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rotate | Boolean | Whether to rotate the image. The options are as follows: | + | | | | + | | | - **true**: Rotate the image. | + | | | | + | | | - **false**: Do not rotate the image. (Default value) | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rotate_path | String | Path for storing the rotated file. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Status of a dataset version. The options are as follows: | + | | | | + | | | - **0**: creating | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: deleting | + | | | | + | | | - **3**: deleted | + | | | | + | | | - **4**: error | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | tags | Array of strings | Key identifier list of the dataset. The labeling type is used as the default label when the labeling task releases a version. For example, ["Image","Object detection"]. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_type | Integer | Labeling task type of the released version, which is the same as the dataset type. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of version samples. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_sub_sample_count | Integer | Total number of subsamples generated from the parent samples. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_evaluate_sample_ratio | String | Split training and verification ratio during version release. The default value is **1.00**, indicating that all labeled samples are split into the training set. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a version is updated. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_format | String | Format of a dataset version. The options are as follows: | + | | | | + | | | - **Default**: default format | + | | | | + | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | + | | | - **CSV**: CSV | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Dataset version ID. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | Boolean | Whether the first row in the released CSV file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | + | | | - **true**: The first row in the released CSV file is a column name. | + | | | | + | | | - **false**: The first row in the released CSV file is not a column name. | + +---------------------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListDatasetVersionsresponseLabelStats: + +.. table:: **Table 5** LabelStats + + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==================================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#listdatasetversionsresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | count | Integer | Number of labels. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#listdatasetversionsresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | sample_count | Integer | Number of samples containing the label. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListDatasetVersionsresponseLabelAttribute: + +.. table:: **Table 6** LabelAttribute + + +-----------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Type | Description | + +=======================+============================================================================================+===================================================+ + | default_value | String | Default value of a label attribute. | + +-----------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | String | Label attribute ID. | + +-----------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | String | Label attribute name. | + +-----------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | String | Label attribute type. The options are as follows: | + | | | | + | | | - **text**: text | + | | | | + | | | - **select**: single-choice drop-down list | + +-----------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | Array of `LabelAttributeValue <#listdatasetversionsresponselabelattributevalue>`__ objects | List of label attribute values. | + +-----------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _ListDatasetVersionsresponseLabelAttributeValue: + +.. table:: **Table 7** LabelAttributeValue + + ========= ====== ========================= + Parameter Type Description + ========= ====== ========================= + id String Label attribute value ID. + value String Label attribute value. + ========= ====== ========================= + + + +.. _ListDatasetVersionsresponseLabelProperty: + +.. table:: **Table 8** LabelProperty + + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+=======================+================================================================================================================================================================================================================+ + | @modelarts:color | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | String | Default attribute: The new name of the label. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the Version List of a Specific Dataset + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/versions + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "total_number" : 3, + "versions" : [ { + "version_id" : "54IXbeJhfttGpL46lbv", + "version_name" : "V003", + "version_format" : "Default", + "previous_version_id" : "eSOKEQaXhKzxN00WKoV", + "status" : 1, + "create_time" : 1605930512183, + "total_sample_count" : 10, + "annotated_sample_count" : 10, + "total_sub_sample_count" : 0, + "annotated_sub_sample_count" : 0, + "manifest_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V003/V003.manifest", + "data_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V003/data/", + "is_current" : true, + "train_evaluate_sample_ratio" : "0.8", + "remove_sample_usage" : false, + "export_images" : false, + "description" : "", + "task_type" : 0, + "extract_serial_number" : false + }, { + "version_id" : "eSOKEQaXhKzxN00WKoV", + "version_name" : "V002", + "version_format" : "Default", + "previous_version_id" : "vlGvUqOcxxGPIB0ugeE", + "status" : 1, + "create_time" : 1605691027084, + "total_sample_count" : 10, + "annotated_sample_count" : 10, + "total_sub_sample_count" : 0, + "annotated_sub_sample_count" : 0, + "manifest_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V002/V002.manifest", + "data_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V002/data/", + "is_current" : false, + "train_evaluate_sample_ratio" : "0.9999", + "remove_sample_usage" : false, + "export_images" : false, + "description" : "", + "task_type" : 0, + "extract_serial_number" : false + }, { + "version_id" : "vlGvUqOcxxGPIB0ugeE", + "version_name" : "V001", + "version_format" : "Default", + "status" : 1, + "create_time" : 1605690687346, + "total_sample_count" : 10, + "annotated_sample_count" : 10, + "total_sub_sample_count" : 0, + "annotated_sub_sample_count" : 0, + "manifest_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V001/V001.manifest", + "data_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V001/data/", + "is_current" : false, + "train_evaluate_sample_ratio" : "0.99", + "remove_sample_usage" : false, + "export_images" : false, + "description" : "", + "task_type" : 0, + "extract_serial_number" : false + } ] + } + +Status Codes +------------ + + + +.. _ListDatasetVersionsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/index.rst b/api-ref/source/data_management/index.rst new file mode 100644 index 0000000..8596e39 --- /dev/null +++ b/api-ref/source/data_management/index.rst @@ -0,0 +1,22 @@ +=============== +Data Management +=============== + +.. toctree:: + :maxdepth: 1 + + data_management_apis + dataset_management/index + dataset_version_management/index + sample_management/index + label_management/index + manual_labeling/index + labeling_task_management/index + team_labeling_process_management/index + labeling_team_management/index + labeling_team_member_management/index + data_import_task/index + data_export_task/index + data_synchronization_task/index + intelligent_task/index + processing_task/index diff --git a/api-ref/source/data_management/intelligent_task/index.rst b/api-ref/source/data_management/intelligent_task/index.rst new file mode 100644 index 0000000..e4dcc7d --- /dev/null +++ b/api-ref/source/data_management/intelligent_task/index.rst @@ -0,0 +1,13 @@ +================ +Intelligent Task +================ + +.. toctree:: + :maxdepth: 1 + + querying_auto_labeling_sample_list + querying_details_about_an_auto_labeling_sample + querying_the_intelligent_task_list_by_page + starting_intelligent_tasks + obtaining_information_about_intelligent_tasks + stopping_an_intelligent_task diff --git a/api-ref/source/data_management/intelligent_task/obtaining_information_about_intelligent_tasks.rst b/api-ref/source/data_management/intelligent_task/obtaining_information_about_intelligent_tasks.rst new file mode 100644 index 0000000..e52ac82 --- /dev/null +++ b/api-ref/source/data_management/intelligent_task/obtaining_information_about_intelligent_tasks.rst @@ -0,0 +1,958 @@ +Obtaining Information About Intelligent Tasks +============================================= + +Function +-------- + +This API is used to obtain information about intelligent tasks, including auto labeling, one-click model deployment, and auto grouping tasks. You can specify the **task_id** parameter to query the details about a specific task. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/tasks/{task_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | Task ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _AutoAnnotationProgressresponseSmartTaskProgressResp: + +.. table:: **Table 2** Response body parameters + + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | Parameter | Type | Description | + +=======================+=============================================================================+===========================+ + | code | String | Task running status code. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | config | `SmartTaskConfig <#autoannotationprogressresponsesmarttaskconfig>`__ object | Task configuration. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | create_time | String | Task creation time. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | elapsed_time | Long | Execution time. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | error_code | String | Error code. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | error_detail | String | Error details. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | message | String | Task running information. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | progress | Float | Task progress percentage. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | resource_id | String | Resource ID. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | result | `Result <#autoannotationprogressresponseresult>`__ object | Task result. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | status | Integer | Task status. Options: | + | | | | + | | | - **-1**: queuing | + | | | | + | | | - **0**: initialized | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: failed | + | | | | + | | | - **3**: succeeded | + | | | | + | | | - **4**: stopping | + | | | | + | | | - **5**: stopped | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | task_id | String | Task ID. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + | task_name | String | Task name. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------+ + + + +.. _AutoAnnotationProgressresponseSmartTaskConfig: + +.. table:: **Table 3** SmartTaskConfig + + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=========================+===========================================================================================+=======================================================================================================================================================================================================================================================================================================================================================+ + | algorithm_type | String | Algorithm type for auto labeling. Options: | + | | | | + | | | - **fast**: Only labeled samples are used for training. This type of algorithm achieves faster labeling. | + | | | | + | | | - **accurate**: In addition to labeled samples, unlabeled samples are used for semi-supervised training. This type of algorithm achieves more accurate labeling. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ambiguity | Boolean | Whether to perform clustering based on the image blurring degree. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotation_output | String | Output path of the active learning labeling result. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | collect_rule | String | Sample collection rule. The default value is **all**, indicating full collection. Currently, only value **all** is available. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | collect_sample | Boolean | Whether to enable sample collection. The options are as follows: | + | | | | + | | | - **true**: Enable sample collection. (Default value) | + | | | | + | | | - **false**: Do not enable sample collection. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | confidence_scope | String | Confidence range of key samples. The minimum and maximum values are separated by hyphens (-). Example: 0.10-0.90. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Task description. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_name | String | Engine name. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_format | Integer | Format of the exported directory. The options are as follows: | + | | | | + | | | - **1**: tree structure. For example: cat/1.jpg,dog/2.jpg. | + | | | | + | | | - **2**: tile structure. For example: 1.jpg, 1.txt; 2.jpg,2.txt. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_params | `ExportParams <#autoannotationprogressresponseexportparams>`__ object | Parameters of a dataset export task. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | `Flavor <#autoannotationprogressresponseflavor>`__ object | Training resource flavor. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | image_brightness | Boolean | Whether to perform clustering based on the image brightness. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | image_colorfulness | Boolean | Whether to perform clustering based on the image color. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inf_cluster_id | String | ID of a dedicated cluster. This parameter is left blank by default, indicating that a dedicated cluster is not used. When using the dedicated cluster to deploy services, ensure that the cluster status is normal. After this parameter is set, the network configuration of the cluster is used, and the **vpc_id** parameter does not take effect. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inf_config_list | Array of `InfConfig <#autoannotationprogressresponseinfconfig>`__ objects | Configuration list required for running an inference task, which is optional and left blank by default. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inf_output | String | Output path of inference in active learning. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | infer_result_output_dir | String | OBS directory for storing sample prediction results. This parameter is optional. The {*service_id*}\ **-infer-result** subdirectory in the **output_dir** directory is used by default. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | key_sample_output | String | Output path of hard examples in active learning. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_url | String | OBS URL of the logs of a training job. By default, this parameter is left blank. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | manifest_path | String | Path of the **manifest** file, which is used as the input for training and inference. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | String | Model ID. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_name | String | Model name. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_parameter | String | Model parameter. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_version | String | Model version. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | n_clusters | Integer | Number of clusters. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Task name. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | output_dir | String | Sample output path. The format is as follows: *Dataset output path*/*Dataset name*-*Dataset ID*/annotation/auto-deploy/. Example: **/test/work_1608083108676/dataset123-g6IO9qSu6hoxwCAirfm/annotation/auto-deploy/**. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parameters | Array of `TrainingParameter <#autoannotationprogressresponsetrainingparameter>`__ objects | Running parameters of a training job. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_id | String | ID of a resource pool. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | String | Attribute name. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | req_uri | String | Inference path of a batch job. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | result_type | Integer | Processing mode of auto grouping results. The options are as follows: | + | | | | + | | | - **0**: Save to OBS. | + | | | | + | | | - **1**: Save to samples. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | Array of `SampleLabels <#autoannotationprogressresponsesamplelabels>`__ objects | List of labeling information for samples to be auto labeled. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | stop_time | Integer | Timeout interval, in minutes. The default value is 15 minutes. This parameter is used only in the scenario of auto labeling for videos. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time | String | Timestamp in active learning. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_data_path | String | Path for storing existing training datasets. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | String | URL of the OBS path where the file of a training job is outputted. By default, this parameter is left blank. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_format | String | Format of a dataset version. The options are as follows: | + | | | | + | | | - **Default**: default format | + | | | | + | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | + | | | - **CSV**: CSV | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_server_num | Integer | Number of workers in a training job. | + +-------------------------+-------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseExportParams: + +.. table:: **Table 4** ExportParams + + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===============================+=======================================================================================+============================================================================================================================================================================+ + | clear_hard_property | Boolean | Whether to clear hard example attributes. The options are as follows: | + | | | | + | | | - **true**: Clear hard example attributes. (Default value) | + | | | | + | | | - **false**: Do not clear hard example attributes. | + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_format | String | Format of the dataset version to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_name | String | Name of the dataset version to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dest | String | Export destination. The options are as follows: | + | | | | + | | | - **DIR**: Export data to OBS. (Default value) | + | | | | + | | | - **NEW_DATASET**: Export data to a new dataset. | + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_name | String | Name of the new dataset to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_work_path | String | Working directory of the new dataset to which data is exported. | + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ratio_sample_usage | Boolean | Whether to randomly allocate the training set and validation set based on the specified ratio. The options are as follows: | + | | | | + | | | - **true**: Allocate the training set and validation set. | + | | | | + | | | - **false**: Do not allocate the training set and validation set. (Default value) | + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | Array of strings | ID list of exported samples. | + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_conditions | Array of `SearchCondition <#autoannotationprogressresponsesearchcondition>`__ objects | Exported search conditions. The relationship between multiple search conditions is OR. | + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_sample_ratio | String | Split ratio of training set and verification set during specified version release. The default value is **1.00**, indicating that all released versions are training sets. | + +-------------------------------+---------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseSearchCondition: + +.. table:: **Table 5** SearchCondition + + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================================================================+==================================================================================================================================================================================================================================================================+ + | coefficient | String | Filter by coefficient of difficulty. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | frame_in_video | Integer | A frame in the video. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | hard | String | Whether a sample is a hard sample. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_origin | String | Filter by data source. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | kvp | String | CT dosage, filtered by dosage. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_list | `SearchLabels <#autoannotationprogressresponsesearchlabels>`__ object | Label search criteria. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labeler | String | Labeler. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SearchProp <#autoannotationprogressresponsesearchprop>`__ object | Search by sample attribute. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parent_sample_id | String | Parent sample ID. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Directory where data samples are stored (the directory must end with a slash (/)). Only samples in the specified directory are searched for. Recursive search of directories is not supported. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Search by sample name, including the file name extension. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | String | When a sample is added to the dataset, an index is created based on the last modification time (accurate to day) of the sample on OBS. You can search for the sample based on the time. The options are as follows: | + | | | | + | | | - **month**: Search for samples added from 30 days ago to the current day. | + | | | | + | | | - **day**: Search for samples added from yesterday (one day ago) to the current day. | + | | | | + | | | - **yyyyMMdd-yyyyMMdd**: Search for samples added in a specified period (at most 30 days), in the format of **Start date-End date**. For example, **20190901-2019091501** indicates that samples generated from September 1 to September 15, 2019 are searched. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Search by confidence. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | slice_thickness | String | DICOM layer thickness. Samples are filtered by layer thickness. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | study_date | String | DICOM scanning time. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time_in_video | String | A time point in the video. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseSearchLabels: + +.. table:: **Table 6** SearchLabels + + +-----------------------+-------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===============================================================================+==============================================================================================================================================================+ + | labels | Array of `SearchLabel <#autoannotationprogressresponsesearchlabel>`__ objects | List of label search criteria. | + +-----------------------+-------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | If you want to search for multiple labels, **op** must be specified. If you search for only one label, **op** can be left blank. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+-------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseSearchLabel: + +.. table:: **Table 7** SearchLabel + + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+========================================================================================================================================================================================================================================================================================+ + | name | String | Label name. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | Operation type between multiple attributes. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | Map> | Label attribute, which is in the Object format and stores any key-value pairs. **key** indicates the attribute name, and **value** indicates the value list. If **value** is **null**, the search is not performed by value. Otherwise, the search value can be any value in the list. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseSearchProp: + +.. table:: **Table 8** SearchProp + + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+=======================================================================+ + | op | String | Relationship between attribute values. The options are as follows: | + | | | | + | | | - **AND**: AND relationship | + | | | | + | | | - **OR**: OR relationship | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | props | Map> | Search criteria of an attribute. Multiple search criteria can be set. | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseFlavor: + +.. table:: **Table 9** Flavor + + +-----------+--------+------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+==============================================================================+ + | code | String | Attribute code of a resource specification, which is used for task creating. | + +-----------+--------+------------------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseInfConfig: + +.. table:: **Table 10** InfConfig + + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+====================+============================================================================================================================================================================================================================================+ + | envs | Map | (Optional) Environment variable key-value pair required for running a model. By default, this parameter is left blank. To ensure data security, do not enter sensitive information, such as plaintext passwords, in environment variables. | + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_count | Integer | Instance number of model deployment, that is, the number of compute nodes. | + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | String | Model ID. | + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | specification | String | Resource specifications of real-time services. For details, see `Deploying Services <../../service_management/deploying_a_model_as_a_service.html>`__. | + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | weight | Integer | Traffic weight allocated to a model. This parameter is mandatory only when **infer_type** is set to **real-time**. The sum of the weights must be **100**. | + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseTrainingParameter: + +.. table:: **Table 11** TrainingParameter + + ========= ====== ================ + Parameter Type Description + ========= ====== ================ + label String Parameter name. + value String Parameter value. + ========= ====== ================ + + + +.. _AutoAnnotationProgressresponseResult: + +.. table:: **Table 12** Result + + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+=====================================================================================+=================================================================================================================================+ + | annotated_sample_count | Integer | Number of labeled samples. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | confidence_scope | String | Confidence range. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | dataset_name | String | Dataset name. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | dataset_type | String | Dataset type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet | + | | | | + | | | - **200**: sound classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **400**: table dataset | + | | | | + | | | - **600**: video labeling | + | | | | + | | | - **900**: custom format | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | dlf_model_job_name | String | Name of a DLF model inference job. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | dlf_service_job_name | String | Name of a DLF real-time service job. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | dlf_train_job_name | String | Name of a DLF training job. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | events | Array of `Event <#autoannotationprogressresponseevent>`__ objects | Event. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | hard_example_path | String | Path for storing hard examples. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | hard_select_tasks | Array of `HardSelectTask <#autoannotationprogressresponsehardselecttask>`__ objects | Selected task list of hard examples. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | manifest_path | String | Path for storing the **manifest** files. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | model_id | String | Model ID. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | model_name | String | Model name. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | model_version | String | Model version. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | samples | Array of `SampleLabels <#autoannotationprogressresponsesamplelabels>`__ objects | Inference result of the real-time video service. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | service_id | String | ID of a real-time service. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | service_name | String | Name of a real-time service. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | service_resource | String | ID of the real-time service bound to a user. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of samples. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | train_data_path | String | Path for storing training data. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | train_job_id | String | ID of a training job. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | train_job_name | String | Name of a training job. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | unconfirmed_sample_count | Integer | Number of samples to be confirmed. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Dataset version ID. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +--------------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseEvent: + +.. table:: **Table 13** Event + + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + | Parameter | Type | Description | + +=======================+===================================================================+=====================================+ + | create_time | Long | Time when an event is created. | + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + | description | String | Description. | + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + | elapsed_time | Long | Time when an event is executed. | + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + | error_code | String | Error code. | + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + | error_message | String | Error message. | + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + | events | Array of `Event <#autoannotationprogressresponseevent>`__ objects | Subevent list. | + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + | level | Integer | Event severity. | + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + | name | String | Event name. | + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + | ordinal | Integer | Sequence number. | + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + | parent_name | String | Parent event name. | + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + | status | String | Status. The options are as follows: | + | | | | + | | | - **waiting**: waiting | + | | | | + | | | - **running**: running | + | | | | + | | | - **failed**: failed | + | | | | + | | | - **success**: successful | + +-----------------------+-------------------------------------------------------------------+-------------------------------------+ + + + +.. _AutoAnnotationProgressresponseHardSelectTask: + +.. table:: **Table 14** HardSelectTask + + =================== ====== ==================================== + Parameter Type Description + =================== ====== ==================================== + create_at Long Creation time. + dataset_id String Dataset ID. + dataset_name String Dataset name. + hard_select_task_id String ID of a hard example filtering task. + task_status String Task status. + time Long Execution time. + update_at Long Update time. + =================== ====== ==================================== + + + +.. _AutoAnnotationProgressresponseSampleLabels: + +.. table:: **Table 15** SampleLabels + + +-----------------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===============================================================================+====================================================================================+ + | labels | Array of `SampleLabel <#autoannotationprogressresponsesamplelabel>`__ objects | Sample label list. If this parameter is left blank, all sample labels are deleted. | + +-----------------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | metadata | `SampleMetadata <#autoannotationprogressresponsesamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_id | String | Sample ID. | + +-----------------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_type | Integer | Sample type. The options are as follows: | + | | | | + | | | - **0**: image | + | | | | + | | | - **1**: text | + | | | | + | | | - **2**: speech | + | | | | + | | | - **4**: table | + | | | | + | | | - **6**: video | + | | | | + | | | - **9**: custom format | + +-----------------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_usage | String | Sample usage. The options are as follows: | + | | | | + | | | - **TRAIN**: training | + | | | | + | | | - **EVAL**: evaluation | + | | | | + | | | - **TEST**: test | + | | | | + | | | - **INFERENCE**: inference | + +-----------------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | source | String | Source address of sample data. | + +-----------------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseSampleLabel: + +.. table:: **Table 16** SampleLabel + + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=====================================================================================+=======================================================================================================================================+ + | annotated_by | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | + | | | - **human**: manual labeling | + | | | | + | | | - **auto**: automatic labeling | + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | Label ID. | + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | `SampleLabelProperty <#autoannotationprogressresponsesamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | Float | Confidence. | + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+-------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseSampleLabelProperty: + +.. table:: **Table 17** SampleLabelProperty + + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | + | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | + | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | + | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | + | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | + | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | + | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | + | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | + | | | - **0/false**: not a hard example | + | | | | + | | | - **1/true**: hard example | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _AutoAnnotationProgressresponseSampleMetadata: + +.. table:: **Table 18** SampleMetadata + + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Obtaining Information About an Auto Labeling (Active Learning) Task + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/tasks/{task_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "resource_id" : "XGrRZuCV1qmMxnsmD5u", + "create_time" : "2020-11-23 11:08:20", + "progress" : 10.0, + "status" : 1, + "message" : "Start to export annotations. Export task id is jMZGm2SBp4Ymr2wrhAK", + "code" : "ModelArts.4902", + "elapsed_time" : 0, + "result" : { + "total_sample_count" : 49, + "annotated_sample_count" : 30, + "continuity" : false + }, + "export_type" : 0, + "config" : { + "ambiguity" : false, + "worker_server_num" : 0, + "collect_sample" : false, + "algorithm_type" : "fast", + "image_brightness" : false, + "image_colorfulness" : false + } + } + +Status Codes +------------ + + + +.. _AutoAnnotationProgressstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/intelligent_task/querying_auto_labeling_sample_list.rst b/api-ref/source/data_management/intelligent_task/querying_auto_labeling_sample_list.rst new file mode 100644 index 0000000..a26bcc1 --- /dev/null +++ b/api-ref/source/data_management/intelligent_task/querying_auto_labeling_sample_list.rst @@ -0,0 +1,587 @@ +Querying Auto Labeling Sample List +================================== + +Function +-------- + +This API is used to query auto labeling samples in a dataset. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/auto-annotations/samples + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+=================+=================+=====================================================================================================================================================================================================================================+ + | high_score | No | String | Upper confidence limit. The default value is **1**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_name | No | String | Label name. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_type | No | Integer | Labeling type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet | + | | | | | + | | | | - **200**: sound classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **400**: table dataset | + | | | | | + | | | | - **600**: video labeling | + | | | | | + | | | | - **900**: custom format | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | low_score | No | String | Lower confidence limit. The default value is **0**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting sequence of the query. The options are as follows: | + | | | | | + | | | | - **asc**: ascending order | + | | | | | + | | | | - **desc**: descending order (default value) | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | process_parameter | No | String | Image resizing setting, which is the same as the OBS resizing setting. For details, see . For example, **image/resize,m_lfit,h_200** indicates that the target image is resized proportionally and the height is set to 200 pixels. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_conditions | No | String | Multi-dimensional search condition after URL encoding. The relationship between multiple search conditions is AND. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListAutoAnnotationSamplesresponseListSamplesResp: + +.. table:: **Table 3** Response body parameters + + +--------------+------------------------------------------------------------------------------------------------+--------------------+ + | Parameter | Type | Description | + +==============+================================================================================================+====================+ + | sample_count | Integer | Number of samples. | + +--------------+------------------------------------------------------------------------------------------------+--------------------+ + | samples | Array of `DescribeSampleResp <#listautoannotationsamplesresponsedescribesampleresp>`__ objects | Sample list. | + +--------------+------------------------------------------------------------------------------------------------+--------------------+ + + + +.. _ListAutoAnnotationSamplesresponseDescribeSampleResp: + +.. table:: **Table 4** DescribeSampleResp + + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==================================================================================+========================================================================================================================================+ + | check_accept | Boolean | Whether the acceptance is passed, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: The acceptance is passed. | + | | | | + | | | - **false**: The acceptance is not passed. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_comment | String | Acceptance comment, which is used for team labeling. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_score | String | Acceptance score, which is used for team labeling. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_reasons | Array of strings | Reason for deleting a sample, which is used for healthcare. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | hard_details | Map | Details about difficulties, including description, causes, and suggestions of difficult problems. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labelers | Array of `Worker <#listautoannotationsamplesresponseworker>`__ objects | Labeling personnel list of sample assignment. The labelers record the team members to which the sample is allocated for team labeling. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labels | Array of `SampleLabel <#listautoannotationsamplesresponsesamplelabel>`__ objects | Sample label list. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SampleMetadata <#listautoannotationsamplesresponsesamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_accept | Boolean | Whether to accept the review, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: accepted | + | | | | + | | | - **false**: rejected | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_comment | String | Review comment, which is used for team labeling. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_score | String | Review score, which is used for team labeling. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_data | Array of strings | Sample data list. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Sample path. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_id | String | Sample ID. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Sample name. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_size | Long | Sample size or text length, in bytes. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_status | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | Long | Sample time, when OBS is last modified. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_type | Integer | Sample type. The options are as follows: | + | | | | + | | | - **0**: image | + | | | | + | | | - **1**: text | + | | | | + | | | - **2**: speech | + | | | | + | | | - **4**: table | + | | | | + | | | - **6**: video | + | | | | + | | | - **9**: custom format | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Comprehensive score, which is used for team labeling. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | source | String | Source address of sample data. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sub_sample_url | String | Subsample URL, which is used for healthcare. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member, which is used for team labeling. | + +-----------------------+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListAutoAnnotationSamplesresponseHardDetail: + +.. table:: **Table 5** HardDetail + + ========== ======= ==================== + Parameter Type Description + ========== ======= ==================== + alo_name String Alias. + id Integer Reason ID. + reason String Reason description. + suggestion String Handling suggestion. + ========== ======= ==================== + + + +.. _ListAutoAnnotationSamplesresponseWorker: + +.. table:: **Table 6** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListAutoAnnotationSamplesresponseSampleLabel: + +.. table:: **Table 7** SampleLabel + + +-----------------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+========================================================================================+=======================================================================================================================================+ + | annotated_by | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | + | | | - **human**: manual labeling | + | | | | + | | | - **auto**: automatic labeling | + +-----------------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | Label ID. | + +-----------------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | `SampleLabelProperty <#listautoannotationsamplesresponsesamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | Float | Confidence. | + +-----------------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListAutoAnnotationSamplesresponseSampleLabelProperty: + +.. table:: **Table 8** SampleLabelProperty + + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | + | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | + | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | + | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | + | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | + | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | + | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | + | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | + | | | - **0/false**: not a hard example | + | | | | + | | | - **1/true**: hard example | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListAutoAnnotationSamplesresponseSampleMetadata: + +.. table:: **Table 9** SampleMetadata + + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Auto Labeling Sample List + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/auto-annotations/samples + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "sample_count" : 1, + "samples" : [ { + "sample_id" : "10de574cbf0f09d4798b87ba0eb34e37", + "sample_type" : 0, + "labels" : [ { + "name" : "sunflowers", + "type" : 0, + "id" : "1", + "property" : { + "@modelarts:hard_coefficient" : "0.0", + "@modelarts:hard" : "false" + }, + "score" : 1.0 + } ], + "source" : "https://test-obs.obs.xxx.com:443/dogcat/8_1597649054631.jpeg?AccessKeyId=alRn0xskf5luJaG2jBJe&Expires=1606299230&x-image-process=image%2Fresize%2Cm_lfit%2Ch_200&Signature=MNAAjXz%2Fmwn%2BSabSK9wkaG6b6bU%3D", + "metadata" : { + "@modelarts:hard_coefficient" : 1.0, + "@modelarts:hard" : true, + "@modelarts:import_origin" : 0, + "@modelarts:hard_reasons" : [ 8, 6, 5, 3 ] + }, + "sample_time" : 1601432758000, + "sample_status" : "UN_ANNOTATION" + } ] + } + +Status Codes +------------ + + + +.. _ListAutoAnnotationSamplesstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/intelligent_task/querying_details_about_an_auto_labeling_sample.rst b/api-ref/source/data_management/intelligent_task/querying_details_about_an_auto_labeling_sample.rst new file mode 100644 index 0000000..528c8d4 --- /dev/null +++ b/api-ref/source/data_management/intelligent_task/querying_details_about_an_auto_labeling_sample.rst @@ -0,0 +1,524 @@ +Querying Details About an Auto Labeling Sample +============================================== + +Function +-------- + +This API is used to query details about an auto labeling sample. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/auto-annotations/samples/{sample_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_id | Yes | String | Sample ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DescribeAutoAnnotationSampleresponseDescribeSampleResp: + +.. table:: **Table 2** Response body parameters + + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=====================================================================================+========================================================================================================================================+ + | check_accept | Boolean | Whether the acceptance is passed, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: The acceptance is passed. | + | | | | + | | | - **false**: The acceptance is not passed. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_comment | String | Acceptance comment, which is used for team labeling. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_score | String | Acceptance score, which is used for team labeling. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_reasons | Array of strings | Reason for deleting a sample, which is used for healthcare. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | hard_details | Map | Details about difficulties, including description, causes, and suggestions of difficult problems. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labelers | Array of `Worker <#describeautoannotationsampleresponseworker>`__ objects | Labeling personnel list of sample assignment. The labelers record the team members to which the sample is allocated for team labeling. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labels | Array of `SampleLabel <#describeautoannotationsampleresponsesamplelabel>`__ objects | Sample label list. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SampleMetadata <#describeautoannotationsampleresponsesamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_accept | Boolean | Whether to accept the review, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: accepted | + | | | | + | | | - **false**: rejected | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_comment | String | Review comment, which is used for team labeling. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_score | String | Review score, which is used for team labeling. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_data | Array of strings | Sample data list. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Sample path. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_id | String | Sample ID. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Sample name. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_size | Long | Sample size or text length, in bytes. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_status | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | Long | Sample time, when OBS is last modified. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_type | Integer | Sample type. The options are as follows: | + | | | | + | | | - **0**: image | + | | | | + | | | - **1**: text | + | | | | + | | | - **2**: speech | + | | | | + | | | - **4**: table | + | | | | + | | | - **6**: video | + | | | | + | | | - **9**: custom format | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Comprehensive score, which is used for team labeling. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | source | String | Source address of sample data. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sub_sample_url | String | Subsample URL, which is used for healthcare. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member, which is used for team labeling. | + +-----------------------+-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeAutoAnnotationSampleresponseHardDetail: + +.. table:: **Table 3** HardDetail + + ========== ======= ==================== + Parameter Type Description + ========== ======= ==================== + alo_name String Alias. + id Integer Reason ID. + reason String Reason description. + suggestion String Handling suggestion. + ========== ======= ==================== + + + +.. _DescribeAutoAnnotationSampleresponseWorker: + +.. table:: **Table 4** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeAutoAnnotationSampleresponseSampleLabel: + +.. table:: **Table 5** SampleLabel + + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================================================================================+=======================================================================================================================================+ + | annotated_by | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | + | | | - **human**: manual labeling | + | | | | + | | | - **auto**: automatic labeling | + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | Label ID. | + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | `SampleLabelProperty <#describeautoannotationsampleresponsesamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | Float | Confidence. | + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeAutoAnnotationSampleresponseSampleLabelProperty: + +.. table:: **Table 6** SampleLabelProperty + + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | + | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | + | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | + | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | + | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | + | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | + | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | + | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | + | | | - **0/false**: not a hard example | + | | | | + | | | - **1/true**: hard example | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeAutoAnnotationSampleresponseSampleMetadata: + +.. table:: **Table 7** SampleMetadata + + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About an Auto Labeling Sample + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/auto-annotations/samples/{sample_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "sample_id" : "0059c1b9458a2da9443af684b5099b4e", + "sample_type" : 0, + "labels" : [ { + "name" : "Dog", + "type" : 0, + "id" : "1", + "property" : { + "@modelarts:hard_coefficient" : "0.0", + "@modelarts:hard" : "false" + }, + "score" : 0.66 + } ], + "source" : "https://test-obs.obs.xxx.com:443/data/3_1597649054631.jpg?AccessKeyId=RciyO7RHmhNTfOZVryUH&Expires=1606299474&Signature=anOLGOHPSrj3WXUHVc70tAxWlf4%3D", + "metadata" : { + "test" : "1", + "@modelarts:hard_coefficient" : 0.0, + "@modelarts:hard" : false, + "@modelarts:import_origin" : 0, + "@modelarts:hard_reasons" : [ ] + }, + "sample_time" : 1600490651933, + "sample_status" : "UN_ANNOTATION", + "annotated_by" : "" + } + +Status Codes +------------ + + + +.. _DescribeAutoAnnotationSamplestatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/intelligent_task/querying_the_intelligent_task_list_by_page.rst b/api-ref/source/data_management/intelligent_task/querying_the_intelligent_task_list_by_page.rst new file mode 100644 index 0000000..314f70e --- /dev/null +++ b/api-ref/source/data_management/intelligent_task/querying_the_intelligent_task_list_by_page.rst @@ -0,0 +1,1063 @@ +Querying the Intelligent Task List by Page +========================================== + +Function +-------- + +This API is used to query the intelligent task list by page, including auto labeling, one-click model deployment, and auto grouping tasks. You can specify the **type** parameter to query the list of a specific type of tasks. + +- Auto labeling: Learning and training are performed based on the selected labels and images and an existing model is selected to quickly label the remaining images. Auto labeling includes active learning and pre-labeling. + +- Active learning: The system uses semi-supervised learning and hard example filtering to perform auto labeling, reducing manual labeling workload and helping you find hard examples. + +- Pre-labeling: You select a model on the Model Management page for auto labeling. + +- One-click model deployment: You can use the one-click model deployment function to create training jobs for the labeled dataset, import a model, and deploy the model as a real-time service all in one step. + +- Auto grouping: Unlabeled images are clustered using the clustering algorithm and then processed based on the clustering result. Images can be labeled by group or cleaned. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/tasks + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==================================================================================================================================================================+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_name | No | String | Task name filtering. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | String | Task type. If this parameter is not delivered, the auto labeling (active learning or pre-labeling) task list is returned by default. The options are as follows: | + | | | | | + | | | | - **auto-label**: active learning | + | | | | | + | | | | - **pre-label**: pre-labeling | + | | | | | + | | | | - **auto-grouping**: auto grouping | + | | | | | + | | | | - **auto-deploy**: one-click model deployment | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListTasksresponseListTaskResp: + +.. table:: **Table 3** Response body parameters + + +-------------+------------------------------------------------------------------+------------------------+ + | Parameter | Type | Description | + +=============+==================================================================+========================+ + | tasks | Array of `RunningTask <#listtasksresponserunningtask>`__ objects | Task list. | + +-------------+------------------------------------------------------------------+------------------------+ + | total_count | Integer | Total number of tasks. | + +-------------+------------------------------------------------------------------+------------------------+ + + + +.. _ListTasksresponseRunningTask: + +.. table:: **Table 4** RunningTask + + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | Parameter | Type | Description | + +==========================+================================================================+====================================+ + | annotated_sample_count | Integer | Number of labeled samples. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | code | String | Error code. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | config | `SmartTaskConfig <#listtasksresponsesmarttaskconfig>`__ object | Task configuration. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | create_time | String | Task creation time. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | dataset_id | String | Dataset ID. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | elapsed_time | Long | Execution time. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | error_code | String | Error code. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | error_detail | String | Error details. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | error_msg | String | Error message. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | message | String | Error message. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | model_id | String | Model ID. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | model_name | String | Model name. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | model_version | String | Model version. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | progress | Float | Task progress percentage. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | result | `Result <#listtasksresponseresult>`__ object | Task result. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | status | Integer | Task status. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | task_id | String | Task ID. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | task_name | String | Task name. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | total_sample_count | Integer | Total number of samples. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | type | Integer | Task type. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + | unconfirmed_sample_count | Integer | Number of samples to be confirmed. | + +--------------------------+----------------------------------------------------------------+------------------------------------+ + + + +.. _ListTasksresponseSmartTaskConfig: + +.. table:: **Table 5** SmartTaskConfig + + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=========================+==============================================================================+=======================================================================================================================================================================================================================================================================================================================================================+ + | algorithm_type | String | Algorithm type for auto labeling. Options: | + | | | | + | | | - **fast**: Only labeled samples are used for training. This type of algorithm achieves faster labeling. | + | | | | + | | | - **accurate**: In addition to labeled samples, unlabeled samples are used for semi-supervised training. This type of algorithm achieves more accurate labeling. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ambiguity | Boolean | Whether to perform clustering based on the image blurring degree. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotation_output | String | Output path of the active learning labeling result. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | collect_rule | String | Sample collection rule. The default value is **all**, indicating full collection. Currently, only value **all** is available. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | collect_sample | Boolean | Whether to enable sample collection. The options are as follows: | + | | | | + | | | - **true**: Enable sample collection. (Default value) | + | | | | + | | | - **false**: Do not enable sample collection. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | confidence_scope | String | Confidence range of key samples. The minimum and maximum values are separated by hyphens (-). Example: 0.10-0.90. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Task description. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_name | String | Engine name. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_format | Integer | Format of the exported directory. The options are as follows: | + | | | | + | | | - **1**: tree structure. For example: cat/1.jpg,dog/2.jpg. | + | | | | + | | | - **2**: tile structure. For example: 1.jpg, 1.txt; 2.jpg,2.txt. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_params | `ExportParams <#listtasksresponseexportparams>`__ object | Parameters of a dataset export task. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | `Flavor <#listtasksresponseflavor>`__ object | Training resource flavor. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | image_brightness | Boolean | Whether to perform clustering based on the image brightness. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | image_colorfulness | Boolean | Whether to perform clustering based on the image color. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inf_cluster_id | String | ID of a dedicated cluster. This parameter is left blank by default, indicating that a dedicated cluster is not used. When using the dedicated cluster to deploy services, ensure that the cluster status is normal. After this parameter is set, the network configuration of the cluster is used, and the **vpc_id** parameter does not take effect. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inf_config_list | Array of `InfConfig <#listtasksresponseinfconfig>`__ objects | Configuration list required for running an inference task, which is optional and left blank by default. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inf_output | String | Output path of inference in active learning. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | infer_result_output_dir | String | OBS directory for storing sample prediction results. This parameter is optional. The {*service_id*}\ **-infer-result** subdirectory in the **output_dir** directory is used by default. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | key_sample_output | String | Output path of hard examples in active learning. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_url | String | OBS URL of the logs of a training job. By default, this parameter is left blank. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | manifest_path | String | Path of the **manifest** file, which is used as the input for training and inference. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | String | Model ID. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_name | String | Model name. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_parameter | String | Model parameter. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_version | String | Model version. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | n_clusters | Integer | Number of clusters. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Task name. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | output_dir | String | Sample output path. The format is as follows: *Dataset output path*/*Dataset name*-*Dataset ID*/annotation/auto-deploy/. Example: **/test/work_1608083108676/dataset123-g6IO9qSu6hoxwCAirfm/annotation/auto-deploy/**. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parameters | Array of `TrainingParameter <#listtasksresponsetrainingparameter>`__ objects | Running parameters of a training job. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_id | String | ID of a resource pool. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | String | Attribute name. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | req_uri | String | Inference path of a batch job. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | result_type | Integer | Processing mode of auto grouping results. The options are as follows: | + | | | | + | | | - **0**: Save to OBS. | + | | | | + | | | - **1**: Save to samples. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | Array of `SampleLabels <#listtasksresponsesamplelabels>`__ objects | List of labeling information for samples to be auto labeled. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | stop_time | Integer | Timeout interval, in minutes. The default value is 15 minutes. This parameter is used only in the scenario of auto labeling for videos. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time | String | Timestamp in active learning. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_data_path | String | Path for storing existing training datasets. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | String | URL of the OBS path where the file of a training job is outputted. By default, this parameter is left blank. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_format | String | Format of a dataset version. The options are as follows: | + | | | | + | | | - **Default**: default format | + | | | | + | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | + | | | - **CSV**: CSV | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_server_num | Integer | Number of workers in a training job. | + +-------------------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListTasksresponseExportParams: + +.. table:: **Table 6** ExportParams + + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===============================+==========================================================================+============================================================================================================================================================================+ + | clear_hard_property | Boolean | Whether to clear hard example attributes. The options are as follows: | + | | | | + | | | - **true**: Clear hard example attributes. (Default value) | + | | | | + | | | - **false**: Do not clear hard example attributes. | + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_format | String | Format of the dataset version to which data is exported. | + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_name | String | Name of the dataset version to which data is exported. | + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dest | String | Export destination. The options are as follows: | + | | | | + | | | - **DIR**: Export data to OBS. (Default value) | + | | | | + | | | - **NEW_DATASET**: Export data to a new dataset. | + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_name | String | Name of the new dataset to which data is exported. | + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_work_path | String | Working directory of the new dataset to which data is exported. | + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ratio_sample_usage | Boolean | Whether to randomly allocate the training set and validation set based on the specified ratio. The options are as follows: | + | | | | + | | | - **true**: Allocate the training set and validation set. | + | | | | + | | | - **false**: Do not allocate the training set and validation set. (Default value) | + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | Array of strings | ID list of exported samples. | + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_conditions | Array of `SearchCondition <#listtasksresponsesearchcondition>`__ objects | Exported search conditions. The relationship between multiple search conditions is OR. | + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_sample_ratio | String | Split ratio of training set and verification set during specified version release. The default value is **1.00**, indicating that all released versions are training sets. | + +-------------------------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListTasksresponseSearchCondition: + +.. table:: **Table 7** SearchCondition + + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==========================================================+==================================================================================================================================================================================================================================================================+ + | coefficient | String | Filter by coefficient of difficulty. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | frame_in_video | Integer | A frame in the video. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | hard | String | Whether a sample is a hard sample. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_origin | String | Filter by data source. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | kvp | String | CT dosage, filtered by dosage. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_list | `SearchLabels <#listtasksresponsesearchlabels>`__ object | Label search criteria. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labeler | String | Labeler. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SearchProp <#listtasksresponsesearchprop>`__ object | Search by sample attribute. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parent_sample_id | String | Parent sample ID. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Directory where data samples are stored (the directory must end with a slash (/)). Only samples in the specified directory are searched for. Recursive search of directories is not supported. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Search by sample name, including the file name extension. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | String | When a sample is added to the dataset, an index is created based on the last modification time (accurate to day) of the sample on OBS. You can search for the sample based on the time. The options are as follows: | + | | | | + | | | - **month**: Search for samples added from 30 days ago to the current day. | + | | | | + | | | - **day**: Search for samples added from yesterday (one day ago) to the current day. | + | | | | + | | | - **yyyyMMdd-yyyyMMdd**: Search for samples added in a specified period (at most 30 days), in the format of **Start date-End date**. For example, **20190901-2019091501** indicates that samples generated from September 1 to September 15, 2019 are searched. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Search by confidence. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | slice_thickness | String | DICOM layer thickness. Samples are filtered by layer thickness. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | study_date | String | DICOM scanning time. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time_in_video | String | A time point in the video. | + +-----------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListTasksresponseSearchLabels: + +.. table:: **Table 8** SearchLabels + + +-----------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==================================================================+==============================================================================================================================================================+ + | labels | Array of `SearchLabel <#listtasksresponsesearchlabel>`__ objects | List of label search criteria. | + +-----------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | If you want to search for multiple labels, **op** must be specified. If you search for only one label, **op** can be left blank. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListTasksresponseSearchLabel: + +.. table:: **Table 9** SearchLabel + + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+========================================================================================================================================================================================================================================================================================+ + | name | String | Label name. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | Operation type between multiple attributes. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | Map> | Label attribute, which is in the Object format and stores any key-value pairs. **key** indicates the attribute name, and **value** indicates the value list. If **value** is **null**, the search is not performed by value. Otherwise, the search value can be any value in the list. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListTasksresponseSearchProp: + +.. table:: **Table 10** SearchProp + + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+=======================================================================+ + | op | String | Relationship between attribute values. The options are as follows: | + | | | | + | | | - **AND**: AND relationship | + | | | | + | | | - **OR**: OR relationship | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | props | Map> | Search criteria of an attribute. Multiple search criteria can be set. | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + + + +.. _ListTasksresponseFlavor: + +.. table:: **Table 11** Flavor + + +-----------+--------+------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+==============================================================================+ + | code | String | Attribute code of a resource specification, which is used for task creating. | + +-----------+--------+------------------------------------------------------------------------------+ + + + +.. _ListTasksresponseInfConfig: + +.. table:: **Table 12** InfConfig + + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+====================+============================================================================================================================================================================================================================================+ + | envs | Map | (Optional) Environment variable key-value pair required for running a model. By default, this parameter is left blank. To ensure data security, do not enter sensitive information, such as plaintext passwords, in environment variables. | + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_count | Integer | Instance number of model deployment, that is, the number of compute nodes. | + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | String | Model ID. | + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | specification | String | Resource specifications of real-time services. For details, see `Deploying Services <../../service_management/deploying_a_model_as_a_service.html>`__. | + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | weight | Integer | Traffic weight allocated to a model. This parameter is mandatory only when **infer_type** is set to **real-time**. The sum of the weights must be **100**. | + +----------------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListTasksresponseTrainingParameter: + +.. table:: **Table 13** TrainingParameter + + ========= ====== ================ + Parameter Type Description + ========= ====== ================ + label String Parameter name. + value String Parameter value. + ========= ====== ================ + + + +.. _ListTasksresponseResult: + +.. table:: **Table 14** Result + + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+========================================================================+=================================================================================================================================+ + | annotated_sample_count | Integer | Number of labeled samples. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | confidence_scope | String | Confidence range. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | dataset_name | String | Dataset name. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | dataset_type | String | Dataset type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet | + | | | | + | | | - **200**: sound classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **400**: table dataset | + | | | | + | | | - **600**: video labeling | + | | | | + | | | - **900**: custom format | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | dlf_model_job_name | String | Name of a DLF model inference job. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | dlf_service_job_name | String | Name of a DLF real-time service job. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | dlf_train_job_name | String | Name of a DLF training job. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | events | Array of `Event <#listtasksresponseevent>`__ objects | Event. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | hard_example_path | String | Path for storing hard examples. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | hard_select_tasks | Array of `HardSelectTask <#listtasksresponsehardselecttask>`__ objects | Selected task list of hard examples. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | manifest_path | String | Path for storing the **manifest** files. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | model_id | String | Model ID. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | model_name | String | Model name. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | model_version | String | Model version. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | samples | Array of `SampleLabels <#listtasksresponsesamplelabels>`__ objects | Inference result of the real-time video service. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | service_id | String | ID of a real-time service. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | service_name | String | Name of a real-time service. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | service_resource | String | ID of the real-time service bound to a user. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of samples. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | train_data_path | String | Path for storing training data. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | train_job_id | String | ID of a training job. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | train_job_name | String | Name of a training job. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | unconfirmed_sample_count | Integer | Number of samples to be confirmed. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Dataset version ID. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +--------------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListTasksresponseEvent: + +.. table:: **Table 15** Event + + +-----------------------+------------------------------------------------------+-------------------------------------+ + | Parameter | Type | Description | + +=======================+======================================================+=====================================+ + | create_time | Long | Time when an event is created. | + +-----------------------+------------------------------------------------------+-------------------------------------+ + | description | String | Description. | + +-----------------------+------------------------------------------------------+-------------------------------------+ + | elapsed_time | Long | Time when an event is executed. | + +-----------------------+------------------------------------------------------+-------------------------------------+ + | error_code | String | Error code. | + +-----------------------+------------------------------------------------------+-------------------------------------+ + | error_message | String | Error message. | + +-----------------------+------------------------------------------------------+-------------------------------------+ + | events | Array of `Event <#listtasksresponseevent>`__ objects | Subevent list. | + +-----------------------+------------------------------------------------------+-------------------------------------+ + | level | Integer | Event severity. | + +-----------------------+------------------------------------------------------+-------------------------------------+ + | name | String | Event name. | + +-----------------------+------------------------------------------------------+-------------------------------------+ + | ordinal | Integer | Sequence number. | + +-----------------------+------------------------------------------------------+-------------------------------------+ + | parent_name | String | Parent event name. | + +-----------------------+------------------------------------------------------+-------------------------------------+ + | status | String | Status. The options are as follows: | + | | | | + | | | - **waiting**: waiting | + | | | | + | | | - **running**: running | + | | | | + | | | - **failed**: failed | + | | | | + | | | - **success**: successful | + +-----------------------+------------------------------------------------------+-------------------------------------+ + + + +.. _ListTasksresponseHardSelectTask: + +.. table:: **Table 16** HardSelectTask + + =================== ====== ==================================== + Parameter Type Description + =================== ====== ==================================== + create_at Long Creation time. + dataset_id String Dataset ID. + dataset_name String Dataset name. + hard_select_task_id String ID of a hard example filtering task. + task_status String Task status. + time Long Execution time. + update_at Long Update time. + =================== ====== ==================================== + + + +.. _ListTasksresponseSampleLabels: + +.. table:: **Table 17** SampleLabels + + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==================================================================+====================================================================================+ + | labels | Array of `SampleLabel <#listtasksresponsesamplelabel>`__ objects | Sample label list. If this parameter is left blank, all sample labels are deleted. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | metadata | `SampleMetadata <#listtasksresponsesamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_id | String | Sample ID. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_type | Integer | Sample type. The options are as follows: | + | | | | + | | | - **0**: image | + | | | | + | | | - **1**: text | + | | | | + | | | - **2**: speech | + | | | | + | | | - **4**: table | + | | | | + | | | - **6**: video | + | | | | + | | | - **9**: custom format | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_usage | String | Sample usage. The options are as follows: | + | | | | + | | | - **TRAIN**: training | + | | | | + | | | - **EVAL**: evaluation | + | | | | + | | | - **TEST**: test | + | | | | + | | | - **INFERENCE**: inference | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | source | String | Source address of sample data. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + + + +.. _ListTasksresponseSampleLabel: + +.. table:: **Table 18** SampleLabel + + +-----------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+========================================================================+=======================================================================================================================================+ + | annotated_by | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | + | | | - **human**: manual labeling | + | | | | + | | | - **auto**: automatic labeling | + +-----------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | Label ID. | + +-----------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | `SampleLabelProperty <#listtasksresponsesamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | Float | Confidence. | + +-----------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListTasksresponseSampleLabelProperty: + +.. table:: **Table 19** SampleLabelProperty + + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | + | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | + | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | + | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | + | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | + | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | + | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | + | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | + | | | - **0/false**: not a hard example | + | | | | + | | | - **1/true**: hard example | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListTasksresponseSampleMetadata: + +.. table:: **Table 20** SampleMetadata + + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the List of Auto Labeling, One-Click Model Deployment, or Auto Grouping Tasks by Page + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/tasks?offset=0&limit=10 + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "tasks" : [ { + "dataset_id" : "OBegCXHxTJ2JHRAZWr0", + "task_id" : "14cyxyu6UXaNT3lrPFl", + "type" : 1, + "create_time" : "2020-11-03 15:22:39", + "status" : 3, + "code" : "ModelArts.4996", + "message" : "prelabel task execute successfully.", + "elapsed_time" : 531, + "result" : { + "service_id" : "ee2ade80-0967-4ef3-b6da-e8c873017b9a", + "service_name" : "prelabel_infer_1604388201993_xubo_cls_d910_2_993", + "hard_select_tasks" : [ { + "id" : "887c4ac6-26c8-4ca3-b07a-cd75e16fdc2d", + "hard_select_task_id" : "86711ab3-8ceb-4b0e-bd52-8545b184a2a7", + "dataset_id" : "OBegCXHxTJ2JHRAZWr0", + "dataset_name" : "xubo_cls_d910_2", + "task_status" : "import_dataset_completed", + "time" : 262, + "create_at" : 0, + "update_at" : 0 + } ], + "continuity" : false + }, + "export_type" : 0, + "progress" : 100.0, + "total_sample_count" : 246, + "annotated_sample_count" : 38, + "unconfirmed_sample_count" : 208, + "model_id" : "c717a39f-c64f-45df-a9d3-be9ed79cdcb4", + "model_name" : "auto-deploy-50041602581620628", + "model_version" : "0.0.1", + "config" : { + "ambiguity" : false, + "name" : "5fXxR01TyUoiobqNEd9", + "worker_server_num" : 0, + "inf_config_list" : [ { + "model_id" : null, + "specification" : "modelarts.vm.cpu.2u", + "weight" : 0, + "instance_count" : 1, + "envs" : null + } ], + "collect_sample" : false, + "confidence_scope" : "0.0-0.5", + "algorithm_type" : "supervisory", + "image_brightness" : false, + "image_colorfulness" : false + } + }, { + "dataset_id" : "OBegCXHxTJ2JHRAZWr0", + "task_id" : "5QPy73VwnwHi5NqvbcP", + "type" : 0, + "create_time" : "2020-10-31 16:11:37", + "status" : 3, + "code" : "ModelArts.4996", + "message" : "task executed successfully.", + "elapsed_time" : 397, + "result" : { + "train_job_name" : "BNFURaEyftGNMITaBiv", + "train_job_id" : "74679", + "version_id" : "89745", + "continuity" : false + }, + "export_type" : 0, + "progress" : 100.0, + "total_sample_count" : 246, + "annotated_sample_count" : 38, + "unconfirmed_sample_count" : 198, + "model_name" : "Supervisory", + "model_version" : "0.0.1", + "config" : { + "ambiguity" : false, + "worker_server_num" : 0, + "collect_sample" : false, + "algorithm_type" : "fast", + "image_brightness" : false, + "image_colorfulness" : false + } + } ], + "total_count" : 2, + "exist_running_deploy_task" : false + } + +Status Codes +------------ + + + +.. _ListTasksstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/intelligent_task/starting_intelligent_tasks.rst b/api-ref/source/data_management/intelligent_task/starting_intelligent_tasks.rst new file mode 100644 index 0000000..2991021 --- /dev/null +++ b/api-ref/source/data_management/intelligent_task/starting_intelligent_tasks.rst @@ -0,0 +1,822 @@ +Starting Intelligent Tasks +========================== + +Function +-------- + +**This API is used to start an intelligent task, which can be an auto labeling task or an auto grouping task. You can specify task_type in the request body to start a type of tasks. The datasets whose data path or work path is an OBS path in a KMS-encrypted bucket support pre-labeling but do not support active learning and auto grouping.** + +**Auto labeling**: Learning and training are performed based on selected labels and images and an existing model is selected to quickly label the remaining images. Auto labeling includes active learning and pre-labeling. **Active learning**: The system uses semi-supervised learning and hard example filtering to perform auto labeling, reducing manual labeling workload and helping you find hard examples. **Pre-labeling**: Select a model displayed on the **Model Management** page for auto labeling. + +- **Auto grouping**: Unlabeled images are clustered using a clustering algorithm and then processed based on the clustering result. Images can be labeled or cleaned by group. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/tasks + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateTaskrequestSmartTaskRequest: + +.. table:: **Table 2** Request body parameters + + +--------------------+-----------------+----------------------------------------------------------------+-------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+=================+================================================================+=============================================================+ + | collect_key_sample | No | Boolean | Whether to collect key samples. The options are as follows: | + | | | | | + | | | | - **true**: Collect key samples. | + | | | | | + | | | | - **false**: Do not collect key samples. (Default value) | + +--------------------+-----------------+----------------------------------------------------------------+-------------------------------------------------------------+ + | config | No | `SmartTaskConfig <#createtaskrequestsmarttaskconfig>`__ object | Task configuration. | + +--------------------+-----------------+----------------------------------------------------------------+-------------------------------------------------------------+ + | model_id | No | String | Model ID. | + +--------------------+-----------------+----------------------------------------------------------------+-------------------------------------------------------------+ + | task_type | No | String | Task type. The options are as follows: | + | | | | | + | | | | - **auto-label**: active learning | + | | | | | + | | | | - **pre-label**: pre-labeling | + | | | | | + | | | | - **auto-grouping**: auto grouping | + | | | | | + | | | | - **auto-deploy**: one-click model deployment | + +--------------------+-----------------+----------------------------------------------------------------+-------------------------------------------------------------+ + + + +.. _CreateTaskrequestSmartTaskConfig: + +.. table:: **Table 3** SmartTaskConfig + + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=========================+=================+==============================================================================+=======================================================================================================================================================================================================================================================================================================================================================+ + | algorithm_type | No | String | Algorithm type for auto labeling. Options: | + | | | | | + | | | | - **fast**: Only labeled samples are used for training. This type of algorithm achieves faster labeling. | + | | | | | + | | | | - **accurate**: In addition to labeled samples, unlabeled samples are used for semi-supervised training. This type of algorithm achieves more accurate labeling. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ambiguity | No | Boolean | Whether to perform clustering based on the image blurring degree. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotation_output | No | String | Output path of the active learning labeling result. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | collect_rule | No | String | Sample collection rule. The default value is **all**, indicating full collection. Currently, only value **all** is available. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | collect_sample | No | Boolean | Whether to enable sample collection. The options are as follows: | + | | | | | + | | | | - **true**: Enable sample collection. (Default value) | + | | | | | + | | | | - **false**: Do not enable sample collection. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | confidence_scope | No | String | Confidence range of key samples. The minimum and maximum values are separated by hyphens (-). Example: 0.10-0.90. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Task description. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_name | No | String | Engine name. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_format | No | Integer | Format of the exported directory. The options are as follows: | + | | | | | + | | | | - **1**: tree structure. For example: cat/1.jpg,dog/2.jpg. | + | | | | | + | | | | - **2**: tile structure. For example: 1.jpg, 1.txt; 2.jpg,2.txt. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_params | No | `ExportParams <#createtaskrequestexportparams>`__ object | Parameters of a dataset export task. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | No | `Flavor <#createtaskrequestflavor>`__ object | Training resource flavor. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | image_brightness | No | Boolean | Whether to perform clustering based on the image brightness. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | image_colorfulness | No | Boolean | Whether to perform clustering based on the image color. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inf_cluster_id | No | String | ID of a dedicated cluster. This parameter is left blank by default, indicating that a dedicated cluster is not used. When using the dedicated cluster to deploy services, ensure that the cluster status is normal. After this parameter is set, the network configuration of the cluster is used, and the **vpc_id** parameter does not take effect. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inf_config_list | No | Array of `InfConfig <#createtaskrequestinfconfig>`__ objects | Configuration list required for running an inference task, which is optional and left blank by default. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inf_output | No | String | Output path of inference in active learning. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | infer_result_output_dir | No | String | OBS directory for storing sample prediction results. This parameter is optional. The {*service_id*}\ **-infer-result** subdirectory in the **output_dir** directory is used by default. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | key_sample_output | No | String | Output path of hard examples in active learning. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_url | No | String | OBS URL of the logs of a training job. By default, this parameter is left blank. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | manifest_path | No | String | Path of the **manifest** file, which is used as the input for training and inference. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | No | String | Model ID. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_name | No | String | Model name. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_parameter | No | String | Model parameter. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_version | No | String | Model version. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | n_clusters | No | Integer | Number of clusters. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Task name. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | output_dir | No | String | Sample output path. The format is as follows: *Dataset output path*/*Dataset name*-*Dataset ID*/annotation/auto-deploy/. Example: **/test/work_1608083108676/dataset123-g6IO9qSu6hoxwCAirfm/annotation/auto-deploy/**. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parameters | No | Array of `TrainingParameter <#createtaskrequesttrainingparameter>`__ objects | Running parameters of a training job. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_id | No | String | ID of a resource pool. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | No | String | Attribute name. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | req_uri | No | String | Inference path of a batch job. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | result_type | No | Integer | Processing mode of auto grouping results. The options are as follows: | + | | | | | + | | | | - **0**: Save to OBS. | + | | | | | + | | | | - **1**: Save to samples. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | No | Array of `SampleLabels <#createtaskrequestsamplelabels>`__ objects | List of labeling information for samples to be auto labeled. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | stop_time | No | Integer | Timeout interval, in minutes. The default value is 15 minutes. This parameter is used only in the scenario of auto labeling for videos. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time | No | String | Timestamp in active learning. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_data_path | No | String | Path for storing existing training datasets. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | No | String | URL of the OBS path where the file of a training job is outputted. By default, this parameter is left blank. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_format | No | String | Format of a dataset version. The options are as follows: | + | | | | | + | | | | - **Default**: default format | + | | | | | + | | | | - **CarbonData**: CarbonData (supported only by table datasets) | + | | | | | + | | | | - **CSV**: CSV | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_server_num | No | Integer | Number of workers in a training job. | + +-------------------------+-----------------+------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateTaskrequestExportParams: + +.. table:: **Table 4** ExportParams + + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===============================+=================+==========================================================================+============================================================================================================================================================================+ + | clear_hard_property | No | Boolean | Whether to clear hard example attributes. The options are as follows: | + | | | | | + | | | | - **true**: Clear hard example attributes. (Default value) | + | | | | | + | | | | - **false**: Do not clear hard example attributes. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_format | No | String | Format of the dataset version to which data is exported. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dataset_version_name | No | String | Name of the dataset version to which data is exported. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_dest | No | String | Export destination. The options are as follows: | + | | | | | + | | | | - **DIR**: Export data to OBS. (Default value) | + | | | | | + | | | | - **NEW_DATASET**: Export data to a new dataset. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_name | No | String | Name of the new dataset to which data is exported. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | export_new_dataset_work_path | No | String | Working directory of the new dataset to which data is exported. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ratio_sample_usage | No | Boolean | Whether to randomly allocate the training set and validation set based on the specified ratio. The options are as follows: | + | | | | | + | | | | - **true**: Allocate the training set and validation set. | + | | | | | + | | | | - **false**: Do not allocate the training set and validation set. (Default value) | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | No | String | Sample status. The options are as follows: | + | | | | | + | | | | - **ALL**: labeled | + | | | | | + | | | | - **NONE**: unlabeled | + | | | | | + | | | | - **UNCHECK**: pending acceptance | + | | | | | + | | | | - **ACCEPTED**: accepted | + | | | | | + | | | | - **REJECTED**: rejected | + | | | | | + | | | | - **UNREVIEWED**: pending review | + | | | | | + | | | | - **REVIEWED**: reviewed | + | | | | | + | | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | | + | | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | | + | | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | | + | | | | - **AUTO_ANNOTATION**: to be confirmed | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | No | Array of strings | ID list of exported samples. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_conditions | No | Array of `SearchCondition <#createtaskrequestsearchcondition>`__ objects | Exported search conditions. The relationship between multiple search conditions is OR. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_sample_ratio | No | String | Split ratio of training set and verification set during specified version release. The default value is **1.00**, indicating that all released versions are training sets. | + +-------------------------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateTaskrequestSearchCondition: + +.. table:: **Table 5** SearchCondition + + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==================+=================+==========================================================+==================================================================================================================================================================================================================================================================+ + | coefficient | No | String | Filter by coefficient of difficulty. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | frame_in_video | No | Integer | A frame in the video. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | hard | No | String | Whether a sample is a hard sample. The options are as follows: | + | | | | | + | | | | - **0**: non-hard sample | + | | | | | + | | | | - **1**: hard sample | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_origin | No | String | Filter by data source. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | kvp | No | String | CT dosage, filtered by dosage. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_list | No | `SearchLabels <#createtaskrequestsearchlabels>`__ object | Label search criteria. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labeler | No | String | Labeler. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | No | `SearchProp <#createtaskrequestsearchprop>`__ object | Search by sample attribute. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parent_sample_id | No | String | Parent sample ID. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | No | String | Directory where data samples are stored (the directory must end with a slash (/)). Only samples in the specified directory are searched for. Recursive search of directories is not supported. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | No | String | Search by sample name, including the file name extension. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | No | String | When a sample is added to the dataset, an index is created based on the last modification time (accurate to day) of the sample on OBS. You can search for the sample based on the time. The options are as follows: | + | | | | | + | | | | - **month**: Search for samples added from 30 days ago to the current day. | + | | | | | + | | | | - **day**: Search for samples added from yesterday (one day ago) to the current day. | + | | | | | + | | | | - **yyyyMMdd-yyyyMMdd**: Search for samples added in a specified period (at most 30 days), in the format of **Start date-End date**. For example, **20190901-2019091501** indicates that samples generated from September 1 to September 15, 2019 are searched. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | score | No | String | Search by confidence. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | slice_thickness | No | String | DICOM layer thickness. Samples are filtered by layer thickness. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | study_date | No | String | DICOM scanning time. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time_in_video | No | String | A time point in the video. | + +------------------+-----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateTaskrequestSearchLabels: + +.. table:: **Table 6** SearchLabels + + +-----------------+-----------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+==================================================================+==============================================================================================================================================================+ + | labels | No | Array of `SearchLabel <#createtaskrequestsearchlabel>`__ objects | List of label search criteria. | + +-----------------+-----------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | No | String | If you want to search for multiple labels, **op** must be specified. If you search for only one label, **op** can be left blank. The options are as follows: | + | | | | | + | | | | - **OR**: OR operation | + | | | | | + | | | | - **AND**: AND operation | + +-----------------+-----------------+------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateTaskrequestSearchLabel: + +.. table:: **Table 7** SearchLabel + + +-----------------+-----------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===========================+========================================================================================================================================================================================================================================================================================+ + | name | No | String | Label name. | + +-----------------+-----------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | No | String | Operation type between multiple attributes. The options are as follows: | + | | | | | + | | | | - **OR**: OR operation | + | | | | | + | | | | - **AND**: AND operation | + +-----------------+-----------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | No | Map> | Label attribute, which is in the Object format and stores any key-value pairs. **key** indicates the attribute name, and **value** indicates the value list. If **value** is **null**, the search is not performed by value. Otherwise, the search value can be any value in the list. | + +-----------------+-----------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateTaskrequestSearchProp: + +.. table:: **Table 8** SearchProp + + +-----------------+-----------------+---------------------------+-----------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===========================+=======================================================================+ + | op | No | String | Relationship between attribute values. The options are as follows: | + | | | | | + | | | | - **AND**: AND relationship | + | | | | | + | | | | - **OR**: OR relationship | + +-----------------+-----------------+---------------------------+-----------------------------------------------------------------------+ + | props | No | Map> | Search criteria of an attribute. Multiple search criteria can be set. | + +-----------------+-----------------+---------------------------+-----------------------------------------------------------------------+ + + + +.. _CreateTaskrequestFlavor: + +.. table:: **Table 9** Flavor + + +-----------+-----------+--------+------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+==============================================================================+ + | code | No | String | Attribute code of a resource specification, which is used for task creating. | + +-----------+-----------+--------+------------------------------------------------------------------------------+ + + + +.. _CreateTaskrequestInfConfig: + +.. table:: **Table 10** InfConfig + + +----------------+-----------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +================+===========+====================+============================================================================================================================================================================================================================================+ + | envs | No | Map | (Optional) Environment variable key-value pair required for running a model. By default, this parameter is left blank. To ensure data security, do not enter sensitive information, such as plaintext passwords, in environment variables. | + +----------------+-----------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_count | No | Integer | Instance number of model deployment, that is, the number of compute nodes. | + +----------------+-----------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | No | String | Model ID. | + +----------------+-----------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | specification | No | String | Resource specifications of real-time services. For details, see `Deploying Services <../../service_management/deploying_a_model_as_a_service.html>`__. | + +----------------+-----------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | weight | No | Integer | Traffic weight allocated to a model. This parameter is mandatory only when **infer_type** is set to **real-time**. The sum of the weights must be **100**. | + +----------------+-----------+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateTaskrequestTrainingParameter: + +.. table:: **Table 11** TrainingParameter + + ========= ========= ====== ================ + Parameter Mandatory Type Description + ========= ========= ====== ================ + label No String Parameter name. + value No String Parameter value. + ========= ========= ====== ================ + + + +.. _CreateTaskrequestSampleLabels: + +.. table:: **Table 12** SampleLabels + + +-----------------+-----------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+==================================================================+====================================================================================+ + | labels | No | Array of `SampleLabel <#createtaskrequestsamplelabel>`__ objects | Sample label list. If this parameter is left blank, all sample labels are deleted. | + +-----------------+-----------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | metadata | No | `SampleMetadata <#createtaskrequestsamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------+-----------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_id | No | String | Sample ID. | + +-----------------+-----------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_type | No | Integer | Sample type. The options are as follows: | + | | | | | + | | | | - **0**: image | + | | | | | + | | | | - **1**: text | + | | | | | + | | | | - **2**: speech | + | | | | | + | | | | - **4**: table | + | | | | | + | | | | - **6**: video | + | | | | | + | | | | - **9**: custom format | + +-----------------+-----------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_usage | No | String | Sample usage. The options are as follows: | + | | | | | + | | | | - **TRAIN**: training | + | | | | | + | | | | - **EVAL**: evaluation | + | | | | | + | | | | - **TEST**: test | + | | | | | + | | | | - **INFERENCE**: inference | + +-----------------+-----------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | source | No | String | Source address of sample data. | + +-----------------+-----------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | worker_id | No | String | ID of a labeling team member. | + +-----------------+-----------------+------------------------------------------------------------------+------------------------------------------------------------------------------------+ + + + +.. _CreateTaskrequestSampleLabel: + +.. table:: **Table 13** SampleLabel + + +-----------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+========================================================================+=======================================================================================================================================+ + | annotated_by | No | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | | + | | | | - **human**: manual labeling | + | | | | | + | | | | - **auto**: automatic labeling | + +-----------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | No | String | Label ID. | + +-----------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Label name. | + +-----------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | No | `SampleLabelProperty <#createtaskrequestsamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | No | Float | Confidence. | + +-----------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateTaskrequestSampleLabelProperty: + +.. table:: **Table 14** SampleLabelProperty + + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============================+=================+=================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | No | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | No | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | | + | | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | | + | | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | No | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | No | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | | + | | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | | + | | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | | + | | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | | + | | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | | + | | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | | + | | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | | + | | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | No | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | No | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | | + | | | | - **0/false**: not a hard example | + | | | | | + | | | | - **1/true**: hard example | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | No | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | No | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | | + | | | | - **0**: No target objects are identified. | + | | | | | + | | | | - **1**: The confidence is low. | + | | | | | + | | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | | + | | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | | + | | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | | + | | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | | + | | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | No | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | | + | | | | - **bndbox**: rectangle | + | | | | | + | | | | - **polygon**: polygon | + | | | | | + | | | | - **circle**: circle | + | | | | | + | | | | - **line**: straight line | + | | | | | + | | | | - **dashed**: dotted line | + | | | | | + | | | | - **point**: point | + | | | | | + | | | | - **polyline**: polyline | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | No | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | No | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | No | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | No | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateTaskrequestSampleMetadata: + +.. table:: **Table 15** SampleMetadata + + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============================+=================+===================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | No | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | | + | | | | - **0**: non-hard sample | + | | | | | + | | | | - **1**: hard sample | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | No | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | No | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | | + | | | | - **0**: No target objects are identified. | + | | | | | + | | | | - **1**: The confidence is low. | + | | | | | + | | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | | + | | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | | + | | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | | + | | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | | + | | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | No | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _CreateTaskresponseSmartTaskResp: + +.. table:: **Table 16** Response body parameters + + ========= ====== =========== + Parameter Type Description + ========= ====== =========== + task_id String Task ID. + ========= ====== =========== + +Example Requests +---------------- + +- Starting an Auto Labeling (Active Learning) Task + + .. code-block:: + + { + "task_type" : "auto-label", + "collect_key_sample" : true, + "config" : { + "algorithm_type" : "fast" + } + } + +- Starting an Auto Labeling (Pre-labeling) Task + + .. code-block:: + + { + "task_type" : "pre-label", + "model_id" : "c4989033-7584-44ee-a180-1c476b810e46", + "collect_key_sample" : true, + "config" : { + "inf_config_list" : [ { + "specification" : "modelarts.vm.cpu.2u", + "instance_count" : 1 + } ] + } + } + +- Starting an Auto Grouping Task + + .. code-block:: + + { + "type" : 2, + "export_type" : 1, + "config" : { + "n_clusters" : "2", + "ambiguity" : false, + "image_brightness" : false, + "image_colorfulness" : false, + "property" : "size" + } + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "task_id" : "r0jT2zwxBDKf8KEnSuZ" + } + +Status Codes +------------ + + + +.. _CreateTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/intelligent_task/stopping_an_intelligent_task.rst b/api-ref/source/data_management/intelligent_task/stopping_an_intelligent_task.rst new file mode 100644 index 0000000..4068349 --- /dev/null +++ b/api-ref/source/data_management/intelligent_task/stopping_an_intelligent_task.rst @@ -0,0 +1,77 @@ +Stopping an Intelligent Task +============================ + +Function +-------- + +This API is used to stop intelligent tasks, including auto labeling, one-click model deployment, and auto grouping tasks. You can specify the **task_id** parameter to stop a specific task. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/tasks/{task_id}/stop + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | Task ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Stopping Auto Labeling, One-Click Model Deployment, or Auto Grouping Tasks + +.. code-block:: + + POST https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/tasks/{task_id}/stop + +Example Responses +----------------- + +**Status code: 204** + +No Content + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _StopAutoAnnotationstatuscode: + +=========== ============ +Status Code Description +=========== ============ +204 No Content +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/label_management/creating_a_dataset_label.rst b/api-ref/source/data_management/label_management/creating_a_dataset_label.rst new file mode 100644 index 0000000..26f24e8 --- /dev/null +++ b/api-ref/source/data_management/label_management/creating_a_dataset_label.rst @@ -0,0 +1,248 @@ +Creating a Dataset Label +======================== + +Function +-------- + +This API is used to create a dataset label. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateLabelsrequestCreateLabelsReq: + +.. table:: **Table 2** Request body parameters + + +-----------+-----------+--------------------------------------------------------+-------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========================================================+===============================+ + | labels | No | Array of `Label <#createlabelsrequestlabel>`__ objects | List of labels to be created. | + +-----------+-----------+--------------------------------------------------------+-------------------------------+ + + + +.. _CreateLabelsrequestLabel: + +.. table:: **Table 3** Label + + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+==========================================================================+==================================================================================================================================+ + | attributes | No | Array of `LabelAttribute <#createlabelsrequestlabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Label name. | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | No | `LabelProperty <#createlabelsrequestlabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateLabelsrequestLabelAttribute: + +.. table:: **Table 4** LabelAttribute + + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+====================================================================================+===================================================+ + | default_value | No | String | Default value of a label attribute. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | No | String | Label attribute ID. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | No | String | Label attribute name. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | No | String | Label attribute type. The options are as follows: | + | | | | | + | | | | - **text**: text | + | | | | | + | | | | - **select**: single-choice drop-down list | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | No | Array of `LabelAttributeValue <#createlabelsrequestlabelattributevalue>`__ objects | List of label attribute values. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _CreateLabelsrequestLabelAttributeValue: + +.. table:: **Table 5** LabelAttributeValue + + ========= ========= ====== ========================= + Parameter Mandatory Type Description + ========= ========= ====== ========================= + id No String Label attribute value ID. + value No String Label attribute value. + ========= ========= ====== ========================= + + + +.. _CreateLabelsrequestLabelProperty: + +.. table:: **Table 6** LabelProperty + + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==========================+=================+=================+================================================================================================================================================================================================================+ + | @modelarts:color | No | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | No | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | | + | | | | - **bndbox**: rectangle | + | | | | | + | | | | - **polygon**: polygon | + | | | | | + | | | | - **circle**: circle | + | | | | | + | | | | - **line**: straight line | + | | | | | + | | | | - **dashed**: dotted line | + | | | | | + | | | | - **point**: point | + | | | | | + | | | | - **polyline**: polyline | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | No | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | No | String | Default attribute: The new name of the label. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | No | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | No | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _CreateLabelsresponseCreateLabelsResp: + +.. table:: **Table 7** Response body parameters + + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=========================================================================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------+ + | results | Array of `BatchResponse <#createlabelsresponsebatchresponse>`__ objects | Response body for creating a label. | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------+ + + + +.. _CreateLabelsresponseBatchResponse: + +.. table:: **Table 8** BatchResponse + + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + +Example Requests +---------------- + +Creating a Dataset Label + +.. code-block:: + + { + "labels" : [ { + "name" : "Cat", + "property" : { + "@modelarts:color" : "#3399ff", + "@modelarts:default_shape" : "bndbox" + } + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "success" : true + } + +Status Codes +------------ + + + +.. _CreateLabelsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/label_management/deleting_a_label_and_the_files_that_only_contain_the_label.rst b/api-ref/source/data_management/label_management/deleting_a_label_and_the_files_that_only_contain_the_label.rst new file mode 100644 index 0000000..be7f1f1 --- /dev/null +++ b/api-ref/source/data_management/label_management/deleting_a_label_and_the_files_that_only_contain_the_label.rst @@ -0,0 +1,132 @@ +Deleting a Label and the Files that Only Contain the Label +========================================================== + +Function +-------- + +This API is used to delete a label and the files that only contain this label. + +URI +--- + +DELETE /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels/{label_name} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_name | Yes | String | Label name. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+========================================================================+ + | delete_source | No | Boolean | Whether to delete the sample source files. The options are as follows: | + | | | | | + | | | | - **true**: Delete the sample source files. | + | | | | | + | | | | - **false**: Do not delete the sample source files. (Default value) | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------+ + | label_type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 204** + + + +.. _DeleteLabelAndSamplesresponseDeleteLabelResp: + +.. table:: **Table 3** Response body parameters + + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + +Example Requests +---------------- + +Deleting a Label and the Files that Only Contain the Label + +.. code-block:: + + DELETE https://{endpoint}/v2/{project_id}/datasets/WxCREuCkBSAlQr9xrde/data-annotations/labels/%E8%8D%89%E8%8E%93 + +Example Responses +----------------- + +**Status code: 204** + +No Content + +.. code-block:: + + { + "success" : true + } + +Status Codes +------------ + + + +.. _DeleteLabelAndSamplesstatuscode: + +=========== ============ +Status Code Description +=========== ============ +204 No Content +401 Unauthorized +403 Forbidden +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/label_management/deleting_labels_in_batches.rst b/api-ref/source/data_management/label_management/deleting_labels_in_batches.rst new file mode 100644 index 0000000..9d3131a --- /dev/null +++ b/api-ref/source/data_management/label_management/deleting_labels_in_batches.rst @@ -0,0 +1,258 @@ +Deleting Labels in Batches +========================== + +Function +-------- + +This API is used to delete labels in batches. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels/delete + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==========================================================================================================+ + | delete_policy | No | Integer | Whether to delete a label and samples containing the label. The options are as follows: | + | | | | | + | | | | - **0**: Delete the label. | + | | | | | + | | | | - **1**: Delete the label and the samples that only contain this label, but do not delete source files. | + | | | | | + | | | | - **2**: Delete the label and the samples that only contain this label and also delete source files. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _DeleteLabelsrequestDeleteLabelsReq: + +.. table:: **Table 3** Request body parameters + + +-----------+-----------+--------------------------------------------------------+-------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========================================================+===============================+ + | labels | No | Array of `Label <#deletelabelsrequestlabel>`__ objects | List of labels to be deleted. | + +-----------+-----------+--------------------------------------------------------+-------------------------------+ + + + +.. _DeleteLabelsrequestLabel: + +.. table:: **Table 4** Label + + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+==========================================================================+==================================================================================================================================+ + | attributes | No | Array of `LabelAttribute <#deletelabelsrequestlabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Label name. | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | No | `LabelProperty <#deletelabelsrequestlabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DeleteLabelsrequestLabelAttribute: + +.. table:: **Table 5** LabelAttribute + + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+====================================================================================+===================================================+ + | default_value | No | String | Default value of a label attribute. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | No | String | Label attribute ID. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | No | String | Label attribute name. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | No | String | Label attribute type. The options are as follows: | + | | | | | + | | | | - **text**: text | + | | | | | + | | | | - **select**: single-choice drop-down list | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | No | Array of `LabelAttributeValue <#deletelabelsrequestlabelattributevalue>`__ objects | List of label attribute values. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _DeleteLabelsrequestLabelAttributeValue: + +.. table:: **Table 6** LabelAttributeValue + + ========= ========= ====== ========================= + Parameter Mandatory Type Description + ========= ========= ====== ========================= + id No String Label attribute value ID. + value No String Label attribute value. + ========= ========= ====== ========================= + + + +.. _DeleteLabelsrequestLabelProperty: + +.. table:: **Table 7** LabelProperty + + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==========================+=================+=================+================================================================================================================================================================================================================+ + | @modelarts:color | No | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | No | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | | + | | | | - **bndbox**: rectangle | + | | | | | + | | | | - **polygon**: polygon | + | | | | | + | | | | - **circle**: circle | + | | | | | + | | | | - **line**: straight line | + | | | | | + | | | | - **dashed**: dotted line | + | | | | | + | | | | - **point**: point | + | | | | | + | | | | - **polyline**: polyline | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | No | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | No | String | Default attribute: The new name of the label. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | No | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | No | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DeleteLabelsresponseDeleteLabelsResp: + +.. table:: **Table 8** Response body parameters + + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=========================================================================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------+ + | results | Array of `BatchResponse <#deletelabelsresponsebatchresponse>`__ objects | Response body for deleting a label. | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------+ + + + +.. _DeleteLabelsresponseBatchResponse: + +.. table:: **Table 9** BatchResponse + + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + +Example Requests +---------------- + +Deleting Labels in Batches + +.. code-block:: + + { + "labels" : [ { + "name" : "strawberry" + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "success" : true + } + +Status Codes +------------ + + + +.. _DeleteLabelsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/label_management/index.rst b/api-ref/source/data_management/label_management/index.rst new file mode 100644 index 0000000..3f2d913 --- /dev/null +++ b/api-ref/source/data_management/label_management/index.rst @@ -0,0 +1,13 @@ +================ +Label Management +================ + +.. toctree:: + :maxdepth: 1 + + querying_the_dataset_label_list + creating_a_dataset_label + modifying_labels_in_batches + deleting_labels_in_batches + updating_a_label_by_label_names + deleting_a_label_and_the_files_that_only_contain_the_label diff --git a/api-ref/source/data_management/label_management/modifying_labels_in_batches.rst b/api-ref/source/data_management/label_management/modifying_labels_in_batches.rst new file mode 100644 index 0000000..3c3d0ca --- /dev/null +++ b/api-ref/source/data_management/label_management/modifying_labels_in_batches.rst @@ -0,0 +1,248 @@ +Modifying Labels in Batches +=========================== + +Function +-------- + +This API is used to modify labels in batches. + +URI +--- + +PUT /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateLabelsrequestUpdateLabelsReq: + +.. table:: **Table 2** Request body parameters + + +-----------+-----------+--------------------------------------------------------+-------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========================================================+===============================+ + | labels | No | Array of `Label <#updatelabelsrequestlabel>`__ objects | List of labels to be updated. | + +-----------+-----------+--------------------------------------------------------+-------------------------------+ + + + +.. _UpdateLabelsrequestLabel: + +.. table:: **Table 3** Label + + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+==========================================================================+==================================================================================================================================+ + | attributes | No | Array of `LabelAttribute <#updatelabelsrequestlabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Label name. | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | No | `LabelProperty <#updatelabelsrequestlabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+--------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateLabelsrequestLabelAttribute: + +.. table:: **Table 4** LabelAttribute + + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+====================================================================================+===================================================+ + | default_value | No | String | Default value of a label attribute. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | No | String | Label attribute ID. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | No | String | Label attribute name. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | No | String | Label attribute type. The options are as follows: | + | | | | | + | | | | - **text**: text | + | | | | | + | | | | - **select**: single-choice drop-down list | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | No | Array of `LabelAttributeValue <#updatelabelsrequestlabelattributevalue>`__ objects | List of label attribute values. | + +-----------------+-----------------+------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _UpdateLabelsrequestLabelAttributeValue: + +.. table:: **Table 5** LabelAttributeValue + + ========= ========= ====== ========================= + Parameter Mandatory Type Description + ========= ========= ====== ========================= + id No String Label attribute value ID. + value No String Label attribute value. + ========= ========= ====== ========================= + + + +.. _UpdateLabelsrequestLabelProperty: + +.. table:: **Table 6** LabelProperty + + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==========================+=================+=================+================================================================================================================================================================================================================+ + | @modelarts:color | No | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | No | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | | + | | | | - **bndbox**: rectangle | + | | | | | + | | | | - **polygon**: polygon | + | | | | | + | | | | - **circle**: circle | + | | | | | + | | | | - **line**: straight line | + | | | | | + | | | | - **dashed**: dotted line | + | | | | | + | | | | - **point**: point | + | | | | | + | | | | - **polyline**: polyline | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | No | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | No | String | Default attribute: The new name of the label. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | No | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | No | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _UpdateLabelsresponseUpdateLabelsResp: + +.. table:: **Table 7** Response body parameters + + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=========================================================================+==================================================================+ + | error_code | String | Error code. | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------+ + | results | Array of `BatchResponse <#updatelabelsresponsebatchresponse>`__ objects | Response body for updating labels. | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------+ + | success | Boolean | Whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: successful | + | | | | + | | | - **false**: failed | + +-----------------------+-------------------------------------------------------------------------+------------------------------------------------------------------+ + + + +.. _UpdateLabelsresponseBatchResponse: + +.. table:: **Table 8** BatchResponse + + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + +Example Requests +---------------- + +Modifying Labels in Batches + +.. code-block:: + + { + "labels" : [ { + "name" : "Cat", + "property" : { + "@modelarts:color" : "#8a1524", + "@modelarts:rename_to" : "pussycat" + } + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "success" : true + } + +Status Codes +------------ + + + +.. _UpdateLabelsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/label_management/querying_the_dataset_label_list.rst b/api-ref/source/data_management/label_management/querying_the_dataset_label_list.rst new file mode 100644 index 0000000..a7a31f5 --- /dev/null +++ b/api-ref/source/data_management/label_management/querying_the_dataset_label_list.rst @@ -0,0 +1,220 @@ +Querying the Dataset Label List +=============================== + +Function +-------- + +This API is used to query all labels of a dataset. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + ========== ========= ====== =================== + Parameter Mandatory Type Description + ========== ========= ====== =================== + version_id No String Dataset version ID. + ========== ========= ====== =================== + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListLabelsresponseListLabelsResp: + +.. table:: **Table 3** Response body parameters + + +-----------+-------------------------------------------------------+-------------+ + | Parameter | Type | Description | + +===========+=======================================================+=============+ + | labels | Array of `Label <#listlabelsresponselabel>`__ objects | Label list. | + +-----------+-------------------------------------------------------+-------------+ + + + +.. _ListLabelsresponseLabel: + +.. table:: **Table 4** Label + + +-----------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=========================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#listlabelsresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#listlabelsresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListLabelsresponseLabelAttribute: + +.. table:: **Table 5** LabelAttribute + + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===================================================================================+===================================================+ + | default_value | String | Default value of a label attribute. | + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + | id | String | Label attribute ID. | + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + | name | String | Label attribute name. | + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + | type | String | Label attribute type. The options are as follows: | + | | | | + | | | - **text**: text | + | | | | + | | | - **select**: single-choice drop-down list | + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + | values | Array of `LabelAttributeValue <#listlabelsresponselabelattributevalue>`__ objects | List of label attribute values. | + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _ListLabelsresponseLabelAttributeValue: + +.. table:: **Table 6** LabelAttributeValue + + ========= ====== ========================= + Parameter Type Description + ========= ====== ========================= + id String Label attribute value ID. + value String Label attribute value. + ========= ====== ========================= + + + +.. _ListLabelsresponseLabelProperty: + +.. table:: **Table 7** LabelProperty + + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+=======================+================================================================================================================================================================================================================+ + | @modelarts:color | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | String | Default attribute: The new name of the label. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying All Labels of a Dataset + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/WxCREuCkBSAlQr9xrde/data-annotations/labels + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "labels" : [ { + "name" : "Cat", + "type" : 1, + "property" : { + "@modelarts:color" : "#3399ff" + } + }, { + "name" : "Dog", + "type" : 1, + "property" : { + "@modelarts:color" : "#3399ff" + } + } ] + } + +Status Codes +------------ + + + +.. _ListLabelsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/label_management/updating_a_label_by_label_names.rst b/api-ref/source/data_management/label_management/updating_a_label_by_label_names.rst new file mode 100644 index 0000000..49bdea5 --- /dev/null +++ b/api-ref/source/data_management/label_management/updating_a_label_by_label_names.rst @@ -0,0 +1,161 @@ +Updating a Label by Label Names +=============================== + +Function +-------- + +This API is used to update a label by label names. + +URI +--- + +PUT /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels/{label_name} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_name | Yes | String | Label name. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+-----------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=========================================+ + | label_type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+-----------------+-----------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateLabelrequestUpdateLabelReq: + +.. table:: **Table 3** Request body parameters + + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==========================+=================+=================+================================================================================================================================================================================================================+ + | @modelarts:color | No | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | No | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | | + | | | | - **bndbox**: rectangle | + | | | | | + | | | | - **polygon**: polygon | + | | | | | + | | | | - **circle**: circle | + | | | | | + | | | | - **line**: straight line | + | | | | | + | | | | - **dashed**: dotted line | + | | | | | + | | | | - **point**: point | + | | | | | + | | | | - **polyline**: polyline | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | No | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | No | String | Default attribute: The new name of the label. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | No | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | No | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 204** + + + +.. _UpdateLabelresponseUpdateLabelResp: + +.. table:: **Table 4** Response body parameters + + +-----------------------+-----------------------+------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------+ + | success | Boolean | Whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: successful | + | | | | + | | | - **false**: failed | + +-----------------------+-----------------------+------------------------------------------------------------------+ + +Example Requests +---------------- + +Updating a Label by Label Names + +.. code-block:: + + { + "@modelarts:color" : "#93c47d" + } + +Example Responses +----------------- + +**Status code: 204** + +No Content + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _UpdateLabelstatuscode: + +=========== ============ +Status Code Description +=========== ============ +204 No Content +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_task_management/creating_a_team_labeling_acceptance_task.rst b/api-ref/source/data_management/labeling_task_management/creating_a_team_labeling_acceptance_task.rst new file mode 100644 index 0000000..4f258ac --- /dev/null +++ b/api-ref/source/data_management/labeling_task_management/creating_a_team_labeling_acceptance_task.rst @@ -0,0 +1,105 @@ +Creating a Team Labeling Acceptance Task +======================================== + +Function +-------- + +This API is used to create a team labeling acceptance task. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/acceptance + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a team labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _StartWorkforceSamplingTaskrequestCreateWorkforceSamplingTaskReq: + +.. table:: **Table 2** Request body parameters + + +---------------+-----------+---------+-------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===============+===========+=========+===============================================================================================================================+ + | sampling_num | No | Integer | Number of samples for the acceptance task. Either this parameter or the sampling ratio is delivered. | + +---------------+-----------+---------+-------------------------------------------------------------------------------------------------------------------------------+ + | sampling_rate | No | Double | Sampling ratio of the acceptance task. The value range is (0,1]. Either this parameter or the number of samples is delivered. | + +---------------+-----------+---------+-------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _StartWorkforceSamplingTaskresponseCreateWorkforceSamplingTaskResp: + +.. table:: **Table 3** Response body parameters + + ========= ====== ====================================== + Parameter Type Description + ========= ====== ====================================== + task_id String ID of an asynchronous acceptance task. + ========= ====== ====================================== + +Example Requests +---------------- + +Creating a Team Labeling Acceptance Task and Setting the Sampling Percentage to 20% + +.. code-block:: + + { + "sampling_rate" : 0.2 + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "task_id" : "nv6BbozxCJmZcHAE9hV" + } + +Status Codes +------------ + + + +.. _StartWorkforceSamplingTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_task_management/creating_a_team_labeling_task.rst b/api-ref/source/data_management/labeling_task_management/creating_a_team_labeling_task.rst new file mode 100644 index 0000000..12e9769 --- /dev/null +++ b/api-ref/source/data_management/labeling_task_management/creating_a_team_labeling_task.rst @@ -0,0 +1,231 @@ +Creating a Team Labeling Task +============================= + +Function +-------- + +This API is used to create a team labeling task. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/workforce-tasks + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateWorkforceTaskrequestCreateWorkforceTaskReq: + +.. table:: **Table 2** Request body parameters + + +--------------------------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +================================+=================+===========================================================================+=====================================================================================================================+ + | auto_sync_dataset | No | Boolean | Whether to automatically synchronize the result of a team labeling task to the dataset. The options are as follows: | + | | | | | + | | | | - **true**: Automatically synchronize the result of a team labeling task to the dataset. (Default value) | + | | | | | + | | | | - **false**: Do not automatically synchronize the result of a team labeling task to the dataset. | + +--------------------------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+ + | data_sync_type | No | Integer | Synchronization type. The options are as follows: | + | | | | | + | | | | - **0**: not to be synchronized | + | | | | | + | | | | - **1**: data to be synchronized | + | | | | | + | | | | - **2**: label to be synchronized | + | | | | | + | | | | - **3**: data and label to be synchronized | + +--------------------------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+ + | repetition | No | Integer | Number of persons who label each sample in a team labeling task. The minimum value is **1**. | + +--------------------------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+ + | sample_conditions | No | String | Search conditions of dataset samples. Samples that meet the conditions are filtered for team labeling. | + +--------------------------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+ + | synchronize_auto_labeling_data | No | Boolean | Whether to synchronize the auto labeling result of a team labeling task. The options are as follows: | + | | | | | + | | | | - **true**: Synchronize the results to be confirmed to team members after auto labeling is complete. | + | | | | | + | | | | - **false**: Do not synchronize the auto labeling results. (Default value) | + +--------------------------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+ + | workforces_config | No | `WorkforcesConfig <#createworkforcetaskrequestworkforcesconfig>`__ object | Team labeling task information: Tasks can be assigned by the team administrator or a specified team. | + +--------------------------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateWorkforceTaskrequestWorkforcesConfig: + +.. table:: **Table 3** WorkforcesConfig + + +------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+===================================================================================+============================================+ + | agency | No | String | Administrator. | + +------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------+ + | workforces | No | Array of `WorkforceConfig <#createworkforcetaskrequestworkforceconfig>`__ objects | List of teams that execute labeling tasks. | + +------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------+ + + + +.. _CreateWorkforceTaskrequestWorkforceConfig: + +.. table:: **Table 4** WorkforceConfig + + +----------------+-----------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +================+===========+=================================================================+=================================================================================================================================+ + | workers | No | Array of `Worker <#createworkforcetaskrequestworker>`__ objects | List of labeling team members. | + +----------------+-----------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | No | String | ID of a labeling team. | + +----------------+-----------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | No | String | Name of a labeling team. The value contains 0 to 1024 characters and does not support the following special characters: !<>=&"' | + +----------------+-----------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateWorkforceTaskrequestWorker: + +.. table:: **Table 5** Worker + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==========================================================================================================================================+ + | create_time | No | Long | Creation time. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | No | String | Email address of a labeling team member. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | No | Integer | Role. The options are as follows: | + | | | | | + | | | | - **0**: labeling personnel | + | | | | | + | | | | - **1**: reviewer | + | | | | | + | | | | - **2**: team administrator | + | | | | | + | | | | - **3**: dataset owner | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | No | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | | + | | | | - **0**: The invitation email has not been sent. | + | | | | | + | | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | | + | | | | - **2**: The user has logged in. | + | | | | | + | | | | - **3**: The labeling team member has been deleted. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | No | Long | Update time. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | No | String | ID of a labeling team member. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | No | String | ID of a labeling team. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _CreateWorkforceTaskresponseCreateWorkforceTaskResp: + +.. table:: **Table 6** Response body parameters + + ========= ====== =========================== + Parameter Type Description + ========= ====== =========================== + task_id String ID of a team labeling task. + ========= ====== =========================== + +Example Requests +---------------- + +Creating a Team Labeling Task + +.. code-block:: + + { + "workspace_id" : "0", + "task_name" : "task-eb17", + "task_type" : 0, + "description" : "", + "version_id" : "", + "labels" : [ { + "name" : "Cat", + "type" : 0, + "property" : { + "@modelarts:color" : "#3399ff" + } + }, { + "name" : "Dog", + "type" : 0, + "property" : { + "@modelarts:color" : "#3399ff" + } + } ], + "synchronize_data" : false, + "synchronize_auto_labeling_data" : false, + "workforces_config" : { + "workforces" : [ { + "workforce_id" : "feSUo5NUIUnQAQNNTiS", + "workers" : [ { + "email" : "xxx@xxx.com" + }, { + "email" : "xxx@xxx.com" + }, { + "email" : "xxx@xxx.com" + } ] + } ] + }, + "auto_sync_dataset" : false + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "task_id" : "6phXEto29utpaMwbQkg" + } + +Status Codes +------------ + + + +.. _CreateWorkforceTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_task_management/deleting_a_team_labeling_task.rst b/api-ref/source/data_management/labeling_task_management/deleting_a_team_labeling_task.rst new file mode 100644 index 0000000..26b257f --- /dev/null +++ b/api-ref/source/data_management/labeling_task_management/deleting_a_team_labeling_task.rst @@ -0,0 +1,76 @@ +Deleting a Team Labeling Task +============================= + +Function +-------- + +This API is used to delete a team labeling task. + +URI +--- + +DELETE /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id} + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a team labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Deleting a Team Labeling Task + +.. code-block:: + + DELETE https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id} + +Example Responses +----------------- + +**Status code: 204** + +No Content + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _DeleteWorkforceTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +204 No Content +401 Unauthorized +403 Forbidden +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_task_management/index.rst b/api-ref/source/data_management/labeling_task_management/index.rst new file mode 100644 index 0000000..725a34b --- /dev/null +++ b/api-ref/source/data_management/labeling_task_management/index.rst @@ -0,0 +1,17 @@ +======================== +Labeling Task Management +======================== + +.. toctree:: + :maxdepth: 1 + + querying_the_team_labeling_task_list_of_a_dataset + creating_a_team_labeling_task + querying_details_about_a_team_labeling_task + starting_a_team_labeling_task + updating_a_team_labeling_task + deleting_a_team_labeling_task + creating_a_team_labeling_acceptance_task + querying_the_report_of_a_team_labeling_acceptance_task + updating_the_status_of_a_team_labeling_acceptance_task + querying_the_team_labeling_task_list_by_a_team_member diff --git a/api-ref/source/data_management/labeling_task_management/querying_details_about_a_team_labeling_task.rst b/api-ref/source/data_management/labeling_task_management/querying_details_about_a_team_labeling_task.rst new file mode 100644 index 0000000..726b309 --- /dev/null +++ b/api-ref/source/data_management/labeling_task_management/querying_details_about_a_team_labeling_task.rst @@ -0,0 +1,728 @@ +Querying Details About a Team Labeling Task +=========================================== + +Function +-------- + +This API is used to query the details about a team labeling task. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id} + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a team labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=====================================================================+ + | label_stats | No | Boolean | Whether to return label statistics. The options are as follows: | + | | | | | + | | | | - **true**: Return label statistics. | + | | | | | + | | | | - **false**: Do not return label statistics. (Default value) | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | sample_stats | No | Boolean | Whether to return sample statistics. The options are as follows: | + | | | | | + | | | | - **true**: Return sample statistics. | + | | | | | + | | | | - **false**: Do not return sample statistics. (Default value) | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | workforce_stats | No | Boolean | Whether to return personnel statistics. The options are as follows: | + | | | | | + | | | | - **true**: Return personnel statistics. | + | | | | | + | | | | - **false**: Do not return personnel statistics. (Default value) | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DescWorkforceTaskresponseDescWorkforceTaskResp: + +.. table:: **Table 3** Response body parameters + + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================================+============================================================================================+===================================================================================================================================================================================================================================================================================================================================================+ + | auto_sync_dataset | Boolean | Whether to automatically synchronize the result of a team labeling task to the dataset. The options are as follows: | + | | | | + | | | - **true**: Automatically synchronize the result of a team labeling task to the dataset. | + | | | | + | | | - **false**: Do not automatically synchronize the result of a team labeling task to the dataset. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | check_rate | Double | Acceptance ratio of a team labeling task. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | checking_task_desc | `WorkforceSamplingTaskDesc <#descworkforcetaskresponseworkforcesamplingtaskdesc>`__ object | Details about the current acceptance task of a team labeling task. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a labeling task is created. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | String | Dataset ID. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description of a labeling task. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_stats | Array of `LabelStats <#descworkforcetaskresponselabelstats>`__ objects | Label statistics of a labeling task. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pass_rate | Double | Acceptance pass rate of a team labeling task. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | repetition | Integer | Number of persons who label each sample in a team labeling task. The minimum value is **1**. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_search_conditions | Array of `SearchCondition <#descworkforcetaskresponsesearchcondition>`__ objects | Sample search conditions when creating a task. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_stats | `SampleStats <#descworkforcetaskresponsesamplestats>`__ object | Sample statistics of a labeling task. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | score | Double | Average acceptance score of a team labeling task. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Status of a team labeling task. The options are as follows: | + | | | | + | | | - **6**: created. The owner has created a task but does not start it. Only the owner and manager can view the task list. | + | | | | + | | | - **0**: starting. The owner or manager starts the task and assigns the files to be labeled. The owner, manager, labeler, and reviewer can view the task list. If the task assignment is not complete, a new task cannot be started. | + | | | | + | | | - **1**: running. The task is labeled and reviewed by the labeler and reviewer, respectively and is accepted by the owner. If auto labeling files are added or synchronized, or unlabeled files are imported, the new files need to be assigned again. | + | | | | + | | | - **2**: under acceptance. The owner initiates an acceptance task but does not complete it. In this state, a new acceptance task cannot be initiated until the current one is completed. | + | | | | + | | | - **3**: passed. The team labeling task has been completed. | + | | | | + | | | - **4**: rejected. In this state, the manager starts the task again and assigns it for labeling and reviewing. | + | | | | + | | | - **5**: synchronizing acceptance result. This state is displayed when acceptance tasks are changed to be asynchronous. In this state, new acceptance tasks cannot be initiated and the current acceptance task cannot be continued. In the task name area, a message is displayed, indicating that the acceptance result is being synchronized. | + | | | | + | | | - **7**: acceptance sampling. This state is displayed when acceptance tasks are changed to be asynchronous. In this state, new acceptance tasks cannot be initiated and the current acceptance task cannot be continued. In the task name area, a message is displayed, indicating that the acceptance sampling is in progress. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | synchronize_auto_labeling_data | Boolean | Whether to synchronize the auto labeling result of a team labeling task. The options are as follows: | + | | | | + | | | - **true**: Synchronize the results to be confirmed to team members after auto labeling is complete. | + | | | | + | | | - **false**: Do not synchronize the auto labeling results. (Default value) | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | synchronize_data | Boolean | Whether to synchronize the added data of a team labeling task. The options are as follows: | + | | | | + | | | - **true**: Upload files, synchronize data sources, and synchronize imported unlabeled files to team members. | + | | | | + | | | - **false**: Do not synchronize the added data. (Default value) | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | String | ID of a labeling task. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_name | String | Name of a labeling task. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a labeling task is updated. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Version ID of the dataset associated with a labeling task. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_stats | Array of `WorkerTask <#descworkforcetaskresponseworkertask>`__ objects | Labeling progress statistics on team labeling task members. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_stats | `WorkforceStats <#descworkforcetaskresponseworkforcestats>`__ object | Statistics on team labeling task members. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforces_config | `WorkforcesConfig <#descworkforcetaskresponseworkforcesconfig>`__ object | Team labeling task information: Tasks can be assigned by the team administrator or a specified team. | + +--------------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseWorkforceSamplingTaskDesc: + +.. table:: **Table 4** WorkforceSamplingTaskDesc + + +-----------------------+----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+======================================================================+==================================================================================================================================================+ + | action | Integer | Action after the acceptance. The options are as follows: | + | | | | + | | | - **0**: Pass all samples when the acceptance is completed (including single-rejected samples) | + | | | | + | | | - **1**: Reject all samples when the acceptance is completed (including single-accepted samples) | + | | | | + | | | - **4**: Pass only single-accepted samples and unaccepted samples. | + | | | | + | | | - **5**: Reject only single-rejected samples and unaccepted samples. | + +-----------------------+----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + | checking_stats | `CheckTaskStats <#descworkforcetaskresponsechecktaskstats>`__ object | Real-time report of acceptance tasks. | + +-----------------------+----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + | checking_task_id | String | ID of the current acceptance task. | + +-----------------------+----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + | overwrite_last_result | Boolean | Whether to use the acceptance result to overwrite the labeled result if a sample has been labeled during acceptance. The options are as follows: | + | | | | + | | | - **true**: Overwrite the labeled result. | + | | | | + | | | - **false**: Do not overwrite the labeled result. (Default value) | + +-----------------------+----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_stats | `CheckTaskStats <#descworkforcetaskresponsechecktaskstats>`__ object | Overall report of historical acceptance tasks. | + +-----------------------+----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseCheckTaskStats: + +.. table:: **Table 5** CheckTaskStats + + ====================== ======= ==================================== + Parameter Type Description + ====================== ======= ==================================== + accepted_sample_count Integer Accepted samples. + checked_sample_count Integer Checked samples. + pass_rate Double Pass rate of samples. + rejected_sample_count Integer Rejected samples. + sampled_sample_count Integer Number of sampled samples. + sampling_num Integer Samples of an acceptance task. + sampling_rate Double Sampling rate of an acceptance task. + score String Acceptance score. + task_id String ID of an acceptance task. + total_sample_count Integer Total samples. + total_score Long Total acceptance score. + unchecked_sample_count Integer Unchecked samples. + ====================== ======= ==================================== + + + +.. _DescWorkforceTaskresponseLabelStats: + +.. table:: **Table 6** LabelStats + + +-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+================================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#descworkforcetaskresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | count | Integer | Number of labels. | + +-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#descworkforcetaskresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | sample_count | Integer | Number of samples containing the label. | + +-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseLabelAttribute: + +.. table:: **Table 7** LabelAttribute + + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==========================================================================================+===================================================+ + | default_value | String | Default value of a label attribute. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | String | Label attribute ID. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | String | Label attribute name. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | String | Label attribute type. The options are as follows: | + | | | | + | | | - **text**: text | + | | | | + | | | - **select**: single-choice drop-down list | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | Array of `LabelAttributeValue <#descworkforcetaskresponselabelattributevalue>`__ objects | List of label attribute values. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseLabelAttributeValue: + +.. table:: **Table 8** LabelAttributeValue + + ========= ====== ========================= + Parameter Type Description + ========= ====== ========================= + id String Label attribute value ID. + value String Label attribute value. + ========= ====== ========================= + + + +.. _DescWorkforceTaskresponseLabelProperty: + +.. table:: **Table 9** LabelProperty + + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+=======================+================================================================================================================================================================================================================+ + | @modelarts:color | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | String | Default attribute: The new name of the label. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseSearchCondition: + +.. table:: **Table 10** SearchCondition + + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==================================================================+==================================================================================================================================================================================================================================================================+ + | coefficient | String | Filter by coefficient of difficulty. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | frame_in_video | Integer | A frame in the video. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | hard | String | Whether a sample is a hard sample. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_origin | String | Filter by data source. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | kvp | String | CT dosage, filtered by dosage. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_list | `SearchLabels <#descworkforcetaskresponsesearchlabels>`__ object | Label search criteria. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labeler | String | Labeler. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SearchProp <#descworkforcetaskresponsesearchprop>`__ object | Search by sample attribute. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parent_sample_id | String | Parent sample ID. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Directory where data samples are stored (the directory must end with a slash (/)). Only samples in the specified directory are searched for. Recursive search of directories is not supported. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Search by sample name, including the file name extension. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | String | When a sample is added to the dataset, an index is created based on the last modification time (accurate to day) of the sample on OBS. You can search for the sample based on the time. The options are as follows: | + | | | | + | | | - **month**: Search for samples added from 30 days ago to the current day. | + | | | | + | | | - **day**: Search for samples added from yesterday (one day ago) to the current day. | + | | | | + | | | - **yyyyMMdd-yyyyMMdd**: Search for samples added in a specified period (at most 30 days), in the format of **Start date-End date**. For example, **20190901-2019091501** indicates that samples generated from September 1 to September 15, 2019 are searched. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Search by confidence. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | slice_thickness | String | DICOM layer thickness. Samples are filtered by layer thickness. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | study_date | String | DICOM scanning time. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time_in_video | String | A time point in the video. | + +-----------------------+------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseSearchLabels: + +.. table:: **Table 11** SearchLabels + + +-----------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==========================================================================+==============================================================================================================================================================+ + | labels | Array of `SearchLabel <#descworkforcetaskresponsesearchlabel>`__ objects | List of label search criteria. | + +-----------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | If you want to search for multiple labels, **op** must be specified. If you search for only one label, **op** can be left blank. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+--------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseSearchLabel: + +.. table:: **Table 12** SearchLabel + + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+========================================================================================================================================================================================================================================================================================+ + | name | String | Label name. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | Operation type between multiple attributes. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | Map> | Label attribute, which is in the Object format and stores any key-value pairs. **key** indicates the attribute name, and **value** indicates the value list. If **value** is **null**, the search is not performed by value. Otherwise, the search value can be any value in the list. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseSearchProp: + +.. table:: **Table 13** SearchProp + + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+=======================================================================+ + | op | String | Relationship between attribute values. The options are as follows: | + | | | | + | | | - **AND**: AND relationship | + | | | | + | | | - **OR**: OR relationship | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | props | Map> | Search criteria of an attribute. Multiple search criteria can be set. | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseSampleStats: + +.. table:: **Table 14** SampleStats + + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============================+=========+=====================================================================================================+ + | accepted_sample_count | Integer | Number of samples accepted by the owner. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | auto_annotation_sample_count | Integer | Number of samples to be confirmed after intelligent labeling. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | deleted_sample_count | Integer | Number of deleted samples. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | rejected_sample_count | Integer | Number of samples that failed to pass the owner acceptance. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | sampled_sample_count | Integer | Number of samples that are to be accepted by the owner and sampled. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of samples. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | unannotated_sample_count | Integer | Number of unlabeled samples. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | uncheck_sample_count | Integer | Number of samples that have been approved by the reviewer and are to be accepted by the owner. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | unreviewed_sample_count | Integer | Number of samples that have been labeled by the labeler but have not been reviewed by the reviewer. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseWorkerTask: + +.. table:: **Table 15** WorkerTask + + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+================================================================+==================================================================================================+ + | create_time | Long | Time when a labeling team member's task is created. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | dataset_id | String | ID of a dataset associated with a labeling team member's task. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | dataset_type | Integer | Labeling type of a team member's task. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | email_status | Integer | Email notification status of a labeling team member's labeling task. The options are as follows: | + | | | | + | | | - **0**: The email has not been sent. | + | | | | + | | | - **1**: The email format is incorrect. | + | | | | + | | | - **2**: The email address is unreachable. | + | | | | + | | | - **3**: The email has been sent. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | last_notify_time | Long | Timestamp of the latest notification email sent to a labeling team member. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | pass_rate | Double | Pass rate of task acceptance review for a labeling team member. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | role | Integer | Role of a labeling team member. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | sample_stats | `SampleStats <#descworkforcetaskresponsesamplestats>`__ object | Sample statistics of a labeling team member's task. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | score | Double | Average acceptance score of labeling team members' task samples. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | task_id | String | Team labeling task ID associated with a member's task. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | task_status | Integer | Task status of a labeling team member. The options are as follows: | + | | | | + | | | - **6**: created | + | | | | + | | | - **0**: starting | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: under acceptance | + | | | | + | | | - **3**: approved, indicating the team labeling task is complete | + | | | | + | | | - **4**: rejected, indicating that the task needs to be labeled and reviewed again | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a labeling team member's task is updated. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | workforce_task_name | String | Team labeling task name associated with a member's task. | + +-----------------------+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseWorkforceStats: + +.. table:: **Table 16** WorkforceStats + + =============== ======= =========================== + Parameter Type Description + =============== ======= =========================== + labeler_count Integer Number of labeling persons. + reviewer_count Integer Number of reviewers. + workforce_count Integer Number of teams. + =============== ======= =========================== + + + +.. _DescWorkforceTaskresponseWorkforcesConfig: + +.. table:: **Table 17** WorkforcesConfig + + +------------+----------------------------------------------------------------------------------+--------------------------------------------+ + | Parameter | Type | Description | + +============+==================================================================================+============================================+ + | agency | String | Administrator. | + +------------+----------------------------------------------------------------------------------+--------------------------------------------+ + | workforces | Array of `WorkforceConfig <#descworkforcetaskresponseworkforceconfig>`__ objects | List of teams that execute labeling tasks. | + +------------+----------------------------------------------------------------------------------+--------------------------------------------+ + + + +.. _DescWorkforceTaskresponseWorkforceConfig: + +.. table:: **Table 18** WorkforceConfig + + +----------------+----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+================================================================+=================================================================================================================================+ + | workers | Array of `Worker <#descworkforcetaskresponseworker>`__ objects | List of labeling team members. | + +----------------+----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +----------------+----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | String | Name of a labeling team. The value contains 0 to 1024 characters and does not support the following special characters: !<>=&"' | + +----------------+----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescWorkforceTaskresponseWorker: + +.. table:: **Table 19** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About a Team Labeling Task + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "dataset_id" : "WxCREuCkBSAlQr9xrde", + "task_id" : "iYZx7gScPUozOXner9k", + "task_name" : "task-e63f", + "status" : 1, + "create_time" : 1606184400278, + "update_time" : 1606184400278, + "repetition" : 1, + "workforces_config" : { + "workforces" : [ { + "workforce_id" : "q3ZFSwORu1ztKljDLYQ", + "workers" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "afdda13895bc66322ffbf36ae833bcf0", + "role" : 0 + } ] + } ] + }, + "synchronize_data" : false, + "synchronize_auto_labeling_data" : false, + "workforce_stats" : { + "workforce_count" : 1, + "labeler_count" : 1, + "reviewer_count" : 0 + }, + "sample_stats" : { + "total_sample_count" : 317, + "unannotated_sample_count" : 310, + "unreviewed_sample_count" : 0, + "uncheck_sample_count" : 0, + "sampled_sample_count" : 0, + "rejected_sample_count" : 0, + "accepted_sample_count" : 7, + "auto_annotation_sample_count" : 0 + }, + "checking_task_desc" : { + "checking_task_id" : "onSbri2oqYOmDjDyW17", + "action" : 0, + "overwrite_last_result" : false + }, + "auto_check_samples" : true, + "auto_sync_dataset" : true, + "worker_stats" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "afdda13895bc66322ffbf36ae833bcf0", + "role" : 0, + "task_id" : "iYZx7gScPUozOXner9k", + "workforce_task_name" : "task-e63f", + "dataset_id" : "WxCREuCkBSAlQr9xrde", + "sample_stats" : { + "total_sample_count" : 317, + "unannotated_sample_count" : 310, + "unreviewed_sample_count" : 0, + "uncheck_sample_count" : 0, + "sampled_sample_count" : 0, + "rejected_sample_count" : 0, + "accepted_sample_count" : 7, + "auto_annotation_sample_count" : 0 + }, + "create_time" : 1606184400278, + "update_time" : 1606184795050, + "email_status" : 3, + "last_notify_time" : 0, + "user" : { + "domainId" : "04f924738800d3270fc0c013a47363a0", + "domainName" : "test_123", + "projectId" : "04f924739300d3272fc3c013e36bb4b8", + "userId" : "04f924743b00d4331f31c0131ada6769", + "userName" : "test_123" + } + } ] + } + +Status Codes +------------ + + + +.. _DescWorkforceTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_task_management/querying_the_report_of_a_team_labeling_acceptance_task.rst b/api-ref/source/data_management/labeling_task_management/querying_the_report_of_a_team_labeling_acceptance_task.rst new file mode 100644 index 0000000..54555d3 --- /dev/null +++ b/api-ref/source/data_management/labeling_task_management/querying_the_report_of_a_team_labeling_acceptance_task.rst @@ -0,0 +1,136 @@ +Querying the Report of a Team Labeling Acceptance Task +====================================================== + +Function +-------- + +This API is used to query the report of a team labeling acceptance task. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/acceptance/report + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a team labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + ================ ========= ====== ===================================== + Parameter Mandatory Type Description + ================ ========= ====== ===================================== + checking_task_id Yes String ID of the task that is being checked. + ================ ========= ====== ===================================== + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _GetWorkforceSamplingTaskresponseCheckWorkforceSamplingTaskResp: + +.. table:: **Table 3** Response body parameters + + +----------------+-----------------------------------------------------------------------------+----------------------------------+ + | Parameter | Type | Description | + +================+=============================================================================+==================================+ + | checking_stats | `CheckTaskStats <#getworkforcesamplingtaskresponsechecktaskstats>`__ object | Real-time acceptance statistics. | + +----------------+-----------------------------------------------------------------------------+----------------------------------+ + | total_stats | `CheckTaskStats <#getworkforcesamplingtaskresponsechecktaskstats>`__ object | Historical statistics. | + +----------------+-----------------------------------------------------------------------------+----------------------------------+ + + + +.. _GetWorkforceSamplingTaskresponseCheckTaskStats: + +.. table:: **Table 4** CheckTaskStats + + ====================== ======= ==================================== + Parameter Type Description + ====================== ======= ==================================== + accepted_sample_count Integer Accepted samples. + checked_sample_count Integer Checked samples. + pass_rate Double Pass rate of samples. + rejected_sample_count Integer Rejected samples. + sampled_sample_count Integer Number of sampled samples. + sampling_num Integer Samples of an acceptance task. + sampling_rate Double Sampling rate of an acceptance task. + score String Acceptance score. + task_id String ID of an acceptance task. + total_sample_count Integer Total samples. + total_score Long Total acceptance score. + unchecked_sample_count Integer Unchecked samples. + ====================== ======= ==================================== + +Example Requests +---------------- + +Querying the Report of a Team Labeling Acceptance Task + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/acceptance/report + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "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 + } + } + +Status Codes +------------ + + + +.. _GetWorkforceSamplingTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_task_management/querying_the_team_labeling_task_list_by_a_team_member.rst b/api-ref/source/data_management/labeling_task_management/querying_the_team_labeling_task_list_by_a_team_member.rst new file mode 100644 index 0000000..0a8fe24 --- /dev/null +++ b/api-ref/source/data_management/labeling_task_management/querying_the_team_labeling_task_list_by_a_team_member.rst @@ -0,0 +1,262 @@ +Querying the Team Labeling Task List by a Team Member +===================================================== + +Function +-------- + +This API is used to query the team labeling task list by a team member. + +URI +--- + +GET /v2/{project_id}/workforces/worker-tasks + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+===============================================================================================================+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting method. The options are as follows: | + | | | | | + | | | | - **asc**: ascending order | + | | | | | + | | | | - **desc**: descending order (default value) | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | search_content | No | String | Fuzzy search keyword. By default, this parameter is left blank. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Sorting mode of the query. The options are as follows: | + | | | | | + | | | | - **create_time**: Sort by creation time. (Default value) | + | | | | | + | | | | - **workforce_task_name**: Sort by task name. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListWorkerTasksresponseListWorkerTasksResp: + +.. table:: **Table 3** Response body parameters + + +--------------+----------------------------------------------------------------------+------------------------------------------+ + | Parameter | Type | Description | + +==============+======================================================================+==========================================+ + | count | Integer | Total number of team labeling tasks. | + +--------------+----------------------------------------------------------------------+------------------------------------------+ + | worker_tasks | Array of `WorkerTask <#listworkertasksresponseworkertask>`__ objects | Team labeling task list queried by page. | + +--------------+----------------------------------------------------------------------+------------------------------------------+ + + + +.. _ListWorkerTasksresponseWorkerTask: + +.. table:: **Table 4** WorkerTask + + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==============================================================+==================================================================================================+ + | create_time | Long | Time when a labeling team member's task is created. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | dataset_id | String | ID of a dataset associated with a labeling team member's task. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | dataset_type | Integer | Labeling type of a team member's task. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | email_status | Integer | Email notification status of a labeling team member's labeling task. The options are as follows: | + | | | | + | | | - **0**: The email has not been sent. | + | | | | + | | | - **1**: The email format is incorrect. | + | | | | + | | | - **2**: The email address is unreachable. | + | | | | + | | | - **3**: The email has been sent. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | last_notify_time | Long | Timestamp of the latest notification email sent to a labeling team member. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | pass_rate | Double | Pass rate of task acceptance review for a labeling team member. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | role | Integer | Role of a labeling team member. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | sample_stats | `SampleStats <#listworkertasksresponsesamplestats>`__ object | Sample statistics of a labeling team member's task. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | score | Double | Average acceptance score of labeling team members' task samples. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | task_id | String | Team labeling task ID associated with a member's task. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | task_status | Integer | Task status of a labeling team member. The options are as follows: | + | | | | + | | | - **6**: created | + | | | | + | | | - **0**: starting | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: under acceptance | + | | | | + | | | - **3**: approved, indicating the team labeling task is complete | + | | | | + | | | - **4**: rejected, indicating that the task needs to be labeled and reviewed again | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a labeling team member's task is updated. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | workforce_task_name | String | Team labeling task name associated with a member's task. | + +-----------------------+--------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkerTasksresponseSampleStats: + +.. table:: **Table 5** SampleStats + + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============================+=========+=====================================================================================================+ + | accepted_sample_count | Integer | Number of samples accepted by the owner. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | auto_annotation_sample_count | Integer | Number of samples to be confirmed after intelligent labeling. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | deleted_sample_count | Integer | Number of deleted samples. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | rejected_sample_count | Integer | Number of samples that failed to pass the owner acceptance. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | sampled_sample_count | Integer | Number of samples that are to be accepted by the owner and sampled. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of samples. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | unannotated_sample_count | Integer | Number of unlabeled samples. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | uncheck_sample_count | Integer | Number of samples that have been approved by the reviewer and are to be accepted by the owner. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | unreviewed_sample_count | Integer | Number of samples that have been labeled by the labeler but have not been reviewed by the reviewer. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the Team Labeling Task List by a Team Member + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/workforces/worker-tasks?offset=0&limit=10&sort_by=create_time&order=desc&filePreview=false + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "count" : 2, + "worker_tasks" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", + "role" : 0, + "task_id" : "tY330MHxV9dqIPVaTRM", + "workforce_task_name" : "task-cd60", + "dataset_id" : "WxCREuCkBSAlQr9xrde", + "sample_stats" : { + "total_sample_count" : 309, + "unannotated_sample_count" : 308, + "unreviewed_sample_count" : 0, + "uncheck_sample_count" : 1, + "sampled_sample_count" : 0, + "rejected_sample_count" : 0, + "accepted_sample_count" : 0, + "auto_annotation_sample_count" : 0 + }, + "create_time" : 1606224714358, + "update_time" : 1606224878490, + "email_status" : 3, + "last_notify_time" : 0, + "dataset_type" : 1, + "task_status" : 1, + "user" : { + "domainId" : "04f924738800d3270fc0c013a47363a0", + "domainName" : "test_123", + "projectId" : "04f924739300d3272fc3c013e36bb4b8", + "userId" : "04f924743b00d4331f31c0131ada6769", + "userName" : "test_123" + } + }, { + "email" : "xxx@xxx.com", + "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", + "role" : 0, + "task_id" : "MJVjCQDMso95a8dvUm4", + "workforce_task_name" : "task-2720", + "dataset_id" : "OY82gjEHxt9w1efgrhS", + "sample_stats" : { + "total_sample_count" : 50005, + "unannotated_sample_count" : 50005, + "unreviewed_sample_count" : 0, + "uncheck_sample_count" : 0, + "sampled_sample_count" : 0, + "rejected_sample_count" : 0, + "accepted_sample_count" : 0, + "auto_annotation_sample_count" : 0 + }, + "create_time" : 1605949737134, + "update_time" : 1605949737134, + "email_status" : 3, + "last_notify_time" : 0, + "dataset_type" : 0, + "task_status" : 2, + "user" : { + "domainId" : "04f924738800d3270fc0c013a47363a0", + "domainName" : "test_123", + "projectId" : "04f924739300d3272fc3c013e36bb4b8", + "userId" : "04f924743b00d4331f31c0131ada6769", + "userName" : "test_123" + } + } ] + } + +Status Codes +------------ + + + +.. _ListWorkerTasksstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_task_management/querying_the_team_labeling_task_list_of_a_dataset.rst b/api-ref/source/data_management/labeling_task_management/querying_the_team_labeling_task_list_of_a_dataset.rst new file mode 100644 index 0000000..7797ba3 --- /dev/null +++ b/api-ref/source/data_management/labeling_task_management/querying_the_team_labeling_task_list_of_a_dataset.rst @@ -0,0 +1,689 @@ +Querying the Team Labeling Task List of a Dataset +================================================= + +Function +-------- + +This API is used to query the team labeling task list of a dataset. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListWorkforceTasksresponseListWorkforceTasksResp: + +.. table:: **Table 2** Response body parameters + + +-----------+-------------------------------------------------------------------------------+------------------------------------------+ + | Parameter | Type | Description | + +===========+===============================================================================+==========================================+ + | count | Integer | Total number of team labeling tasks. | + +-----------+-------------------------------------------------------------------------------+------------------------------------------+ + | tasks | Array of `WorkforceTask <#listworkforcetasksresponseworkforcetask>`__ objects | Team labeling task list queried by page. | + +-----------+-------------------------------------------------------------------------------+------------------------------------------+ + + + +.. _ListWorkforceTasksresponseWorkforceTask: + +.. table:: **Table 3** WorkforceTask + + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================================+=============================================================================================+===================================================================================================================================================================================================================================================================================================================================================+ + | auto_sync_dataset | Boolean | Whether to automatically synchronize the result of a team labeling task to the dataset. The options are as follows: | + | | | | + | | | - **true**: Automatically synchronize the result of a team labeling task to the dataset. | + | | | | + | | | - **false**: Do not automatically synchronize the result of a team labeling task to the dataset. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | check_rate | Double | Acceptance ratio of a team labeling task. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | checking_task_desc | `WorkforceSamplingTaskDesc <#listworkforcetasksresponseworkforcesamplingtaskdesc>`__ object | Details about the current acceptance task of a team labeling task. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a labeling task is created. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | String | Dataset ID. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description of a labeling task. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_stats | Array of `LabelStats <#listworkforcetasksresponselabelstats>`__ objects | Label statistics of a labeling task. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pass_rate | Double | Acceptance pass rate of a team labeling task. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | repetition | Integer | Number of persons who label each sample in a team labeling task. The minimum value is **1**. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_search_conditions | Array of `SearchCondition <#listworkforcetasksresponsesearchcondition>`__ objects | Sample search criteria when creating a task. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_stats | `SampleStats <#listworkforcetasksresponsesamplestats>`__ object | Sample statistics of a labeling task. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | score | Double | Average acceptance score of a team labeling task. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Status of a team labeling task. The options are as follows: | + | | | | + | | | - **6**: created. The owner has created a task but does not start it. Only the owner and manager can view the task list. | + | | | | + | | | - **0**: starting. The owner or manager starts the task and assigns the files to be labeled. The owner, manager, labeler, and reviewer can view the task list. If the task assignment is not complete, a new task cannot be started. | + | | | | + | | | - **1**: running. The task is labeled and reviewed by the labeler and reviewer, respectively and is accepted by the owner. If auto labeling files are added or synchronized, or unlabeled files are imported, the new files need to be assigned again. | + | | | | + | | | - **2**: under acceptance. The owner initiates an acceptance task but does not complete it. In this state, a new acceptance task cannot be initiated until the current one is completed. | + | | | | + | | | - **3**: passed. The team labeling task has been completed. | + | | | | + | | | - **4**: rejected. In this state, the manager starts the task again and assigns it for labeling and reviewing. | + | | | | + | | | - **5**: synchronizing acceptance result. This state is displayed when acceptance tasks are changed to be asynchronous. In this state, new acceptance tasks cannot be initiated and the current acceptance task cannot be continued. In the task name area, a message is displayed, indicating that the acceptance result is being synchronized. | + | | | | + | | | - **7**: acceptance sampling. This state is displayed when acceptance tasks are changed to be asynchronous. In this state, new acceptance tasks cannot be initiated and the current acceptance task cannot be continued. In the task name area, a message is displayed, indicating that the acceptance sampling is in progress. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | synchronize_auto_labeling_data | Boolean | Whether to synchronize the auto labeling result of a team labeling task. The options are as follows: | + | | | | + | | | - **true**: Synchronize the results to be confirmed to team members after auto labeling is complete. | + | | | | + | | | - **false**: Do not synchronize the auto labeling results. (Default value) | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | synchronize_data | Boolean | Whether to synchronize the added data of a team labeling task. The options are as follows: | + | | | | + | | | - **true**: Synchronize uploaded files, data sources, and imported unlabeled files to team members. | + | | | | + | | | - **false**: Do not synchronize the added data. (Default value) | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | String | ID of a labeling task. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_name | String | Name of a labeling task. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a labeling task is updated. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Version ID of the dataset associated with a labeling task. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_stats | `WorkforceStats <#listworkforcetasksresponseworkforcestats>`__ object | Statistics on team labeling task members. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforces_config | `WorkforcesConfig <#listworkforcetasksresponseworkforcesconfig>`__ object | Team labeling task information: Tasks can be assigned by the team administrator or a specified team. | + +--------------------------------+---------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTasksresponseWorkforceSamplingTaskDesc: + +.. table:: **Table 4** WorkforceSamplingTaskDesc + + +-----------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================================================================+==================================================================================================================================================+ + | action | Integer | Action after the acceptance. The options are as follows: | + | | | | + | | | - **0**: Pass all samples when the acceptance is completed (including single-rejected samples) | + | | | | + | | | - **1**: Reject all samples when the acceptance is completed (including single-accepted samples) | + | | | | + | | | - **4**: Pass only single-accepted samples and unaccepted samples. | + | | | | + | | | - **5**: Reject only single-rejected samples and unaccepted samples. | + +-----------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + | checking_stats | `CheckTaskStats <#listworkforcetasksresponsechecktaskstats>`__ object | Real-time report of acceptance tasks. | + +-----------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + | checking_task_id | String | ID of the current acceptance task. | + +-----------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + | overwrite_last_result | Boolean | Whether to use the acceptance result to overwrite the labeled result if a sample has been labeled during acceptance. The options are as follows: | + | | | | + | | | - **true**: Overwrite the labeled result. | + | | | | + | | | - **false**: Do not overwrite the labeled result. (Default value) | + +-----------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_stats | `CheckTaskStats <#listworkforcetasksresponsechecktaskstats>`__ object | Overall report of historical acceptance tasks. | + +-----------------------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTasksresponseCheckTaskStats: + +.. table:: **Table 5** CheckTaskStats + + ====================== ======= ==================================== + Parameter Type Description + ====================== ======= ==================================== + accepted_sample_count Integer Accepted samples. + checked_sample_count Integer Checked samples. + pass_rate Double Pass rate of samples. + rejected_sample_count Integer Rejected samples. + sampled_sample_count Integer Number of sampled samples. + sampling_num Integer Samples of an acceptance task. + sampling_rate Double Sampling rate of an acceptance task. + score String Acceptance score. + task_id String ID of an acceptance task. + total_sample_count Integer Total samples. + total_score Long Total acceptance score. + unchecked_sample_count Integer Unchecked samples. + ====================== ======= ==================================== + + + +.. _ListWorkforceTasksresponseLabelStats: + +.. table:: **Table 6** LabelStats + + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=================================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#listworkforcetasksresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | count | Integer | Number of labels. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#listworkforcetasksresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | sample_count | Integer | Number of samples containing the label. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTasksresponseLabelAttribute: + +.. table:: **Table 7** LabelAttribute + + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================================================================================+===================================================+ + | default_value | String | Default value of a label attribute. | + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------+ + | id | String | Label attribute ID. | + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------+ + | name | String | Label attribute name. | + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------+ + | type | String | Label attribute type. The options are as follows: | + | | | | + | | | - **text**: text | + | | | | + | | | - **select**: single-choice drop-down list | + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------+ + | values | Array of `LabelAttributeValue <#listworkforcetasksresponselabelattributevalue>`__ objects | List of label attribute values. | + +-----------------------+-------------------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _ListWorkforceTasksresponseLabelAttributeValue: + +.. table:: **Table 8** LabelAttributeValue + + ========= ====== ========================= + Parameter Type Description + ========= ====== ========================= + id String Label attribute value ID. + value String Label attribute value. + ========= ====== ========================= + + + +.. _ListWorkforceTasksresponseLabelProperty: + +.. table:: **Table 9** LabelProperty + + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+=======================+================================================================================================================================================================================================================+ + | @modelarts:color | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | String | Default attribute: The new name of the label. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTasksresponseSearchCondition: + +.. table:: **Table 10** SearchCondition + + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===================================================================+==================================================================================================================================================================================================================================================================+ + | coefficient | String | Filter by coefficient of difficulty. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | frame_in_video | Integer | A frame in the video. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | hard | String | Whether a sample is a hard sample. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | import_origin | String | Filter by data source. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | kvp | String | CT dosage, filtered by dosage. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_list | `SearchLabels <#listworkforcetasksresponsesearchlabels>`__ object | Label search criteria. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labeler | String | Labeler. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SearchProp <#listworkforcetasksresponsesearchprop>`__ object | Search by sample attribute. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parent_sample_id | String | Parent sample ID. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Directory where data samples are stored (the directory must end with a slash (/)). Only samples in the specified directory are searched for. Recursive search of directories is not supported. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Search by sample name, including the file name extension. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | String | When a sample is added to the dataset, an index is created based on the last modification time (accurate to day) of the sample on OBS. You can search for the sample based on the time. The options are as follows: | + | | | | + | | | - **month**: Search for samples added from 30 days ago to the current day. | + | | | | + | | | - **day**: Search for samples added from yesterday (one day ago) to the current day. | + | | | | + | | | - **yyyyMMdd-yyyyMMdd**: Search for samples added in a specified period (at most 30 days), in the format of **Start date-End date**. For example, **20190901-2019091501** indicates that samples generated from September 1 to September 15, 2019 are searched. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Search by confidence. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | slice_thickness | String | DICOM layer thickness. Samples are filtered by layer thickness. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | study_date | String | DICOM scanning time. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | time_in_video | String | A time point in the video. | + +-----------------------+-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTasksresponseSearchLabels: + +.. table:: **Table 11** SearchLabels + + +-----------------------+---------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================================================================+==============================================================================================================================================================+ + | labels | Array of `SearchLabel <#listworkforcetasksresponsesearchlabel>`__ objects | List of label search criteria. | + +-----------------------+---------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | If you want to search for multiple labels, **op** must be specified. If you search for only one label, **op** can be left blank. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+---------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTasksresponseSearchLabel: + +.. table:: **Table 12** SearchLabel + + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+========================================================================================================================================================================================================================================================================================+ + | name | String | Label name. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | op | String | Operation type between multiple attributes. The options are as follows: | + | | | | + | | | - **OR**: OR operation | + | | | | + | | | - **AND**: AND operation | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | property | Map> | Label attribute, which is in the Object format and stores any key-value pairs. **key** indicates the attribute name, and **value** indicates the value list. If **value** is **null**, the search is not performed by value. Otherwise, the search value can be any value in the list. | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTasksresponseSearchProp: + +.. table:: **Table 13** SearchProp + + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+=======================================================================+ + | op | String | Relationship between attribute values. The options are as follows: | + | | | | + | | | - **AND**: AND relationship | + | | | | + | | | - **OR**: OR relationship | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + | props | Map> | Search criteria of an attribute. Multiple search criteria can be set. | + +-----------------------+---------------------------+-----------------------------------------------------------------------+ + + + +.. _ListWorkforceTasksresponseSampleStats: + +.. table:: **Table 14** SampleStats + + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============================+=========+=====================================================================================================+ + | accepted_sample_count | Integer | Number of samples accepted by the owner. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | auto_annotation_sample_count | Integer | Number of samples to be confirmed after intelligent labeling. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | deleted_sample_count | Integer | Number of deleted samples. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | rejected_sample_count | Integer | Number of samples that failed to pass the owner acceptance. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | sampled_sample_count | Integer | Number of samples that are to be accepted by the owner and sampled. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | total_sample_count | Integer | Total number of samples. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | unannotated_sample_count | Integer | Number of unlabeled samples. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | uncheck_sample_count | Integer | Number of samples that have been approved by the reviewer and are to be accepted by the owner. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + | unreviewed_sample_count | Integer | Number of samples that have been labeled by the labeler but have not been reviewed by the reviewer. | + +------------------------------+---------+-----------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTasksresponseWorkforceStats: + +.. table:: **Table 15** WorkforceStats + + =============== ======= =========================== + Parameter Type Description + =============== ======= =========================== + labeler_count Integer Number of labeling persons. + reviewer_count Integer Number of reviewers. + workforce_count Integer Number of teams. + =============== ======= =========================== + + + +.. _ListWorkforceTasksresponseWorkforcesConfig: + +.. table:: **Table 16** WorkforcesConfig + + +------------+-----------------------------------------------------------------------------------+--------------------------------------------+ + | Parameter | Type | Description | + +============+===================================================================================+============================================+ + | agency | String | Administrator. | + +------------+-----------------------------------------------------------------------------------+--------------------------------------------+ + | workforces | Array of `WorkforceConfig <#listworkforcetasksresponseworkforceconfig>`__ objects | List of teams that execute labeling tasks. | + +------------+-----------------------------------------------------------------------------------+--------------------------------------------+ + + + +.. _ListWorkforceTasksresponseWorkforceConfig: + +.. table:: **Table 17** WorkforceConfig + + +----------------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+=================================================================+=================================================================================================================================+ + | workers | Array of `Worker <#listworkforcetasksresponseworker>`__ objects | List of labeling team members. | + +----------------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +----------------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | String | Name of a labeling team. The value contains 0 to 1024 characters and does not support the following special characters: !<>=&"' | + +----------------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTasksresponseWorker: + +.. table:: **Table 18** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the Team Labeling Task List of a Dataset + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "count" : 2, + "tasks" : [ { + "dataset_id" : "WxCREuCkBSAlQr9xrde", + "task_id" : "tY330MHxV9dqIPVaTRM", + "task_name" : "task-cd60", + "status" : 1, + "create_time" : 1606224714358, + "update_time" : 1606224714358, + "repetition" : 1, + "workforces_config" : { + "workforces" : [ { + "workforce_id" : "0PfqwXA8M59pppYBx4k", + "workforce_name" : "team-123", + "workers" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "6db04ae0afb54d7274a2982255516c29", + "role" : 2 + }, { + "email" : "xxx@xxx.com", + "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", + "role" : 0 + } ] + } ] + }, + "synchronize_data" : true, + "synchronize_auto_labeling_data" : true, + "workforce_stats" : { + "workforce_count" : 1, + "labeler_count" : 1, + "reviewer_count" : 0 + }, + "sample_stats" : { + "total_sample_count" : 309, + "unannotated_sample_count" : 308, + "unreviewed_sample_count" : 0, + "uncheck_sample_count" : 1, + "sampled_sample_count" : 0, + "rejected_sample_count" : 0, + "accepted_sample_count" : 0, + "auto_annotation_sample_count" : 0 + }, + "auto_check_samples" : true, + "auto_sync_dataset" : true, + "project_id" : "04f924739300d3272fc3c013e36bb4b8", + "task_type" : 1, + "dataset_name" : "dataset-95a6", + "total_sample_count" : 309, + "annotated_sample_count" : 0, + "feature_supports" : [ "0" ], + "label_task_status" : 1, + "sync_labels" : true, + "workforce_task" : true + }, { + "dataset_id" : "WxCREuCkBSAlQr9xrde", + "task_id" : "iYZx7gScPUozOXner9k", + "task_name" : "task-e63f", + "status" : 1, + "create_time" : 1606184400278, + "update_time" : 1606184400278, + "repetition" : 1, + "workforces_config" : { + "workforces" : [ { + "workforce_id" : "q3ZFSwORu1ztKljDLYQ", + "workforce_name" : "modelarts-team", + "workers" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "afdda13895bc66322ffbf36ae833bcf0", + "role" : 0 + } ] + } ] + }, + "synchronize_data" : false, + "synchronize_auto_labeling_data" : false, + "workforce_stats" : { + "workforce_count" : 1, + "labeler_count" : 1, + "reviewer_count" : 0 + }, + "sample_stats" : { + "total_sample_count" : 317, + "unannotated_sample_count" : 310, + "unreviewed_sample_count" : 0, + "uncheck_sample_count" : 0, + "sampled_sample_count" : 0, + "rejected_sample_count" : 0, + "accepted_sample_count" : 7, + "auto_annotation_sample_count" : 0 + }, + "checking_task_desc" : { + "checking_task_id" : "onSbri2oqYOmDjDyW17", + "action" : 0, + "overwrite_last_result" : false + }, + "auto_check_samples" : true, + "auto_sync_dataset" : true, + "project_id" : "04f924739300d3272fc3c013e36bb4b8", + "task_type" : 1, + "dataset_name" : "dataset-95a6", + "total_sample_count" : 317, + "annotated_sample_count" : 0, + "feature_supports" : [ "0" ], + "label_task_status" : 1, + "sync_labels" : true, + "workforce_task" : true + } ] + } + +Status Codes +------------ + + + +.. _ListWorkforceTasksstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_task_management/starting_a_team_labeling_task.rst b/api-ref/source/data_management/labeling_task_management/starting_a_team_labeling_task.rst new file mode 100644 index 0000000..ef57cf6 --- /dev/null +++ b/api-ref/source/data_management/labeling_task_management/starting_a_team_labeling_task.rst @@ -0,0 +1,174 @@ +Starting a Team Labeling Task +============================= + +Function +-------- + +This API is used to start a team labeling task. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id} + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a team labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _StartWorkforceTaskrequestStartWorkforceTaskReq: + +.. table:: **Table 2** Request body parameters + + +-------------------+-----------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+==========================================================================+======================================================================================================+ + | dataset_id | No | String | Dataset ID. | + +-------------------+-----------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------+ + | task_id | No | String | ID of a team labeling task. | + +-------------------+-----------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------+ + | workforces_config | No | `WorkforcesConfig <#startworkforcetaskrequestworkforcesconfig>`__ object | Team labeling task information: Tasks can be assigned by the team administrator or a specified team. | + +-------------------+-----------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------+ + + + +.. _StartWorkforceTaskrequestWorkforcesConfig: + +.. table:: **Table 3** WorkforcesConfig + + +------------+-----------+----------------------------------------------------------------------------------+--------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+==================================================================================+============================================+ + | agency | No | String | Administrator. | + +------------+-----------+----------------------------------------------------------------------------------+--------------------------------------------+ + | workforces | No | Array of `WorkforceConfig <#startworkforcetaskrequestworkforceconfig>`__ objects | List of teams that execute labeling tasks. | + +------------+-----------+----------------------------------------------------------------------------------+--------------------------------------------+ + + + +.. _StartWorkforceTaskrequestWorkforceConfig: + +.. table:: **Table 4** WorkforceConfig + + +----------------+-----------+----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +================+===========+================================================================+=================================================================================================================================+ + | workers | No | Array of `Worker <#startworkforcetaskrequestworker>`__ objects | List of labeling team members. | + +----------------+-----------+----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | No | String | ID of a labeling team. | + +----------------+-----------+----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | No | String | Name of a labeling team. The value contains 0 to 1024 characters and does not support the following special characters: !<>=&"' | + +----------------+-----------+----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _StartWorkforceTaskrequestWorker: + +.. table:: **Table 5** Worker + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==========================================================================================================================================+ + | create_time | No | Long | Creation time. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | No | String | Email address of a labeling team member. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | No | Integer | Role. The options are as follows: | + | | | | | + | | | | - **0**: labeling personnel | + | | | | | + | | | | - **1**: reviewer | + | | | | | + | | | | - **2**: team administrator | + | | | | | + | | | | - **3**: dataset owner | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | No | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | | + | | | | - **0**: The invitation email has not been sent. | + | | | | | + | | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | | + | | | | - **2**: The user has logged in. | + | | | | | + | | | | - **3**: The labeling team member has been deleted. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | No | Long | Update time. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | No | String | ID of a labeling team member. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | No | String | ID of a labeling team. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Starting a Team Labeling Task + +.. code-block:: + + { + "workforces_config" : { + "workforces" : [ { + "workforce_id" : "l4u9Hpz2JJ67DNN1Hg9", + "workers" : [ { + "email" : "xiaozhang@163.com" + }, { + "email" : "xiaoli@163.com" + } ] + } ] + } + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _StartWorkforceTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_task_management/updating_a_team_labeling_task.rst b/api-ref/source/data_management/labeling_task_management/updating_a_team_labeling_task.rst new file mode 100644 index 0000000..ab70772 --- /dev/null +++ b/api-ref/source/data_management/labeling_task_management/updating_a_team_labeling_task.rst @@ -0,0 +1,178 @@ +Updating a Team Labeling Task +============================= + +Function +-------- + +This API is used to update a team labeling task. + +URI +--- + +PUT /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id} + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a team labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateWorkforceTaskrequestUpdateWorkforceTaskReq: + +.. table:: **Table 2** Request body parameters + + +-------------------+-----------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+===========================================================================+========================================================================================================================================+ + | dataset_id | No | String | Dataset ID. | + +-------------------+-----------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Team labeling task description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-------------------+-----------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | No | String | ID of a team labeling task. | + +-------------------+-----------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | task_name | No | String | Team labeling task name. The value contains 1 to 64 characters and only letters, digits, underscores (_), and hyphens (-) are allowed. | + +-------------------+-----------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | workforces_config | No | `WorkforcesConfig <#updateworkforcetaskrequestworkforcesconfig>`__ object | Team labeling task information: Tasks can be assigned by the team administrator or a specified team. | + +-------------------+-----------+---------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateWorkforceTaskrequestWorkforcesConfig: + +.. table:: **Table 3** WorkforcesConfig + + +------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+===================================================================================+============================================+ + | agency | No | String | Administrator. | + +------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------+ + | workforces | No | Array of `WorkforceConfig <#updateworkforcetaskrequestworkforceconfig>`__ objects | List of teams that execute labeling tasks. | + +------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------+ + + + +.. _UpdateWorkforceTaskrequestWorkforceConfig: + +.. table:: **Table 4** WorkforceConfig + + +----------------+-----------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +================+===========+=================================================================+=================================================================================================================================+ + | workers | No | Array of `Worker <#updateworkforcetaskrequestworker>`__ objects | List of labeling team members. | + +----------------+-----------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | No | String | ID of a labeling team. | + +----------------+-----------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | No | String | Name of a labeling team. The value contains 0 to 1024 characters and does not support the following special characters: !<>=&"' | + +----------------+-----------+-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateWorkforceTaskrequestWorker: + +.. table:: **Table 5** Worker + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==========================================================================================================================================+ + | create_time | No | Long | Creation time. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | No | String | Email address of a labeling team member. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | No | Integer | Role. The options are as follows: | + | | | | | + | | | | - **0**: labeling personnel | + | | | | | + | | | | - **1**: reviewer | + | | | | | + | | | | - **2**: team administrator | + | | | | | + | | | | - **3**: dataset owner | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | No | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | | + | | | | - **0**: The invitation email has not been sent. | + | | | | | + | | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | | + | | | | - **2**: The user has logged in. | + | | | | | + | | | | - **3**: The labeling team member has been deleted. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | No | Long | Update time. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | No | String | ID of a labeling team member. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | No | String | ID of a labeling team. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Updating a Team Labeling Task + +.. code-block:: + + { + "workforces_config" : { + "workforces" : [ { + "workforce_id" : "3frbQ90hb8ZKksAhyR8", + "workers" : [ { + "email" : "xxx@xxx.com" + }, { + "email" : "xxx@xxx.com" + } ] + } ] + } + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _UpdateWorkforceTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_task_management/updating_the_status_of_a_team_labeling_acceptance_task.rst b/api-ref/source/data_management/labeling_task_management/updating_the_status_of_a_team_labeling_acceptance_task.rst new file mode 100644 index 0000000..43c466f --- /dev/null +++ b/api-ref/source/data_management/labeling_task_management/updating_the_status_of_a_team_labeling_acceptance_task.rst @@ -0,0 +1,562 @@ +Updating the Status of a Team Labeling Acceptance Task +====================================================== + +Function +-------- + +This API is used to update the sample status by confirming the acceptance scope and whether the labeled data is overwritten before the acceptance of the team labeling task is completed. + +URI +--- + +PUT /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/acceptance/status + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a team labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+---------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=======================================+ + | locale | Yes | String | Language. The options are as follows: | + | | | | | + | | | | - **en-us**: English (default value) | + | | | | | + | | | | - **zh-cn**: Chinese | + +-----------------+-----------------+-----------------+---------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateWorkforceSamplingTaskrequestUpdateWorkforceSamplingTaskReq: + +.. table:: **Table 3** Request body parameters + + +-----------------------+-----------------+-----------------+----------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=======================+=================+=================+================================================================+ + | action | No | Integer | Acceptance action. The options are as follows: | + | | | | | + | | | | - **0**: Pass all samples. | + | | | | | + | | | | - **1**: Reject all samples. | + | | | | | + | | | | - **2**: Cancel acceptance. | + | | | | | + | | | | - **3**: View the list of conflicted samples. | + | | | | | + | | | | - **4**: Pass single-accepted samples and unaccepted samples. | + | | | | | + | | | | - **5**: Pass only single-accepted samples. | + +-----------------------+-----------------+-----------------+----------------------------------------------------------------+ + | locale | No | String | Language. The options are as follows: | + | | | | | + | | | | - **en-us**: English (default value) | + | | | | | + | | | | - **zh-cn**: Chinese | + +-----------------------+-----------------+-----------------+----------------------------------------------------------------+ + | overwrite_last_result | No | Boolean | Whether to overwrite labeled data. The options are as follows: | + | | | | | + | | | | - **true**: Overwrite labeled data. | + | | | | | + | | | | - **false**: Do not overwrite labeled data. (Default value) | + +-----------------------+-----------------+-----------------+----------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _UpdateWorkforceSamplingTaskresponseUpdateWorkforceSamplingTaskResp: + +.. table:: **Table 4** Response body parameters + + +--------------+--------------------------------------------------------------------------------------------------+-----------------------------------+ + | Parameter | Type | Description | + +==============+==================================================================================================+===================================+ + | sample_count | Integer | Total number of accepted samples. | + +--------------+--------------------------------------------------------------------------------------------------+-----------------------------------+ + | samples | Array of `DescribeSampleResp <#updateworkforcesamplingtaskresponsedescribesampleresp>`__ objects | List of accepted samples. | + +--------------+--------------------------------------------------------------------------------------------------+-----------------------------------+ + + + +.. _UpdateWorkforceSamplingTaskresponseDescribeSampleResp: + +.. table:: **Table 5** DescribeSampleResp + + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+====================================================================================+========================================================================================================================================+ + | check_accept | Boolean | Whether the acceptance is passed, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: The acceptance is passed. | + | | | | + | | | - **false**: The acceptance is not passed. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_comment | String | Acceptance comment, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_score | String | Acceptance score, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_reasons | Array of strings | Reason for deleting a sample, which is used for healthcare. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | hard_details | Map | Details about difficulties, including description, causes, and suggestions of difficult problems. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labelers | Array of `Worker <#updateworkforcesamplingtaskresponseworker>`__ objects | Labeling personnel list of sample assignment. The labelers record the team members to which the sample is allocated for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labels | Array of `SampleLabel <#updateworkforcesamplingtaskresponsesamplelabel>`__ objects | Sample label list. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SampleMetadata <#updateworkforcesamplingtaskresponsesamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_accept | Boolean | Whether to accept the review, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: accepted | + | | | | + | | | - **false**: rejected | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_comment | String | Review comment, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_score | String | Review score, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_data | Array of strings | Sample data list. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Sample path. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_id | String | Sample ID. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Sample name. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_size | Long | Sample size or text length, in bytes. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_status | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | Long | Sample time, when OBS is last modified. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_type | Integer | Sample type. The options are as follows: | + | | | | + | | | - **0**: image | + | | | | + | | | - **1**: text | + | | | | + | | | - **2**: speech | + | | | | + | | | - **4**: table | + | | | | + | | | - **6**: video | + | | | | + | | | - **9**: custom format | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Comprehensive score, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | source | String | Source address of sample data. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sub_sample_url | String | Subsample URL, which is used for healthcare. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateWorkforceSamplingTaskresponseHardDetail: + +.. table:: **Table 6** HardDetail + + ========== ======= ==================== + Parameter Type Description + ========== ======= ==================== + alo_name String Alias. + id Integer Reason ID. + reason String Reason description. + suggestion String Handling suggestion. + ========== ======= ==================== + + + +.. _UpdateWorkforceSamplingTaskresponseWorker: + +.. table:: **Table 7** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateWorkforceSamplingTaskresponseSampleLabel: + +.. table:: **Table 8** SampleLabel + + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==========================================================================================+=======================================================================================================================================+ + | annotated_by | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | + | | | - **human**: manual labeling | + | | | | + | | | - **auto**: automatic labeling | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | Label ID. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | `SampleLabelProperty <#updateworkforcesamplingtaskresponsesamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | Float | Confidence. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateWorkforceSamplingTaskresponseSampleLabelProperty: + +.. table:: **Table 9** SampleLabelProperty + + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | + | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | + | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | + | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | + | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | + | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | + | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | + | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | + | | | - **0/false**: not a hard example | + | | | | + | | | - **1/true**: hard example | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateWorkforceSamplingTaskresponseSampleMetadata: + +.. table:: **Table 10** SampleMetadata + + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +All Tasks Are Accepted. + +.. code-block:: + + { + "action" : 0 + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _UpdateWorkforceSamplingTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_management/creating_a_labeling_team.rst b/api-ref/source/data_management/labeling_team_management/creating_a_labeling_team.rst new file mode 100644 index 0000000..92e8e5f --- /dev/null +++ b/api-ref/source/data_management/labeling_team_management/creating_a_labeling_team.rst @@ -0,0 +1,102 @@ +Creating a Labeling Team +======================== + +Function +-------- + +This API is used to create a labeling team. + +URI +--- + +POST /v2/{project_id}/workforces + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateWorkforcerequestCreateWorkforceReq: + +.. table:: **Table 2** Request body parameters + + +----------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +================+===========+========+===================================================================================================================================+ + | description | No | String | Labeling team description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +----------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | Yes | String | Labeling team name. The value contains 1 to 64 characters, including only letters, digits, underscores (_), and hyphens (-). | + +----------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 201** + + + +.. _CreateWorkforceresponseCreateWorkforceResp: + +.. table:: **Table 3** Response body parameters + + ============ ====== ====================== + Parameter Type Description + ============ ====== ====================== + workforce_id String ID of a labeling team. + ============ ====== ====================== + +Example Requests +---------------- + +Creating a Labeling Team + +.. code-block:: + + { + "workforce_name" : "team-123", + "description" : "my team" + } + +Example Responses +----------------- + +**Status code: 201** + +Created + +.. code-block:: + + { + "workforce_id" : "ZUH8gqkjuaib8pxkDdz" + } + +Status Codes +------------ + + + +.. _CreateWorkforcestatuscode: + +=========== ============ +Status Code Description +=========== ============ +201 Created +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_management/deleting_a_labeling_team.rst b/api-ref/source/data_management/labeling_team_management/deleting_a_labeling_team.rst new file mode 100644 index 0000000..f15fbff --- /dev/null +++ b/api-ref/source/data_management/labeling_team_management/deleting_a_labeling_team.rst @@ -0,0 +1,116 @@ +Deleting a Labeling Team +======================== + +Function +-------- + +This API is used to delete a labeling team. + +URI +--- + +DELETE /v2/{project_id}/workforces/{workforce_id} + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | Yes | String | ID of a labeling team. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 204** + + + +.. _DeleteWorkforceresponseDeleteWorkforceResp: + +.. table:: **Table 2** Response body parameters + + +-----------------------+----------------------------------------------------------------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+============================================================================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+----------------------------------------------------------------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+----------------------------------------------------------------------------+------------------------------------------------------------------------+ + | results | Array of `BatchResponse <#deleteworkforceresponsebatchresponse>`__ objects | Result of deleting team members in batches. | + +-----------------------+----------------------------------------------------------------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+----------------------------------------------------------------------------+------------------------------------------------------------------------+ + + + +.. _DeleteWorkforceresponseBatchResponse: + +.. table:: **Table 3** BatchResponse + + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + +Example Requests +---------------- + +Deleting a Labeling Team + +.. code-block:: + + DELETE https://{endpoint}/v2/{project_id}/workforces/{workforce_id} + +Example Responses +----------------- + +**Status code: 204** + +No Content + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _DeleteWorkforcestatuscode: + +=========== ============ +Status Code Description +=========== ============ +204 No Content +401 Unauthorized +403 Forbidden +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_management/index.rst b/api-ref/source/data_management/labeling_team_management/index.rst new file mode 100644 index 0000000..6d1fa10 --- /dev/null +++ b/api-ref/source/data_management/labeling_team_management/index.rst @@ -0,0 +1,12 @@ +======================== +Labeling Team Management +======================== + +.. toctree:: + :maxdepth: 1 + + querying_the_labeling_team_list + creating_a_labeling_team + querying_details_about_a_labeling_team + updating_a_labeling_team + deleting_a_labeling_team diff --git a/api-ref/source/data_management/labeling_team_management/querying_details_about_a_labeling_team.rst b/api-ref/source/data_management/labeling_team_management/querying_details_about_a_labeling_team.rst new file mode 100644 index 0000000..4385a5e --- /dev/null +++ b/api-ref/source/data_management/labeling_team_management/querying_details_about_a_labeling_team.rst @@ -0,0 +1,106 @@ +Querying Details About a Labeling Team +====================================== + +Function +-------- + +This API is used to query the details about a labeling team. + +URI +--- + +GET /v2/{project_id}/workforces/{workforce_id} + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | Yes | String | ID of a labeling team. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DescWorkforceresponseDescWorkforceResp: + +.. table:: **Table 2** Response body parameters + + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+=========+=================================================================================================================================+ + | create_time | Long | Time when a labeling team is created. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description of a labeling team. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a labeling team is updated. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | worker_count | Integer | Total number of labeling team members. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | String | Name of a labeling team. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About a Labeling Team + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/workforces/{workforce_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "workforce_id" : "gyb7IaAvkLc5IhEY2dv", + "workforce_name" : "team-aed7", + "description" : "", + "worker_count" : 2, + "create_time" : 1575104620882, + "update_time" : 1575104620882 + } + +Status Codes +------------ + + + +.. _DescWorkforcestatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_management/querying_the_labeling_team_list.rst b/api-ref/source/data_management/labeling_team_management/querying_the_labeling_team_list.rst new file mode 100644 index 0000000..a4f7cdb --- /dev/null +++ b/api-ref/source/data_management/labeling_team_management/querying_the_labeling_team_list.rst @@ -0,0 +1,154 @@ +Querying the Labeling Team List +=============================== + +Function +-------- + +This API is used to query the labeling team list. + +URI +--- + +GET /v2/{project_id}/workforces + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+=================+=================+===============================================================================================================+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting sequence of the query. The options are as follows: | + | | | | | + | | | | - **asc**: ascending order | + | | | | | + | | | | - **desc**: descending order (default value) | + +-------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | search_content | No | String | Fuzzy search keyword. By default, this parameter is left blank. | + +-------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Sorting mode of the query. The options are as follows: | + | | | | | + | | | | - **create_time**: Sort by creation time. (Default value) | + | | | | | + | | | | - **workforce_name**: Sort by labeling team name. | + +-------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | No | String | ID of a team labeling task. | + +-------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListWorkforcesresponseListWorkforcesResp: + +.. table:: **Table 3** Response body parameters + + +--------------+-------------------------------------------------------------------+-------------------------------------+ + | Parameter | Type | Description | + +==============+===================================================================+=====================================+ + | total_number | Integer | Total number of labeling teams. | + +--------------+-------------------------------------------------------------------+-------------------------------------+ + | workforces | Array of `Workforce <#listworkforcesresponseworkforce>`__ objects | Labeling team list queried by page. | + +--------------+-------------------------------------------------------------------+-------------------------------------+ + + + +.. _ListWorkforcesresponseWorkforce: + +.. table:: **Table 4** Workforce + + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+=========+=================================================================================================================================+ + | create_time | Long | Time when a labeling team is created. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description of a labeling team. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Time when a labeling team is updated. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | worker_count | Integer | Total number of labeling team members. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | String | Name of a labeling team. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the Labeling Team List + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/workforces + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "total_number" : 2, + "workforces" : [ { + "workforce_id" : "ZUH8gqkjuaib8pxkDdz", + "workforce_name" : "team-123", + "description" : "my team", + "worker_count" : 0, + "create_time" : 1606354772548, + "update_time" : 1606354772548 + }, { + "workforce_id" : "3Ry04NsqvEybuWYLDvC", + "workforce_name" : "team-170a", + "description" : "", + "worker_count" : 1, + "create_time" : 1604644946891, + "update_time" : 1606238678626 + } ] + } + +Status Codes +------------ + + + +.. _ListWorkforcesstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_management/updating_a_labeling_team.rst b/api-ref/source/data_management/labeling_team_management/updating_a_labeling_team.rst new file mode 100644 index 0000000..8e27acf --- /dev/null +++ b/api-ref/source/data_management/labeling_team_management/updating_a_labeling_team.rst @@ -0,0 +1,89 @@ +Updating a Labeling Team +======================== + +Function +-------- + +This API is used to update a labeling team. + +URI +--- + +PUT /v2/{project_id}/workforces/{workforce_id} + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | Yes | String | ID of a labeling team. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateWorkforcerequestUpdateWorkforceReq: + +.. table:: **Table 2** Request body parameters + + +----------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +================+===========+========+========================================================================================================================================+ + | description | No | String | Labeling team description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +----------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_name | No | String | Name of a labeling team. The value contains 1 to 64 characters and only letters, digits, hyphens (-), and underscores (_) are allowed. | + +----------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Updating a Labeling Team + +.. code-block:: + + { + "description" : "my team" + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _UpdateWorkforcestatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_member_management/creating_a_labeling_team_member.rst b/api-ref/source/data_management/labeling_team_member_management/creating_a_labeling_team_member.rst new file mode 100644 index 0000000..255cd04 --- /dev/null +++ b/api-ref/source/data_management/labeling_team_member_management/creating_a_labeling_team_member.rst @@ -0,0 +1,99 @@ +Creating a Labeling Team Member +=============================== + +Function +-------- + +This API is used to create a labeling team member. + +URI +--- + +POST /v2/{project_id}/workforces/{workforce_id}/workers + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | Yes | String | ID of a labeling team. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateWorkerrequestCreateWorkerReq: + +.. table:: **Table 2** Request body parameters + + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==================================================================================================================================+ + | description | No | String | Member description. The description contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------+ + | emails | Yes | String | Email address of a labeling team member. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------+ + | role | Yes | Integer | Member role. The options are as follows: | + | | | | | + | | | | - **0**: labeling personnel | + | | | | | + | | | | - **1**: reviewer | + | | | | | + | | | | - **2**: team administrator | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Creating a Labeling Team Member + +.. code-block:: + + { + "emails" : "xxx@xxx.com", + "description" : "", + "role" : "2" + } + +Example Responses +----------------- + +**Status code: 201** + +Created + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _CreateWorkerstatuscode: + +=========== ============ +Status Code Description +=========== ============ +201 Created +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_member_management/deleting_a_labeling_team_member.rst b/api-ref/source/data_management/labeling_team_member_management/deleting_a_labeling_team_member.rst new file mode 100644 index 0000000..19124c7 --- /dev/null +++ b/api-ref/source/data_management/labeling_team_member_management/deleting_a_labeling_team_member.rst @@ -0,0 +1,76 @@ +Deleting a Labeling Team Member +=============================== + +Function +-------- + +This API is used to delete a labeling team member. + +URI +--- + +DELETE /v2/{project_id}/workforces/{workforce_id}/workers/{worker_id} + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | Yes | String | ID of a labeling team member. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | Yes | String | ID of a labeling team. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Deleting a Labeling Team Member + +.. code-block:: + + DELETE https://{endpoint}/v2/{project_id}/workforces/{workforce_id}/workers/{worker_id} + +Example Responses +----------------- + +**Status code: 204** + +No Content + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _DeleteWorkerstatuscode: + +=========== ============ +Status Code Description +=========== ============ +204 No Content +401 Unauthorized +403 Forbidden +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_member_management/deleting_labeling_team_members_in_batches.rst b/api-ref/source/data_management/labeling_team_member_management/deleting_labeling_team_members_in_batches.rst new file mode 100644 index 0000000..6bded19 --- /dev/null +++ b/api-ref/source/data_management/labeling_team_member_management/deleting_labeling_team_members_in_batches.rst @@ -0,0 +1,136 @@ +Deleting Labeling Team Members in Batches +========================================= + +Function +-------- + +This API is used to delete labeling team members in batches. + +URI +--- + +POST /v2/{project_id}/workforces/{workforce_id}/workers/batch-delete + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | Yes | String | ID of a labeling team. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _DeleteWorkersrequestDeleteWorkersReq: + +.. table:: **Table 2** Request body parameters + + ========= ========= ================ ==================== + Parameter Mandatory Type Description + ========= ========= ================ ==================== + workers No Array of strings Team member ID list. + ========= ========= ================ ==================== + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DeleteWorkersresponseDeleteWorkersResp: + +.. table:: **Table 3** Response body parameters + + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==========================================================================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------+ + | results | Array of `BatchResponse <#deleteworkersresponsebatchresponse>`__ objects | Result of deleting team members in batches. | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------+ + + + +.. _DeleteWorkersresponseBatchResponse: + +.. table:: **Table 4** BatchResponse + + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + +Example Requests +---------------- + +Deleting Labeling Team Members in Batches + +.. code-block:: + + { + "workers" : [ "89d4ae38431b8905449821605abdc3a9", "a2abd3f27b4e92c593c15282f8b6bd29" ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "success" : true, + "results" : [ { + "success" : true + }, { + "success" : true + } ] + } + +Status Codes +------------ + + + +.. _DeleteWorkersstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_member_management/index.rst b/api-ref/source/data_management/labeling_team_member_management/index.rst new file mode 100644 index 0000000..146259a --- /dev/null +++ b/api-ref/source/data_management/labeling_team_member_management/index.rst @@ -0,0 +1,15 @@ +=============================== +Labeling Team Member Management +=============================== + +.. toctree:: + :maxdepth: 1 + + sending_an_email_to_a_labeling_team_member + querying_the_list_of_all_labeling_team_members + querying_the_list_of_labeling_team_members + creating_a_labeling_team_member + deleting_labeling_team_members_in_batches + querying_details_about_labeling_team_members + updating_a_labeling_team_member + deleting_a_labeling_team_member diff --git a/api-ref/source/data_management/labeling_team_member_management/querying_details_about_labeling_team_members.rst b/api-ref/source/data_management/labeling_team_member_management/querying_details_about_labeling_team_members.rst new file mode 100644 index 0000000..a900ddf --- /dev/null +++ b/api-ref/source/data_management/labeling_team_member_management/querying_details_about_labeling_team_members.rst @@ -0,0 +1,128 @@ +Querying Details About Labeling Team Members +============================================ + +Function +-------- + +This API is used to query details about labeling team members. + +URI +--- + +GET /v2/{project_id}/workforces/{workforce_id}/workers/{worker_id} + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | Yes | String | ID of a labeling team member. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | Yes | String | ID of a labeling team. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DescWorkerresponseDescWorkerResp: + +.. table:: **Table 2** Response body parameters + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About Labeling Team Members + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/workforces/{workforce_id}/workers/{worker_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "email" : "xxx@xxx.com", + "worker_id" : "b1e4054407ecb36a7bcde70f52ba37f2", + "workforce_id" : "gyb7IaAvkLc5IhEY2dv", + "status" : 0, + "role" : 2, + "description" : "", + "create_time" : 1606356324223, + "update_time" : 1606356324223 + } + +Status Codes +------------ + + + +.. _DescWorkerstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_member_management/querying_the_list_of_all_labeling_team_members.rst b/api-ref/source/data_management/labeling_team_member_management/querying_the_list_of_all_labeling_team_members.rst new file mode 100644 index 0000000..36df8db --- /dev/null +++ b/api-ref/source/data_management/labeling_team_member_management/querying_the_list_of_all_labeling_team_members.rst @@ -0,0 +1,180 @@ +Querying the List of All Labeling Team Members +============================================== + +Function +-------- + +This API is used to query the list of all labeling team members. + +URI +--- + +GET /v2/{project_id}/workforces/workers + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+===============================================================================================================+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting sequence of the query. The options are as follows: | + | | | | | + | | | | - **asc**: ascending order | + | | | | | + | | | | - **desc**: descending order (default value) | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | role | No | Integer | Filtering query based on the member role. The options are as follows: | + | | | | | + | | | | - **0**: labeling personnel (default value) | + | | | | | + | | | | - **1**: reviewer | + | | | | | + | | | | - **2**: team administrator | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Sorting mode of the query. The options are as follows: | + | | | | | + | | | | - **create_time**: Sort by creation time. (Default value) | + | | | | | + | | | | - **email**: Sort by email. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListAllWorkersresponseListWorkersResp: + +.. table:: **Table 3** Response body parameters + + +--------------+-------------------------------------------------------------+---------------------------------------------+ + | Parameter | Type | Description | + +==============+=============================================================+=============================================+ + | total_number | Integer | Total number of labeling team members. | + +--------------+-------------------------------------------------------------+---------------------------------------------+ + | workers | Array of `Worker <#listallworkersresponseworker>`__ objects | Labeling team members list queried by page. | + +--------------+-------------------------------------------------------------+---------------------------------------------+ + + + +.. _ListAllWorkersresponseWorker: + +.. table:: **Table 4** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying All Labeling Team Administrators + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/workforces/workers??role=2 + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "total_number" : 2, + "workers" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "df40e4afcb793d13f01f6c9022341e6f", + "workforce_id" : "feSUo5NUIUnQAQNNTiS", + "status" : 0, + "role" : 2, + "description" : "", + "create_time" : 1595927749772, + "update_time" : 1595927749772 + }, { + "email" : "xxx@xxx.com", + "worker_id" : "27906df1d06c0827b7c24f761d618541", + "workforce_id" : "XiL5RcHmxyIt3aYIOtI", + "status" : 0, + "role" : 2, + "description" : "", + "create_time" : 1590027298717, + "update_time" : 1590027298717 + } ] + } + +Status Codes +------------ + + + +.. _ListAllWorkersstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_member_management/querying_the_list_of_labeling_team_members.rst b/api-ref/source/data_management/labeling_team_member_management/querying_the_list_of_labeling_team_members.rst new file mode 100644 index 0000000..29a2cd1 --- /dev/null +++ b/api-ref/source/data_management/labeling_team_member_management/querying_the_list_of_labeling_team_members.rst @@ -0,0 +1,183 @@ +Querying the List of Labeling Team Members +========================================== + +Function +-------- + +This API is used to query the list of labeling team members. + +URI +--- + +GET /v2/{project_id}/workforces/{workforce_id}/workers + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | Yes | String | ID of a labeling team. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+===============================================================================================================+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting sequence. The options are as follows: | + | | | | | + | | | | - **asc**: ascending order | + | | | | | + | | | | - **desc**: descending order (default value) | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Sorting mode of the query. The options are as follows: | + | | | | | + | | | | - **create_time**: Sort by creation time. (Default value) | + | | | | | + | | | | - **email**: Sort by email. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListWorkersresponseListWorkersResp: + +.. table:: **Table 3** Response body parameters + + +--------------+----------------------------------------------------------+---------------------------------------------+ + | Parameter | Type | Description | + +==============+==========================================================+=============================================+ + | total_number | Integer | Total number of labeling team members. | + +--------------+----------------------------------------------------------+---------------------------------------------+ + | workers | Array of `Worker <#listworkersresponseworker>`__ objects | Labeling team members list queried by page. | + +--------------+----------------------------------------------------------+---------------------------------------------+ + + + +.. _ListWorkersresponseWorker: + +.. table:: **Table 4** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the List of Labeling Team Members + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/workforces/{workforce_id}/workers + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "total_number" : 3, + "workers" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "b1e4054407ecb36a7bcde70f52ba37f2", + "workforce_id" : "gyb7IaAvkLc5IhEY2dv", + "status" : 0, + "role" : 2, + "description" : "", + "create_time" : 1606356324223, + "update_time" : 1606356324223 + }, { + "email" : "xxx@xxx.com", + "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", + "workforce_id" : "gyb7IaAvkLc5IhEY2dv", + "status" : 0, + "role" : 0, + "description" : "", + "create_time" : 1591783804629, + "update_time" : 1591783804629 + }, { + "email" : "xxx@xxx.com", + "worker_id" : "2880f38d660dd68ca6ab578b5a1d9558", + "workforce_id" : "gyb7IaAvkLc5IhEY2dv", + "status" : 0, + "role" : 0, + "description" : "", + "create_time" : 1575104629439, + "update_time" : 1575104629439 + } ] + } + +Status Codes +------------ + + + +.. _ListWorkersstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_member_management/sending_an_email_to_a_labeling_team_member.rst b/api-ref/source/data_management/labeling_team_member_management/sending_an_email_to_a_labeling_team_member.rst new file mode 100644 index 0000000..a481a48 --- /dev/null +++ b/api-ref/source/data_management/labeling_team_member_management/sending_an_email_to_a_labeling_team_member.rst @@ -0,0 +1,133 @@ +Sending an Email to a Labeling Team Member +========================================== + +Function +-------- + +This API is used to send an email to a labeling team member. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/notify + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a team labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _SendEmailsrequestResendEmailReq: + +.. table:: **Table 2** Request body parameters + + +-----------+-----------+------------------+---------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+==================+=======================================+ + | emails | Yes | Array of strings | Email list of a labeling team member. | + +-----------+-----------+------------------+---------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _SendEmailsresponseResendEmailResp: + +.. table:: **Table 3** Response body parameters + + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================================================================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------+ + | results | Array of `BatchResponse <#sendemailsresponsebatchresponse>`__ objects | Result of sending an email to a labeling team member. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-----------------------------------------------------------------------+------------------------------------------------------------------------+ + + + +.. _SendEmailsresponseBatchResponse: + +.. table:: **Table 4** BatchResponse + + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + +Example Requests +---------------- + +Sending an Email to a Labeling Team Member + +.. code-block:: + + { + "emails" : [ "xxx@xxx.com", "xxx@xxx.com" ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "success" : true + } + +Status Codes +------------ + + + +.. _SendEmailsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/labeling_team_member_management/updating_a_labeling_team_member.rst b/api-ref/source/data_management/labeling_team_member_management/updating_a_labeling_team_member.rst new file mode 100644 index 0000000..2b1a03b --- /dev/null +++ b/api-ref/source/data_management/labeling_team_member_management/updating_a_labeling_team_member.rst @@ -0,0 +1,100 @@ +Updating a Labeling Team Member +=============================== + +Function +-------- + +This API is used to update a labeling team member. + +URI +--- + +PUT /v2/{project_id}/workforces/{workforce_id}/workers/{worker_id} + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | Yes | String | ID of a labeling team member. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | Yes | String | ID of a labeling team. | + +--------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateWorkerrequestUpdateWorkerReq: + +.. table:: **Table 2** Request body parameters + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==========================================================================================================================================+ + | description | No | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | No | Integer | Role. The options are as follows: | + | | | | | + | | | | - **0**: labeling personnel | + | | | | | + | | | | - **1**: reviewer | + | | | | | + | | | | - **2**: team administrator | + | | | | | + | | | | - **3**: dataset owner | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Updating a Labeling Team Member + +.. code-block:: + + { + "description" : "My name is Tom", + "role" : 2 + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _UpdateWorkerstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/manual_labeling/index.rst b/api-ref/source/data_management/manual_labeling/index.rst new file mode 100644 index 0000000..484a54e --- /dev/null +++ b/api-ref/source/data_management/manual_labeling/index.rst @@ -0,0 +1,8 @@ +=============== +Manual Labeling +=============== + +.. toctree:: + :maxdepth: 1 + + updating_sample_labels_in_batches diff --git a/api-ref/source/data_management/manual_labeling/updating_sample_labels_in_batches.rst b/api-ref/source/data_management/manual_labeling/updating_sample_labels_in_batches.rst new file mode 100644 index 0000000..7fbf7ed --- /dev/null +++ b/api-ref/source/data_management/manual_labeling/updating_sample_labels_in_batches.rst @@ -0,0 +1,451 @@ +Updating Sample Labels in Batches +================================= + +Function +-------- + +This API is used to update sample labels in batches, including adding, modifying, and deleting sample labels. If the parameter **Labels** of a sample in the request body is not specified, the label of the sample is deleted. + +URI +--- + +PUT /v2/{project_id}/datasets/{dataset_id}/data-annotations/samples + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateSamplesrequestUpdateSamplesReq: + +.. table:: **Table 2** Request body parameters + + +-----------+-----------+-----------------------------------------------------------------------+------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+=======================================================================+==========================================+ + | email | No | String | Email address of a labeling team member. | + +-----------+-----------+-----------------------------------------------------------------------+------------------------------------------+ + | samples | No | Array of `SampleLabels <#updatesamplesrequestsamplelabels>`__ objects | Updated sample list. | + +-----------+-----------+-----------------------------------------------------------------------+------------------------------------------+ + + + +.. _UpdateSamplesrequestSampleLabels: + +.. table:: **Table 3** SampleLabels + + +-----------------+-----------------+---------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=====================================================================+====================================================================================+ + | labels | No | Array of `SampleLabel <#updatesamplesrequestsamplelabel>`__ objects | Sample label list. If this parameter is left blank, all sample labels are deleted. | + +-----------------+-----------------+---------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | metadata | No | `SampleMetadata <#updatesamplesrequestsamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------+-----------------+---------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_id | No | String | Sample ID. | + +-----------------+-----------------+---------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_type | No | Integer | Sample type. The options are as follows: | + | | | | | + | | | | - **0**: image | + | | | | | + | | | | - **1**: text | + | | | | | + | | | | - **2**: speech | + | | | | | + | | | | - **4**: table | + | | | | | + | | | | - **6**: video | + | | | | | + | | | | - **9**: custom format | + +-----------------+-----------------+---------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_usage | No | String | Sample usage. The options are as follows: | + | | | | | + | | | | - **TRAIN**: training | + | | | | | + | | | | - **EVAL**: evaluation | + | | | | | + | | | | - **TEST**: test | + | | | | | + | | | | - **INFERENCE**: inference | + +-----------------+-----------------+---------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | source | No | String | Source address of sample data. | + +-----------------+-----------------+---------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | worker_id | No | String | ID of a labeling team member. | + +-----------------+-----------------+---------------------------------------------------------------------+------------------------------------------------------------------------------------+ + + + +.. _UpdateSamplesrequestSampleLabel: + +.. table:: **Table 4** SampleLabel + + +-----------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===========================================================================+=======================================================================================================================================+ + | annotated_by | No | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | | + | | | | - **human**: manual labeling | + | | | | | + | | | | - **auto**: automatic labeling | + +-----------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | No | String | Label ID. | + +-----------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Label name. | + +-----------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | No | `SampleLabelProperty <#updatesamplesrequestsamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | No | Float | Confidence. | + +-----------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateSamplesrequestSampleLabelProperty: + +.. table:: **Table 5** SampleLabelProperty + + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============================+=================+=================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | No | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | No | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | | + | | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | | + | | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | No | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | No | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | | + | | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | | + | | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | | + | | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | | + | | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | | + | | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | | + | | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | | + | | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | No | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | No | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | | + | | | | - **0/false**: not a hard example | + | | | | | + | | | | - **1/true**: hard example | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | No | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | No | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | | + | | | | - **0**: No target objects are identified. | + | | | | | + | | | | - **1**: The confidence is low. | + | | | | | + | | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | | + | | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | | + | | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | | + | | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | | + | | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | No | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | | + | | | | - **bndbox**: rectangle | + | | | | | + | | | | - **polygon**: polygon | + | | | | | + | | | | - **circle**: circle | + | | | | | + | | | | - **line**: straight line | + | | | | | + | | | | - **dashed**: dotted line | + | | | | | + | | | | - **point**: point | + | | | | | + | | | | - **polyline**: polyline | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | No | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | No | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | No | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | No | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateSamplesrequestSampleMetadata: + +.. table:: **Table 6** SampleMetadata + + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============================+=================+===================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | No | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | | + | | | | - **0**: non-hard sample | + | | | | | + | | | | - **1**: hard sample | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | No | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | No | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | | + | | | | - **0**: No target objects are identified. | + | | | | | + | | | | - **1**: The confidence is low. | + | | | | | + | | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | | + | | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | | + | | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | | + | | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | | + | | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | No | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _UpdateSamplesresponseUpdateSamplesResp: + +.. table:: **Table 7** Response body parameters + + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==========================================================================+==================================================================+ + | error_code | String | Error code. | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------+ + | results | Array of `BatchResponse <#updatesamplesresponsebatchresponse>`__ objects | Response list for updating sample labels in batches. | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------+ + | success | Boolean | Whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: successful | + | | | | + | | | - **false**: failed | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------+ + + + +.. _UpdateSamplesresponseBatchResponse: + +.. table:: **Table 8** BatchResponse + + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + +Example Requests +---------------- + +Updating Sample Labels in Batches + +.. code-block:: + + { + "samples" : [ { + "sample_id" : "8b583c44bf249f8ba43ea42c92920221", + "labels" : [ { + "name" : "yunbao" + } ] + }, { + "sample_id" : "b5fe3039879660a2e6bf18166e247f68", + "labels" : [ { + "name" : "yunbao" + } ] + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "success" : true + } + +Status Codes +------------ + + + +.. _UpdateSamplesstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/creating_a_data_processing_task_version.rst b/api-ref/source/data_management/processing_task/creating_a_data_processing_task_version.rst new file mode 100644 index 0000000..1ce3495 --- /dev/null +++ b/api-ref/source/data_management/processing_task/creating_a_data_processing_task_version.rst @@ -0,0 +1,261 @@ +Creating a Data Processing Task Version +======================================= + +Function +-------- + +This API is used to create a data processing task version. + +URI +--- + +POST /v2/{project_id}/processor-tasks/{task_id}/versions + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateProcessorTaskVersionrequestCreateTaskVersionReq: + +.. table:: **Table 2** Request body parameters + + +-----------------+-----------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+==================================================================================================+=====================================================================================================================================================+ + | create_version | No | Boolean | Whether to synchronously create a task version when creating a task. The options are as follows: | + | | | | | + | | | | - **true**: Create a task version when creating a task. | + | | | | | + | | | | - **false**: Do not create a task version when creating a task. (Default value) | + +-----------------+-----------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | No | `ProcessorDataSource <#createprocessortaskversionrequestprocessordatasource>`__ object | Data source. Either this parameter or **inputs** is delivered. | + +-----------------+-----------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Description of a data processing task. The description contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------+-----------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + | inputs | No | Array of `ProcessorDataSource <#createprocessortaskversionrequestprocessordatasource>`__ objects | Data source list. Either this parameter or **data_source** is delivered. | + +-----------------+-----------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | Yes | String | Name of a data processing task. | + +-----------------+-----------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | ID of a data processing task. | + +-----------------+-----------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + | template | No | `TemplateParam <#createprocessortaskversionrequesttemplateparam>`__ object | Data processing template, such as the algorithm ID and parameters. | + +-----------------+-----------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | No | String | Dataset version ID. | + +-----------------+-----------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + | work_path | No | `WorkPath <#createprocessortaskversionrequestworkpath>`__ object | Working directory of a data processing task. | + +-----------------+-----------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +-----------------+-----------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateProcessorTaskVersionrequestProcessorDataSource: + +.. table:: **Table 3** ProcessorDataSource + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==============================================================================================================================================================================+ + | name | No | String | Dataset name. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source | No | String | Data source path. The options are as follows: | + | | | | | + | | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | | + | | | | - If **type** is set to **TASK**, **source** is a task ID. | + | | | | | + | | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + | | | | | + | | | | - If **type** is set to **CUSTOM** and the API is called by resource tenants, set **source** to the **project_id** of the actual user. Otherwise, this field is left blank. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | String | Data source type. The options are as follows: | + | | | | | + | | | | - **OBS**: Data obtained from OBS | + | | | | | + | | | | - **TASK**: Data processing task | + | | | | | + | | | | - **DATASET**: Dataset | + | | | | | + | | | | - **CUSTOM**: Data called by resource tenants | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | No | String | Version of a dataset. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | No | String | Dataset version name. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateProcessorTaskVersionrequestTemplateParam: + +.. table:: **Table 4** TemplateParam + + +-----------------+-----------------+--------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+======================================================================================+===================================================================================+ + | id | No | String | Task type, that is, ID of a data processing template. The options are as follows: | + | | | | | + | | | | - **sys_data_analyse**: feature analysis | + | | | | | + | | | | - **sys_data_cleaning**: data cleansing | + | | | | | + | | | | - **sys_data_augmentation**: data augmentation | + | | | | | + | | | | - **sys_data_validation**: data validation | + | | | | | + | | | | - **sys_data_selection**: data selection | + +-----------------+-----------------+--------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | name | No | String | Template name. | + +-----------------+-----------------+--------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | operator_params | No | Array of `OperatorParam <#createprocessortaskversionrequestoperatorparam>`__ objects | Operator parameter list. | + +-----------------+-----------------+--------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + + + +.. _CreateProcessorTaskVersionrequestOperatorParam: + +.. table:: **Table 5** OperatorParam + + +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +========================+===========+=========+==============================================================================================================================================================================================================================================================================================================================================================+ + | advanced_params_switch | No | Boolean | Advanced parameter switch. | + +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | id | No | String | ID of an operator. | + +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Name of an operator. | + +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | params | No | Object | Operator parameter. The parameter type is map. Currently, object only supports the types of Boolean, Integer, Long, String, List and Map. For two special scenarios of object detection and image classification in a data preprocessing task, the value of **task_type** is **object_detection** or **image_classification**. | + +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateProcessorTaskVersionrequestWorkPath: + +.. table:: **Table 6** WorkPath + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==========================================================================================================================================+ + | name | No | String | Dataset name. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | output_path | No | String | Output path. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | path | No | String | Working path. The options are as follows: | + | | | | | + | | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | | + | | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | String | Type of a working path. The options are as follows: | + | | | | | + | | | | - **OBS**: OBS path | + | | | | | + | | | | - **DATASET**: dataset | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | No | String | Version of a dataset. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | No | String | Name of a dataset version. The value can contain 0 to 32 characters. Only digits, letters, underscores (_), and hyphens (-) are allowed. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _CreateProcessorTaskVersionresponseCreateTaskVersionResp: + +.. table:: **Table 7** Response body parameters + + ========== ====== ===================================== + Parameter Type Description + ========== ====== ===================================== + version_id String Version ID of a data processing task. + ========== ====== ===================================== + +Example Requests +---------------- + +Creating a Data Validation Task Version + +.. code-block:: + + { + "name" : "PRE-e77c", + "inputs" : [ { + "type" : "DATASET", + "source" : "PYc9H2HGv5BJNwBGXyK", + "version_id" : "Osc8SZ7TZStiRV4vYkZ" + } ], + "work_path" : { + "type" : "DATASET", + "path" : "PYc9H2HGv5BJNwBGXyK", + "version_name" : "V0011" + }, + "description" : "", + "template" : { + "id" : "sys_data_validation", + "operator_params" : [ { + "name" : "MetaValidation", + "advanced_params_switch" : false, + "params" : { + "task_type" : "image_classification", + "dataset_type" : "manifest", + "source_service" : "select", + "filter_func" : "data_validation_select", + "image_max_width" : "1920", + "image_max_height" : "1920", + "total_status" : "[0,1,2]" + } + } ] + }, + "workspace_id" : "0" + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "version_id" : "qSaudx2sbPvthHygckA" + } + +Status Codes +------------ + + + +.. _CreateProcessorTaskVersionstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/creating_a_processing_task.rst b/api-ref/source/data_management/processing_task/creating_a_processing_task.rst new file mode 100644 index 0000000..d117ebe --- /dev/null +++ b/api-ref/source/data_management/processing_task/creating_a_processing_task.rst @@ -0,0 +1,390 @@ +Creating a Processing Task +========================== + +Function +-------- + +This API is used to create a processing task. You can create feature analysis tasks and data processing tasks. You can specify the **id** field of **template** composite parameter in the request body to create a task. + +- Feature analysis refers to the process of analyzing the features of an image based on the image or target box, such as the blurring degree and brightness, and drawing a visualized curve to help process the dataset. + +- Data processing refers to extracting or generating data that is valuable and meaningful to a particular person from a large amount of, cluttered, and incomprehensible data. Data processing includes data validation, data cleansing, data selection, and data augmentation. + +- Data validation indicates that the dataset is verified to ensure data accuracy. + +- Data cleansing refers to the process of denoising, correcting, or supplementing data. + +- Data selection indicates the process of selecting data subsets from full data. + +- Data augmentation indicates that data volume is increased through simple data amplification operations such as scaling, cropping, transformation, and composition. + +URI +--- + +POST /v2/{project_id}/processor-tasks + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateProcessorTaskrequestCreateProcessorTaskReq: + +.. table:: **Table 2** Request body parameters + + +-----------------+-----------------+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===========================================================================================+========================================================================================================================================================================================================================================================+ + | create_version | No | Boolean | Whether to synchronously create a task version when creating a task. Set this parameter to **true** only when creating a data processing task. For other types of tasks, this parameter is set to **false** or left blank. The options are as follows: | + | | | | | + | | | | - **true**: Create a task version when creating a task. | + | | | | | + | | | | - **false**: Do not create a task version when creating a task. (Default value) | + +-----------------+-----------------+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | No | `ProcessorDataSource <#createprocessortaskrequestprocessordatasource>`__ object | Data source. Either this parameter or **inputs** is used. A data source path cannot be an OBS path in a KMS-encrypted bucket. | + +-----------------+-----------------+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Description of a data processing task. The description contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------+-----------------+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inputs | No | Array of `ProcessorDataSource <#createprocessortaskrequestprocessordatasource>`__ objects | Data sources. Either this parameter or **data_source** is used. A data source path cannot be an OBS path in a KMS-encrypted bucket. | + +-----------------+-----------------+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | Yes | String | Name of a data processing task. | + +-----------------+-----------------+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | template | No | `TemplateParam <#createprocessortaskrequesttemplateparam>`__ object | Data processing template, such as the algorithm ID and parameters. | + +-----------------+-----------------+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | No | String | Dataset version ID. | + +-----------------+-----------------+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | work_path | No | `WorkPath <#createprocessortaskrequestworkpath>`__ object | Work directory of a data processing task. A work directory cannot be an OBS path in a KMS-encrypted bucket. | + +-----------------+-----------------+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +-----------------+-----------------+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateProcessorTaskrequestProcessorDataSource: + +.. table:: **Table 3** ProcessorDataSource + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==============================================================================================================================================================================+ + | name | No | String | Dataset name. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source | No | String | Data source path. The options are as follows: | + | | | | | + | | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | | + | | | | - If **type** is set to **TASK**, **source** is a task ID. | + | | | | | + | | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + | | | | | + | | | | - If **type** is set to **CUSTOM** and the API is called by resource tenants, set **source** to the **project_id** of the actual user. Otherwise, this field is left blank. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | String | Data source type. The options are as follows: | + | | | | | + | | | | - **OBS**: Data obtained from OBS | + | | | | | + | | | | - **TASK**: Data processing task | + | | | | | + | | | | - **DATASET**: Dataset | + | | | | | + | | | | - **CUSTOM**: Data called by resource tenants | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | No | String | Version of a dataset. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | No | String | Dataset version name. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateProcessorTaskrequestTemplateParam: + +.. table:: **Table 4** TemplateParam + + +-----------------+-----------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===============================================================================+===================================================================================+ + | id | No | String | Task type, that is, ID of a data processing template. The options are as follows: | + | | | | | + | | | | - **sys_data_analyse**: feature analysis | + | | | | | + | | | | - **sys_data_cleaning**: data cleansing | + | | | | | + | | | | - **sys_data_augmentation**: data augmentation | + | | | | | + | | | | - **sys_data_validation**: data validation | + | | | | | + | | | | - **sys_data_selection**: data selection | + +-----------------+-----------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | name | No | String | Template name. | + +-----------------+-----------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | operator_params | No | Array of `OperatorParam <#createprocessortaskrequestoperatorparam>`__ objects | Operator parameter list. | + +-----------------+-----------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + + + +.. _CreateProcessorTaskrequestOperatorParam: + +.. table:: **Table 5** OperatorParam + + +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +========================+===========+=========+==============================================================================================================================================================================================================================================================================================================================================================+ + | advanced_params_switch | No | Boolean | Advanced parameter switch. | + +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | id | No | String | ID of an operator. | + +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Name of an operator. | + +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | params | No | Object | Operator parameter. The parameter type is map. Currently, object only supports the types of Boolean, Integer, Long, String, List and Map. For two special scenarios of object detection and image classification in a data preprocessing task, the value of **task_type** is **object_detection** or **image_classification**. | + +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateProcessorTaskrequestWorkPath: + +.. table:: **Table 6** WorkPath + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==========================================================================================================================================+ + | name | No | String | Dataset name. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | output_path | No | String | Output path. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | path | No | String | Working path. The options are as follows: | + | | | | | + | | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | | + | | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | String | Type of a working path. The options are as follows: | + | | | | | + | | | | - **OBS**: OBS path | + | | | | | + | | | | - **DATASET**: dataset | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | No | String | Version of a dataset. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | No | String | Name of a dataset version. The value can contain 0 to 32 characters. Only digits, letters, underscores (_), and hyphens (-) are allowed. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _CreateProcessorTaskresponseCreateProcessorTaskResp: + +.. table:: **Table 7** Response body parameters + + ========= ====== ============================= + Parameter Type Description + ========= ====== ============================= + task_id String ID of a data processing task. + ========= ====== ============================= + +Example Requests +---------------- + +- Creating a Data Processing (Data Validation) Task + + .. code-block:: + + { + "name" : "PRE-e77c", + "inputs" : [ { + "type" : "DATASET", + "source" : "PYc9H2HGv5BJNwBGXyK", + "version_id" : "yoJ5ssClpNlOrsjjFDa" + } ], + "work_path" : { + "type" : "DATASET", + "path" : "PYc9H2HGv5BJNwBGXyK", + "version_name" : "V0010" + }, + "description" : "", + "create_version" : true, + "template" : { + "id" : "sys_data_validation", + "operator_params" : [ { + "name" : "MetaValidation", + "advanced_params_switch" : false, + "params" : { + "task_type" : "image_classification", + "dataset_type" : "manifest", + "source_service" : "select", + "filter_func" : "data_validation_select", + "image_max_width" : "1920", + "image_max_height" : "1920", + "total_status" : "[0,1,2]" + } + } ] + }, + "workspace_id" : "0" + } + +- Creating a Data Processing (Data Cleansing) Task + + .. code-block:: + + { + "name" : "PRE-330f", + "inputs" : [ { + "type" : "DATASET", + "source" : "gfghHSokody6AJigS5A", + "version_id" : "54IXbeJhfttGpL46lbv" + } ], + "work_path" : { + "type" : "DATASET", + "path" : "gfghHSokody6AJigS5A", + "version_name" : "V004" + }, + "description" : "", + "create_version" : true, + "template" : { + "id" : "sys_data_cleaning", + "operator_params" : [ { + "name" : "PCC", + "advanced_params_switch" : false, + "params" : { + "task_type" : "image_classification", + "dataset_type" : "manifest", + "source_service" : "select", + "filter_func" : "data_cleaning_select", + "prototype_sample_path" : "obs://test-obs/classify/data/cat-dog/", + "criticism_sample_path" : "", + "n_clusters" : "auto", + "simlarity_threshold" : "0.9", + "embedding_distance" : "0.2", + "checkpoint_path" : "/home/work/user-job-dir/test-lxm/resnet_v1_50", + "total_status" : "[0,2]", + "do_validation" : "True" + } + } ] + }, + "workspace_id" : "0" + } + +- Creating a Data Processing (Data Selection) Task + + .. code-block:: + + { + "name" : "PRE-aae5", + "inputs" : [ { + "type" : "DATASET", + "source" : "gLNSdlQ1iAAmPgl0Won", + "version_id" : "WAVPSYpKE3FggbgRxiK" + } ], + "work_path" : { + "type" : "DATASET", + "path" : "gLNSdlQ1iAAmPgl0Won", + "version_name" : "V003" + }, + "description" : "", + "create_version" : true, + "template" : { + "id" : "sys_data_selection", + "operator_params" : [ { + "name" : "SimDeduplication", + "advanced_params_switch" : false, + "params" : { + "task_type" : "image_classification", + "dataset_type" : "manifest", + "source_service" : "select", + "filter_func" : "data_deduplication_select", + "simlarity_threshold" : "0.9", + "total_status" : "[0,2]", + "do_validation" : "True" + } + } ] + }, + "workspace_id" : "0" + } + +- Creating a Data Processing (Data Augmentation) Task + + .. code-block:: + + { + "name" : "PRE-637c", + "inputs" : [ { + "type" : "DATASET", + "source" : "XGrRZuCV1qmMxnsmD5u", + "version_id" : "kjPDTOSi6BQqhtXZlFv" + } ], + "work_path" : { + "type" : "DATASET", + "path" : "XGrRZuCV1qmMxnsmD5u", + "version_name" : "V002" + }, + "description" : "", + "create_version" : true, + "template" : { + "id" : "sys_data_augmentation", + "operator_params" : [ { + "name" : "AddNoise", + "advanced_params_switch" : false, + "params" : { + "task_type" : "image_classification", + "dataset_type" : "manifest", + "AddNoise" : "1", + "noise_type" : "Gauss", + "loc" : "0", + "scale" : "1", + "lam" : "2", + "p" : "0.01", + "total_status" : "[3]", + "filter_func" : "data_augmentation", + "do_validation" : "True" + } + } ] + }, + "workspace_id" : "0" + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "task_id" : "SNEJua7qdZZN8GvkcEr" + } + +Status Codes +------------ + + + +.. _CreateProcessorTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/deleting_a_data_processing_task_version.rst b/api-ref/source/data_management/processing_task/deleting_a_data_processing_task_version.rst new file mode 100644 index 0000000..7a2c534 --- /dev/null +++ b/api-ref/source/data_management/processing_task/deleting_a_data_processing_task_version.rst @@ -0,0 +1,76 @@ +Deleting a Data Processing Task Version +======================================= + +Function +-------- + +This API is used to delete a data processing task version. + +URI +--- + +DELETE /v2/{project_id}/processor-tasks/{task_id}/versions/{version_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | String | Version ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Deleting a Data Processing Task Version + +.. code-block:: + + DELETE https://{endpoint}/v2/{project_id}/processor-tasks/{task_id}/versions/{version_id} + +Example Responses +----------------- + +**Status code: 204** + +No Content + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _DeleteProcessorTaskVersionstatuscode: + +=========== ============ +Status Code Description +=========== ============ +204 No Content +401 Unauthorized +403 Forbidden +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/deleting_a_processing_task.rst b/api-ref/source/data_management/processing_task/deleting_a_processing_task.rst new file mode 100644 index 0000000..02c3d11 --- /dev/null +++ b/api-ref/source/data_management/processing_task/deleting_a_processing_task.rst @@ -0,0 +1,74 @@ +Deleting a Processing Task +========================== + +Function +-------- + +This API is used to delete a processing task. You can delete feature analysis tasks and data processing tasks. A specific task can be deleted by specifying the **task_id** path parameter. + +URI +--- + +DELETE /v2/{project_id}/processor-tasks/{task_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Deleting a Data Processing Task + +.. code-block:: + + DELETE https://{endpoint}/v2/{project_id}/processor-tasks/{task_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _DeleteProcessorTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/index.rst b/api-ref/source/data_management/processing_task/index.rst new file mode 100644 index 0000000..a47b92e --- /dev/null +++ b/api-ref/source/data_management/processing_task/index.rst @@ -0,0 +1,19 @@ +=============== +Processing Task +=============== + +.. toctree:: + :maxdepth: 1 + + querying_the_list_of_a_processing_task + creating_a_processing_task + querying_the_algorithm_type_for_data_processing + querying_details_about_a_processing_task + updating_a_processing_task + deleting_a_processing_task + querying_the_version_list_of_a_data_processing_task + creating_a_data_processing_task_version + querying_the_details_about_the_version_of_a_data_processing_task + deleting_a_data_processing_task_version + querying_the_result_of_a_data_processing_task_version + stopping_the_version_of_a_data_processing_task diff --git a/api-ref/source/data_management/processing_task/querying_details_about_a_processing_task.rst b/api-ref/source/data_management/processing_task/querying_details_about_a_processing_task.rst new file mode 100644 index 0000000..b36b3fe --- /dev/null +++ b/api-ref/source/data_management/processing_task/querying_details_about_a_processing_task.rst @@ -0,0 +1,280 @@ +Querying Details About a Processing Task +======================================== + +Function +-------- + +This API is used to query the details about processing tasks. You can query feature analysis tasks and data processing tasks. You can specify the **task_id** parameter to query the details about a specific task. + +URI +--- + +GET /v2/{project_id}/processor-tasks/{task_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DescribeProcessorTaskresponseDescribeProcessorTaskResp: + +.. table:: **Table 2** Response body parameters + + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==============================================================================================+===========================================================================================================================================================+ + | create_time | Long | Time when a data processing task is created. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | `ProcessorDataSource <#describeprocessortaskresponseprocessordatasource>`__ object | Input of a data processing task. Either this parameter or **inputs** is delivered. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description of a data processing task. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | duration_seconds | Integer | Running time of data processing, in seconds. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_msg | String | Error message. This field is displayed when the value of status is **3**. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inputs | Array of `ProcessorDataSource <#describeprocessortaskresponseprocessordatasource>`__ objects | Input channel list of a data processing task. Either this parameter or **data_source** is delivered. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_current | Boolean | Whether the current task is the latest of the same type of this version. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Name of a data processing task. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | result | Object | Output result of a data processing task. This field is displayed when status is set to **2** and is valid for a feature analysis task. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Status of a data processing task. The options are as follows: | + | | | | + | | | - **0**: initialized | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: completed | + | | | | + | | | - **3**: failed | + | | | | + | | | - **4**: stopped | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | String | ID of a data processing task. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | template | `TemplateParam <#describeprocessortaskresponsetemplateparam>`__ object | Data processing template, such as the algorithm ID and parameters. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_count | Integer | Version number of a data processing task. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Dataset version ID corresponding to a data processing task. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name corresponding to a data processing task. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | work_path | `WorkPath <#describeprocessortaskresponseworkpath>`__ object | Working directory of a data processing task. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | Workspace ID of a data processing task. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +-----------------------+----------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeProcessorTaskresponseProcessorDataSource: + +.. table:: **Table 3** ProcessorDataSource + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==============================================================================================================================================================================+ + | name | String | Dataset name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source | String | Data source path. The options are as follows: | + | | | | + | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | + | | | - If **type** is set to **TASK**, **source** is a task ID. | + | | | | + | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + | | | | + | | | - If **type** is set to **CUSTOM** and the API is called by resource tenants, set **source** to the **project_id** of the actual user. Otherwise, this field is left blank. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Data source type. The options are as follows: | + | | | | + | | | - **OBS**: Data obtained from OBS | + | | | | + | | | - **TASK**: Data processing task | + | | | | + | | | - **DATASET**: Dataset | + | | | | + | | | - **CUSTOM**: Data called by resource tenants | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Version of a dataset. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeProcessorTaskresponseTemplateParam: + +.. table:: **Table 4** TemplateParam + + +-----------------------+----------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==================================================================================+===================================================================================+ + | id | String | Task type, that is, ID of a data processing template. The options are as follows: | + | | | | + | | | - **sys_data_analyse**: feature analysis | + | | | | + | | | - **sys_data_cleaning**: data cleansing | + | | | | + | | | - **sys_data_augmentation**: data augmentation | + | | | | + | | | - **sys_data_validation**: data validation | + | | | | + | | | - **sys_data_selection**: data selection | + +-----------------------+----------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | name | String | Template name. | + +-----------------------+----------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | operator_params | Array of `OperatorParam <#describeprocessortaskresponseoperatorparam>`__ objects | Operator parameter list. | + +-----------------------+----------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + + + +.. _DescribeProcessorTaskresponseOperatorParam: + +.. table:: **Table 5** OperatorParam + + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +========================+=========+==============================================================================================================================================================================================================================================================================================================================================================+ + | advanced_params_switch | Boolean | Advanced parameter switch. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | ID of an operator. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Name of an operator. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | params | Object | Operator parameter. The parameter type is map. Currently, object only supports the types of Boolean, Integer, Long, String, List and Map. For two special scenarios of object detection and image classification in a data preprocessing task, the value of **task_type** is **object_detection** or **image_classification**. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeProcessorTaskresponseWorkPath: + +.. table:: **Table 6** WorkPath + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | name | String | Dataset name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | output_path | String | Output path. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | path | String | Working path. The options are as follows: | + | | | | + | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | + | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Type of a working path. The options are as follows: | + | | | | + | | | - **OBS**: OBS path | + | | | | + | | | - **DATASET**: dataset | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Version of a dataset. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Name of a dataset version. The value can contain 0 to 32 characters. Only digits, letters, underscores (_), and hyphens (-) are allowed. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About a Data Processing Task + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/processor-tasks/{task_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "task_id" : "SSzH9AdmHTvIBeihArb", + "name" : "PRE-6c83", + "description" : "test", + "inputs" : [ { + "type" : "DATASET", + "source" : "qjHAs14pRu4n2so1Qlb", + "version_id" : "cUELhTAYGIR36YpTE5Y", + "name" : "dataset-dba1", + "version_name" : "V001" + } ], + "work_path" : { + "type" : "DATASET", + "path" : "qjHAs14pRu4n2so1Qlb", + "name" : "dataset-dba1", + "version_name" : "V002", + "output_path" : "/test-lxm/data-out/EnyHCFzjTFY20U3sYSE/" + }, + "template" : { + "id" : "sys_data_validation", + "name" : "data validation template name", + "operator_params" : [ { + "name" : "MetaValidation", + "advanced_params_switch" : false, + "params" : { + "task_type" : "image_classification", + "dataset_type" : "manifest", + "source_service" : "select", + "filter_func" : "data_validation_select", + "image_max_width" : "-1", + "image_max_height" : "-1", + "total_status" : "[0,1,2]" + } + } ] + }, + "status" : 2, + "duration_seconds" : 277, + "create_time" : 1614245065569, + "workspace_id" : "0", + "version_count" : 1, + "ai_project" : "" + } + +Status Codes +------------ + + + +.. _DescribeProcessorTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/querying_the_algorithm_type_for_data_processing.rst b/api-ref/source/data_management/processing_task/querying_the_algorithm_type_for_data_processing.rst new file mode 100644 index 0000000..522479e --- /dev/null +++ b/api-ref/source/data_management/processing_task/querying_the_algorithm_type_for_data_processing.rst @@ -0,0 +1,120 @@ +Querying the Algorithm Type for Data Processing +=============================================== + +Function +-------- + +This API is used to query the algorithm type for data processing. + +URI +--- + +GET /v2/{project_id}/processor-tasks/items + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _GetProcessorTaskItemsresponseGetProcessorTaskItemsResp: + +.. table:: **Table 2** Response body parameters + + +-----------+------------------------------------------------------------------------------------------+----------------------+ + | Parameter | Type | Description | + +===========+==========================================================================================+======================+ + | items | Array of `ProcessorTaskItem <#getprocessortaskitemsresponseprocessortaskitem>`__ objects | Algorithm type list. | + +-----------+------------------------------------------------------------------------------------------+----------------------+ + | total | Integer | Total number. | + +-----------+------------------------------------------------------------------------------------------+----------------------+ + + + +.. _GetProcessorTaskItemsresponseProcessorTaskItem: + +.. table:: **Table 3** ProcessorTaskItem + + =========== ====== ================================== + Parameter Type Description + =========== ====== ================================== + label_en String English name of an algorithm type. + label_zh String Chinese name of an algorithm type. + template_id String Algorithm type ID. + =========== ====== ================================== + +Example Requests +---------------- + +Querying the List of the Algorithm Type for Data Processing + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/processor-tasks/items + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "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" + } ] + } + +Status Codes +------------ + + + +.. _GetProcessorTaskItemsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/querying_the_details_about_the_version_of_a_data_processing_task.rst b/api-ref/source/data_management/processing_task/querying_the_details_about_the_version_of_a_data_processing_task.rst new file mode 100644 index 0000000..7eea284 --- /dev/null +++ b/api-ref/source/data_management/processing_task/querying_the_details_about_the_version_of_a_data_processing_task.rst @@ -0,0 +1,278 @@ +Querying the Details About the Version of a Data Processing Task +================================================================ + +Function +-------- + +This API is used to query the details about the version of a data processing task. + +URI +--- + +GET /v2/{project_id}/processor-tasks/{task_id}/versions/{version_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | String | Version ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DescProcessorTaskVersionresponseDescTaskVersionResp: + +.. table:: **Table 2** Response body parameters + + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | Parameter | Type | Description | + +=========================+=================================================================================================+===============================================================+ + | add_sample_count | Integer | Number of added images after processing. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | create_time | Long | Time when a data processing task is created. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | deleted_sample_count | Integer | Number of deleted images after processing. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | description | String | Version description of a data processing task. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | duration_seconds | Integer | Running time of a data processing task, in seconds. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | inputs | Array of `ProcessorDataSource <#descprocessortaskversionresponseprocessordatasource>`__ objects | Input channel of a data processing task. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | modified_sample_count | Integer | Number of modified images after processing. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | origin_sample_count | Integer | Number of images before processing. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | status | Integer | Status of a data processing task. The options are as follows: | + | | | | + | | | - **0**: initialized | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: completed | + | | | | + | | | - **3**: failed | + | | | | + | | | - **4**: stopped | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | task_id | String | ID of a data processing task. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | task_version_id | String | Version ID of a data processing task. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | template | `TemplateParam <#descprocessortaskversionresponsetemplateparam>`__ object | Algorithm template, such as the algorithm ID and parameters. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | unmodified_sample_count | Integer | Number of unmodified images after processing. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | update_time | Long | Time when a data processing task is created. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | version_name | String | Version name of a data processing task. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | work_path | `WorkPath <#descprocessortaskversionresponseworkpath>`__ object | Output channel of a data processing task. | + +-------------------------+-------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + + + +.. _DescProcessorTaskVersionresponseProcessorDataSource: + +.. table:: **Table 3** ProcessorDataSource + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==============================================================================================================================================================================+ + | name | String | Dataset name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source | String | Data source path. The options are as follows: | + | | | | + | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | + | | | - If **type** is set to **TASK**, **source** is a task ID. | + | | | | + | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + | | | | + | | | - If **type** is set to **CUSTOM** and the API is called by resource tenants, set **source** to the **project_id** of the actual user. Otherwise, this field is left blank. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Data source type. The options are as follows: | + | | | | + | | | - **OBS**: Data obtained from OBS | + | | | | + | | | - **TASK**: Data processing task | + | | | | + | | | - **DATASET**: Dataset | + | | | | + | | | - **CUSTOM**: Data called by resource tenants | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Version of a dataset. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescProcessorTaskVersionresponseTemplateParam: + +.. table:: **Table 4** TemplateParam + + +-----------------------+-------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=====================================================================================+===================================================================================+ + | id | String | Task type, that is, ID of a data processing template. The options are as follows: | + | | | | + | | | - **sys_data_analyse**: feature analysis | + | | | | + | | | - **sys_data_cleaning**: data cleansing | + | | | | + | | | - **sys_data_augmentation**: data augmentation | + | | | | + | | | - **sys_data_validation**: data validation | + | | | | + | | | - **sys_data_selection**: data selection | + +-----------------------+-------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | name | String | Template name. | + +-----------------------+-------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | operator_params | Array of `OperatorParam <#descprocessortaskversionresponseoperatorparam>`__ objects | Operator parameter list. | + +-----------------------+-------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + + + +.. _DescProcessorTaskVersionresponseOperatorParam: + +.. table:: **Table 5** OperatorParam + + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +========================+=========+==============================================================================================================================================================================================================================================================================================================================================================+ + | advanced_params_switch | Boolean | Advanced parameter switch. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | ID of an operator. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Name of an operator. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | params | Object | Operator parameter. The parameter type is map. Currently, object only supports the types of Boolean, Integer, Long, String, List and Map. For two special scenarios of object detection and image classification in a data preprocessing task, the value of **task_type** is **object_detection** or **image_classification**. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescProcessorTaskVersionresponseWorkPath: + +.. table:: **Table 6** WorkPath + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | name | String | Dataset name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | output_path | String | Output path. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | path | String | Working path. The options are as follows: | + | | | | + | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | + | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Type of a working path. The options are as follows: | + | | | | + | | | - **OBS**: OBS path | + | | | | + | | | - **DATASET**: dataset | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Version of a dataset. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Name of a dataset version. The value can contain 0 to 32 characters. Only digits, letters, underscores (_), and hyphens (-) are allowed. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About a Data Processing Task Version + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/processor-tasks/{task_id}/versions/{version_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "task_version_id" : "qSaudx2sbPvthHygckA", + "task_id" : "kM7j9TSa611ZzBThzSr", + "version_name" : "V002", + "description" : "", + "status" : 0, + "create_time" : 1606377874450, + "inputs" : [ { + "type" : "DATASET", + "source" : "PYc9H2HGv5BJNwBGXyK", + "version_id" : "Osc8SZ7TZStiRV4vYkZ", + "name" : "dataset-test", + "version_name" : "V0010" + } ], + "work_path" : { + "type" : "DATASET", + "path" : "PYc9H2HGv5BJNwBGXyK", + "name" : "dataset-test", + "version_name" : "V0011", + "output_path" : "/test-obs/classify/output/qSaudx2sbPvthHygckA/" + }, + "template" : { + "id" : "sys_data_validation", + "name" : "name to translate", + "operator_params" : [ { + "name" : "MetaValidation", + "advanced_params_switch" : false, + "params" : { + "task_type" : "image_classification", + "dataset_type" : "manifest", + "source_service" : "select", + "filter_func" : "data_validation_select", + "image_max_width" : "1920", + "image_max_height" : "1920", + "total_status" : "[0,1,2]" + } + } ] + }, + "duration_seconds" : 312 + } + +Status Codes +------------ + + + +.. _DescProcessorTaskVersionstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/querying_the_list_of_a_processing_task.rst b/api-ref/source/data_management/processing_task/querying_the_list_of_a_processing_task.rst new file mode 100644 index 0000000..3c41606 --- /dev/null +++ b/api-ref/source/data_management/processing_task/querying_the_list_of_a_processing_task.rst @@ -0,0 +1,390 @@ +Querying the List of a Processing Task +====================================== + +Function +-------- + +This API is used to query the list of a processing task. You can query the feature analysis tasks and data processing tasks. You can specify the **task_type** parameter to query the list of a specific type of tasks. + +- Feature analysis refers to the process of analyzing the features of an image based on the image or target box, such as the blurring degree and brightness, and drawing a visualized curve to help process the dataset. + +- Data processing refers to extracting or generating data that is valuable and meaningful to a particular person from a large amount of, cluttered, and incomprehensible data. Data processing includes data validation, data cleansing, data selection, and data augmentation. + +- Data validation indicates that the dataset is verified to ensure data accuracy. + +- Data cleansing refers to the process of denoising, correcting, or supplementing data. + +- Data selection indicates the process of selecting data subsets from full data. + +- Data augmentation indicates that data volume is increased through simple data amplification operations such as scaling, cropping, transformation, and composition. + +URI +--- + +GET /v2/{project_id}/processor-tasks + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==============================================================================================================================================================================+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting sequence of the query. The options are as follows: | + | | | | | + | | | | - **asc**: ascending order | + | | | | | + | | | | - **desc**: descending order (default value) | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | query_current | No | Boolean | Whether to query only the latest tasks of dataset version. The options are as follows: | + | | | | | + | | | | - **true**: Query only the latest tasks of the dataset version. | + | | | | | + | | | | - **false**: Query all tasks of the dataset version. (Default value) | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | return_result | No | Boolean | Whether to return the task result. The options are as follows: | + | | | | | + | | | | - **true**: Return the task result. (Default value) | + | | | | | + | | | | - **false**: Do not return the task result. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Sorting mode of the query. The options are as follows: | + | | | | | + | | | | - **create_time**: Sort by creation time. (Default value) | + | | | | | + | | | | - **name**: Sort by task name. | + | | | | | + | | | | - **duration_seconds**: Sort by running time. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source | No | String | Data source path of the query. The options are as follows: | + | | | | | + | | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | | + | | | | - If **type** is set to **TASK**, **source** is a task ID. | + | | | | | + | | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + | | | | | + | | | | - If **type** is set to **CUSTOM** and the API is called by resource tenants, set **source** to the **project_id** of the actual user. Otherwise, this field is left blank. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_type | No | String | Data source type of the query. If this parameter is not specified, all data sources are queried by default. The options are as follows: | + | | | | | + | | | | - **OBS**: Data obtained from OBS | + | | | | | + | | | | - **TASK**: Data processing task | + | | | | | + | | | | - **DATASET**: Dataset | + | | | | | + | | | | - **CUSTOM**: Data called by resource tenants | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | No | Integer | Task status of the query. If this parameter is not specified, tasks in all states are queried by default. The options are as follows: | + | | | | | + | | | | - **0**: initialized | + | | | | | + | | | | - **1**: running | + | | | | | + | | | | - **2**: completed | + | | | | | + | | | | - **3**: failed | + | | | | | + | | | | - **4**: stopped | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_name | No | String | Fuzzy search keyword. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_type | No | String | Task type, that is, ID of a data processing template. The options are as follows: | + | | | | | + | | | | - **sys_data_analyse**: feature analysis | + | | | | | + | | | | - **sys_data_cleaning**: data cleansing | + | | | | | + | | | | - **sys_data_augmentation**: data augmentation | + | | | | | + | | | | - **sys_data_validation**: data validation | + | | | | | + | | | | - **sys_data_selection**: data selection | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | No | Array | Version ID list of a specific dataset of the query. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListProcessorTasksresponseListProcessorTasksResp: + +.. table:: **Table 3** Response body parameters + + +-----------+-------------------------------------------------------------------------------------------------------+--------------------------------------------+ + | Parameter | Type | Description | + +===========+=======================================================================================================+============================================+ + | count | Integer | Total number of data processing tasks. | + +-----------+-------------------------------------------------------------------------------------------------------+--------------------------------------------+ + | tasks | Array of `DescribeProcessorTaskResp <#listprocessortasksresponsedescribeprocessortaskresp>`__ objects | Data processing task list queried by page. | + +-----------+-------------------------------------------------------------------------------------------------------+--------------------------------------------+ + + + +.. _ListProcessorTasksresponseDescribeProcessorTaskResp: + +.. table:: **Table 4** DescribeProcessorTaskResp + + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================================================================================+===========================================================================================================================================================+ + | create_time | Long | Time when a data processing task is created. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | `ProcessorDataSource <#listprocessortasksresponseprocessordatasource>`__ object | Input of a data processing task. Either this parameter or **inputs** is delivered. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Description of a data processing task. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | duration_seconds | Integer | Running time of data processing, in seconds. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_msg | String | Error message. This field is displayed when the value of status is **3**. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | inputs | Array of `ProcessorDataSource <#listprocessortasksresponseprocessordatasource>`__ objects | Input channel list of a data processing task. Either this parameter or **data_source** is delivered. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_current | Boolean | Whether the current task is the latest of the same type of this version. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Name of a data processing task. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | result | Object | Output result of a data processing task. This field is displayed when status is set to **2** and is valid for a feature analysis task. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Status of a data processing task. The options are as follows: | + | | | | + | | | - **0**: initialized | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: completed | + | | | | + | | | - **3**: failed | + | | | | + | | | - **4**: stopped | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | String | ID of a data processing task. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | template | `TemplateParam <#listprocessortasksresponsetemplateparam>`__ object | Data processing template, such as the algorithm ID and parameters. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_count | Integer | Version number of a data processing task. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Dataset version ID corresponding to a data processing task. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name corresponding to a data processing task. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | work_path | `WorkPath <#listprocessortasksresponseworkpath>`__ object | Working directory of a data processing task. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | Workspace ID of a data processing task. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +-----------------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListProcessorTasksresponseProcessorDataSource: + +.. table:: **Table 5** ProcessorDataSource + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==============================================================================================================================================================================+ + | name | String | Dataset name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source | String | Data source path. The options are as follows: | + | | | | + | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | + | | | - If **type** is set to **TASK**, **source** is a task ID. | + | | | | + | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + | | | | + | | | - If **type** is set to **CUSTOM** and the API is called by resource tenants, set **source** to the **project_id** of the actual user. Otherwise, this field is left blank. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Data source type. The options are as follows: | + | | | | + | | | - **OBS**: Data obtained from OBS | + | | | | + | | | - **TASK**: Data processing task | + | | | | + | | | - **DATASET**: Dataset | + | | | | + | | | - **CUSTOM**: Data called by resource tenants | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Version of a dataset. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListProcessorTasksresponseTemplateParam: + +.. table:: **Table 6** TemplateParam + + +-----------------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===============================================================================+===================================================================================+ + | id | String | Task type, that is, ID of a data processing template. The options are as follows: | + | | | | + | | | - **sys_data_analyse**: feature analysis | + | | | | + | | | - **sys_data_cleaning**: data cleansing | + | | | | + | | | - **sys_data_augmentation**: data augmentation | + | | | | + | | | - **sys_data_validation**: data validation | + | | | | + | | | - **sys_data_selection**: data selection | + +-----------------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | name | String | Template name. | + +-----------------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | operator_params | Array of `OperatorParam <#listprocessortasksresponseoperatorparam>`__ objects | Operator parameter list. | + +-----------------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + + + +.. _ListProcessorTasksresponseOperatorParam: + +.. table:: **Table 7** OperatorParam + + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +========================+=========+==============================================================================================================================================================================================================================================================================================================================================================+ + | advanced_params_switch | Boolean | Advanced parameter switch. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | ID of an operator. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Name of an operator. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | params | Object | Operator parameter. The parameter type is map. Currently, object only supports the types of Boolean, Integer, Long, String, List and Map. For two special scenarios of object detection and image classification in a data preprocessing task, the value of **task_type** is **object_detection** or **image_classification**. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListProcessorTasksresponseWorkPath: + +.. table:: **Table 8** WorkPath + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | name | String | Dataset name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | output_path | String | Output path. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | path | String | Working path. The options are as follows: | + | | | | + | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | + | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Type of a working path. The options are as follows: | + | | | | + | | | - **OBS**: OBS path | + | | | | + | | | - **DATASET**: dataset | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Version of a dataset. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Name of a dataset version. The value can contain 0 to 32 characters. Only digits, letters, underscores (_), and hyphens (-) are allowed. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Query historical data validation tasks of a specified dataset. + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/processor-tasks?offset=0&limit=10&sort_by=create_time&order=desc&source_type=DATASET&source=qjHAs14pRu4n2so1Qlb&task_type=sys_data_validation&return_result=false + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "task_id" : "SSzH9AdmHTvIBeihArb", + "name" : "PRE-6c83", + "description" : "test", + "inputs" : [ { + "type" : "DATASET", + "source" : "qjHAs14pRu4n2so1Qlb", + "version_id" : "cUELhTAYGIR36YpTE5Y", + "name" : "dataset-dba1", + "version_name" : "V001" + } ], + "work_path" : { + "type" : "DATASET", + "path" : "qjHAs14pRu4n2so1Qlb", + "name" : "dataset-dba1", + "version_name" : "V002", + "output_path" : "/test-lxm/data-out/EnyHCFzjTFY20U3sYSE/" + }, + "template" : { + "id" : "sys_data_validation", + "name" : "data validation template name", + "operator_params" : [ { + "name" : "MetaValidation", + "advanced_params_switch" : false, + "params" : { + "task_type" : "image_classification", + "dataset_type" : "manifest", + "source_service" : "select", + "filter_func" : "data_validation_select", + "image_max_width" : "-1", + "image_max_height" : "-1", + "total_status" : "[0,1,2]" + } + } ] + }, + "status" : 2, + "duration_seconds" : 277, + "create_time" : 1614245065569, + "workspace_id" : "0", + "version_count" : 1, + "ai_project" : "" + } + +Status Codes +------------ + + + +.. _ListProcessorTasksstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/querying_the_result_of_a_data_processing_task_version.rst b/api-ref/source/data_management/processing_task/querying_the_result_of_a_data_processing_task_version.rst new file mode 100644 index 0000000..0743a8d --- /dev/null +++ b/api-ref/source/data_management/processing_task/querying_the_result_of_a_data_processing_task_version.rst @@ -0,0 +1,184 @@ +Querying the Result of a Data Processing Task Version +===================================================== + +Function +-------- + +This API is used to query the result of a data processing task version. + +URI +--- + +GET /v2/{project_id}/processor-tasks/{task_id}/versions/{version_id}/results + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | String | Version ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+=================+=================+=====================================================================================================================================================================================================================================+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | process_parameter | No | String | Image resizing setting, which is the same as the OBS resizing setting. For details, see . For example, **image/resize,m_lfit,h_200** indicates that the target image is resized proportionally and the height is set to 200 pixels. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | result_property | No | String | Sample status. If this parameter is not delivered or is set to **-1**, all samples are returned by default. The options are as follows: | + | | | | | + | | | | - **-1**: all | + | | | | | + | | | | - **0**: reserve | + | | | | | + | | | | - **1**: modify | + | | | | | + | | | | - **2**: delete | + | | | | | + | | | | - **3**: add | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListProcessorTaskVersionResultsresponseListProcessorTaskVersionResultsResp: + +.. table:: **Table 3** Response body parameters + + +-----------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ + | Parameter | Type | Description | + +===========+========================================================================================================================================+===================================+ + | count | Integer | Total number of results. | + +-----------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ + | has_more | Boolean | Whether all results are returned. | + +-----------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ + | results | Array of `DescProcessorTaskVersionResultsResp <#listprocessortaskversionresultsresponsedescprocessortaskversionresultsresp>`__ objects | Result displayed by page. | + +-----------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ + + + +.. _ListProcessorTaskVersionResultsresponseDescProcessorTaskVersionResultsResp: + +.. table:: **Table 4** DescProcessorTaskVersionResultsResp + + +-----------------------+-----------------------+------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+============================================================+ + | new_source | String | Address of the sample after processing. | + +-----------------------+-----------------------+------------------------------------------------------------+ + | origin_source | String | Source address of a sample. | + +-----------------------+-----------------------+------------------------------------------------------------+ + | result_description | Array of objects | Processing description of a sample. | + +-----------------------+-----------------------+------------------------------------------------------------+ + | result_property | Integer | Processing status of a sample. The options are as follows: | + | | | | + | | | - **-1**: all | + | | | | + | | | - **0**: reserve | + | | | | + | | | - **1**: modify | + | | | | + | | | - **2**: delete | + | | | | + | | | - **3**: add | + +-----------------------+-----------------------+------------------------------------------------------------+ + | sample_id | String | Sample ID, which is generated by **md5** in the OBS path. | + +-----------------------+-----------------------+------------------------------------------------------------+ + | signed_new_source | String | Address of the processed sample after signature. | + +-----------------------+-----------------------+------------------------------------------------------------+ + | signed_origin_source | String | Source sample address after signature. | + +-----------------------+-----------------------+------------------------------------------------------------+ + | version_id | String | Version ID of a data processing task. | + +-----------------------+-----------------------+------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the Result of a Data Processing Task Version + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/processor-tasks/{task_id}/versions/{version_id}/results?offset=0&limit=14&result_property=-1 + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "count" : 3, + "results" : [ { + "sample_id" : "0ac9aee517acbef965f547bb5a3268af", + "version_id" : "7PoIhUzSk92OglQrTxr", + "origin_source" : "s3://test-obs/classify/data/cat-dog/8.jpg", + "new_source" : "obs://test-obs/classify/output/7PoIhUzSk92OglQrTxr/Data/8.jpg", + "signed_origin_source" : "https://test-obs.obs.xxx.com:443/classify/data/cat-dog/8.jpg?AccessKeyId=I5IZ9R29S1W9WACNJJ0J&Expires=1606380154&x-obs-security-token=gQpjbi1ub3J0aC03jQ5yFSR1TfKXjeawutgyAnMrdoGNaSkeSBOKK...&Signature=GbnVBZ5JxUWhiAulUzpV9TD835Q%3D", + "signed_new_source" : "https://test-obs.obs.xxx.com:443/classify/output/7PoIhUzSk92OglQrTxr/Data/8.jpg?AccessKeyId=I5IZ9R29S1W9WACNJJ0J&Expires=1606380154&x-obs-security-token=gQpjbi1ub3J0aC03jQ5yFSR1TfKXjeawutgyAnMrdoGNaSkeSBOKK...&Signature=Q5stFFFfVx9kykR49S8PPBlFqe0%3D", + "result_property" : 3, + "result_description" : [ [ "use AddNoise augmentation" ], [ "result_description to translate" ] ] + }, { + "sample_id" : "196799b2d731727b1800b70851fc60b0", + "version_id" : "7PoIhUzSk92OglQrTxr", + "origin_source" : "s3://test-obs/classify/data/cat-dog/2.jpg", + "new_source" : "obs://test-obs/classify/output/7PoIhUzSk92OglQrTxr/Data/2.jpg", + "signed_origin_source" : "https://test-obs.obs.xxx.com:443/classify/data/cat-dog/2.jpg?AccessKeyId=QEKFB6WFGZWC2YUP2JPK&Expires=1606380154&x-obs-security-token=gQpjbi1ub3J0aC03jdUZcXVRCNOHjWNNWiuu2E9Q...&Signature=6yvhJufi5kQO6UjToQgR0ztP%2Bis%3D", + "signed_new_source" : "https://test-obs.obs.xxx.com:443/classify/output/7PoIhUzSk92OglQrTxr/Data/2.jpg?AccessKeyId=QEKFB6WFGZWC2YUP2JPK&Expires=1606380154&x-obs-security-token=gQpjbi1ub3J0aC03jdUZcXVRCNOHjWNNWiuu2E...&Signature=Zr%2BAEBDJwKS%2FpS6vzxK7MSzjblA%3D", + "result_property" : 3, + "result_description" : [ [ "use AddNoise augmentation" ], [ "result_description to translate" ] ] + }, { + "sample_id" : "1dc7351b78dcb24850f71d20267edd0e", + "version_id" : "7PoIhUzSk92OglQrTxr", + "origin_source" : "s3://test-obs/classify/data/cat-dog/import_1603716822103/test-obs/classify/output/E8ZLnTQvPBVtbZ6QsAp/Data/13.jpg", + "new_source" : "obs://test-obs/classify/output/7PoIhUzSk92OglQrTxr/Data/13.jpg", + "signed_origin_source" : "https://test-obs.obs.xxx.com:443/classify/data/cat-dog/import_1603716822103/test-obs/classify/output/E8ZLnTQvPBVtbZ6QsAp/Data/13.jpg?AccessKeyId=W6TSX9F1BRS8AUBDYKPY&Expires=1606380154&x-obs-security-token=gQpjbi1ub3J0aC03jVVFic8iObvdqZLuWxyIHlAjbJPCTX...&Signature=WV73XnoMkBDoSuVe%2BFSUaP1GxKw%3D", + "signed_new_source" : "https://test-obs.obs.xxx.com:443/classify/output/7PoIhUzSk92OglQrTxr/Data/13.jpg?AccessKeyId=W6TSX9F1BRS8AUBDYKPY&Expires=1606380154&x-obs-security-token=gQpjbi1ub3J0aC03jVVFic8iObvdqZLuWxyIHlAjbJPCTXeYXkQh8z...&Signature=%2FYsgrsbyrz5ZQrndrQ9QyoHluYQ%3D", + "result_property" : 3, + "result_description" : [ [ "use AddNoise augmentation" ], [ "result_description to translate" ] ] + } ], + "has_more" : true + } + +Status Codes +------------ + + + +.. _ListProcessorTaskVersionResultsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/querying_the_version_list_of_a_data_processing_task.rst b/api-ref/source/data_management/processing_task/querying_the_version_list_of_a_data_processing_task.rst new file mode 100644 index 0000000..59914c2 --- /dev/null +++ b/api-ref/source/data_management/processing_task/querying_the_version_list_of_a_data_processing_task.rst @@ -0,0 +1,360 @@ +Querying the Version List of a Data Processing Task +=================================================== + +Function +-------- + +This API is used to query the version list of a data processing task. + +URI +--- + +GET /v2/{project_id}/processor-tasks/{task_id}/versions + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+================================================================================================================+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **100**. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting sequence of the query. The options are as follows: | + | | | | | + | | | | - **asc**: ascending order | + | | | | | + | | | | - **desc**: descending order (default value) | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Sorting mode of the query. The options are as follows: | + | | | | | + | | | | - **create_time**: Sort by creation time. (Default value) | + | | | | | + | | | | - **version_name**: Sort by task version name. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListProcessorTaskVersionsresponseListTaskVersionsResp: + +.. table:: **Table 3** Response body parameters + + +-----------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------+ + | Parameter | Type | Description | + +===========+==================================================================================================+=========================================================+ + | count | Integer | Total number of versions. | + +-----------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------+ + | versions | Array of `DescTaskVersionResp <#listprocessortaskversionsresponsedesctaskversionresp>`__ objects | Version list of a data processing task queried by page. | + +-----------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------+ + + + +.. _ListProcessorTaskVersionsresponseDescTaskVersionResp: + +.. table:: **Table 4** DescTaskVersionResp + + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | Parameter | Type | Description | + +=========================+==================================================================================================+===============================================================+ + | add_sample_count | Integer | Number of added images after processing. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | create_time | Long | Time when a data processing task is created. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | deleted_sample_count | Integer | Number of deleted images after processing. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | description | String | Version description of a data processing task. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | duration_seconds | Integer | Running time of a data processing task, in seconds. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | inputs | Array of `ProcessorDataSource <#listprocessortaskversionsresponseprocessordatasource>`__ objects | Input channel of a data processing task. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | modified_sample_count | Integer | Number of modified images after processing. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | origin_sample_count | Integer | Number of images before processing. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | status | Integer | Status of a data processing task. The options are as follows: | + | | | | + | | | - **0**: initialized | + | | | | + | | | - **1**: running | + | | | | + | | | - **2**: completed | + | | | | + | | | - **3**: failed | + | | | | + | | | - **4**: stopped | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | task_id | String | ID of a data processing task. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | task_version_id | String | Version ID of a data processing task. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | template | `TemplateParam <#listprocessortaskversionsresponsetemplateparam>`__ object | Algorithm template, such as the algorithm ID and parameters. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | unmodified_sample_count | Integer | Number of unmodified images after processing. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | update_time | Long | Time when a data processing task is created. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | version_name | String | Version name of a data processing task. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + | work_path | `WorkPath <#listprocessortaskversionsresponseworkpath>`__ object | Output channel of a data processing task. | + +-------------------------+--------------------------------------------------------------------------------------------------+---------------------------------------------------------------+ + + + +.. _ListProcessorTaskVersionsresponseProcessorDataSource: + +.. table:: **Table 5** ProcessorDataSource + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==============================================================================================================================================================================+ + | name | String | Dataset name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source | String | Data source path. The options are as follows: | + | | | | + | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | + | | | - If **type** is set to **TASK**, **source** is a task ID. | + | | | | + | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + | | | | + | | | - If **type** is set to **CUSTOM** and the API is called by resource tenants, set **source** to the **project_id** of the actual user. Otherwise, this field is left blank. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Data source type. The options are as follows: | + | | | | + | | | - **OBS**: Data obtained from OBS | + | | | | + | | | - **TASK**: Data processing task | + | | | | + | | | - **DATASET**: Dataset | + | | | | + | | | - **CUSTOM**: Data called by resource tenants | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Version of a dataset. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Dataset version name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListProcessorTaskVersionsresponseTemplateParam: + +.. table:: **Table 6** TemplateParam + + +-----------------------+--------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+======================================================================================+===================================================================================+ + | id | String | Task type, that is, ID of a data processing template. The options are as follows: | + | | | | + | | | - **sys_data_analyse**: feature analysis | + | | | | + | | | - **sys_data_cleaning**: data cleansing | + | | | | + | | | - **sys_data_augmentation**: data augmentation | + | | | | + | | | - **sys_data_validation**: data validation | + | | | | + | | | - **sys_data_selection**: data selection | + +-----------------------+--------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | name | String | Template name. | + +-----------------------+--------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + | operator_params | Array of `OperatorParam <#listprocessortaskversionsresponseoperatorparam>`__ objects | Operator parameter list. | + +-----------------------+--------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+ + + + +.. _ListProcessorTaskVersionsresponseOperatorParam: + +.. table:: **Table 7** OperatorParam + + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +========================+=========+==============================================================================================================================================================================================================================================================================================================================================================+ + | advanced_params_switch | Boolean | Advanced parameter switch. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | ID of an operator. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Name of an operator. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | params | Object | Operator parameter. The parameter type is map. Currently, object only supports the types of Boolean, Integer, Long, String, List and Map. For two special scenarios of object detection and image classification in a data preprocessing task, the value of **task_type** is **object_detection** or **image_classification**. | + +------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListProcessorTaskVersionsresponseWorkPath: + +.. table:: **Table 8** WorkPath + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | name | String | Dataset name. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | output_path | String | Output path. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | path | String | Working path. The options are as follows: | + | | | | + | | | - If **type** is set to **OBS**, **source** is an OBS path. | + | | | | + | | | - If **type** is set to **DATASET**, **source** is a dataset ID. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Type of a working path. The options are as follows: | + | | | | + | | | - **OBS**: OBS path | + | | | | + | | | - **DATASET**: dataset | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | String | Version of a dataset. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Name of a dataset version. The value can contain 0 to 32 characters. Only digits, letters, underscores (_), and hyphens (-) are allowed. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the Version List of a Data Processing Task + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/processor-tasks/{task_id}/versions?offset=0&limit=5 + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "count" : 2, + "versions" : [ { + "task_version_id" : "qSaudx2sbPvthHygckA", + "task_id" : "kM7j9TSa611ZzBThzSr", + "version_name" : "V002", + "description" : "", + "status" : 0, + "create_time" : 1606377874450, + "inputs" : [ { + "type" : "DATASET", + "source" : "PYc9H2HGv5BJNwBGXyK", + "version_id" : "Osc8SZ7TZStiRV4vYkZ", + "name" : "dataset-test", + "version_name" : "V0010" + } ], + "work_path" : { + "type" : "DATASET", + "path" : "PYc9H2HGv5BJNwBGXyK", + "name" : "dataset-test", + "version_name" : "V0011", + "output_path" : "/test-obs/classify/output/qSaudx2sbPvthHygckA/" + }, + "template" : { + "id" : "sys_data_validation", + "name" : "name to translate", + "operator_params" : [ { + "name" : "MetaValidation", + "advanced_params_switch" : false, + "params" : { + "task_type" : "image_classification", + "dataset_type" : "manifest", + "source_service" : "select", + "filter_func" : "data_validation_select", + "image_max_width" : "1920", + "image_max_height" : "1920", + "total_status" : "[0,1,2]" + } + } ] + }, + "duration_seconds" : 151 + }, { + "task_version_id" : "YHFWU18zXuNbqxtzegG", + "task_id" : "kM7j9TSa611ZzBThzSr", + "version_name" : "V001", + "description" : "", + "status" : 2, + "create_time" : 1606375407276, + "inputs" : [ { + "type" : "DATASET", + "source" : "PYc9H2HGv5BJNwBGXyK", + "version_id" : "yoJ5ssClpNlOrsjjFDa", + "name" : "dataset-test", + "version_name" : "V009" + } ], + "work_path" : { + "type" : "DATASET", + "path" : "PYc9H2HGv5BJNwBGXyK", + "name" : "dataset-test", + "version_id" : "Osc8SZ7TZStiRV4vYkZ", + "version_name" : "V0010", + "output_path" : "/test-obs/classify/output/YHFWU18zXuNbqxtzegG/" + }, + "template" : { + "id" : "sys_data_validation", + "name" : "name to translate", + "operator_params" : [ { + "name" : "MetaValidation", + "advanced_params_switch" : false, + "params" : { + "task_type" : "image_classification", + "dataset_type" : "manifest", + "source_service" : "select", + "filter_func" : "data_validation_select", + "image_max_width" : "1920", + "image_max_height" : "1920", + "total_status" : "[0,1,2]" + } + } ] + }, + "duration_seconds" : 812, + "origin_sample_count" : 18, + "add_sample_count" : 0, + "modified_sample_count" : 0, + "unmodified_sample_count" : 18, + "deleted_sample_count" : 0 + } ] + } + +Status Codes +------------ + + + +.. _ListProcessorTaskVersionsstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/stopping_the_version_of_a_data_processing_task.rst b/api-ref/source/data_management/processing_task/stopping_the_version_of_a_data_processing_task.rst new file mode 100644 index 0000000..32a33a9 --- /dev/null +++ b/api-ref/source/data_management/processing_task/stopping_the_version_of_a_data_processing_task.rst @@ -0,0 +1,77 @@ +Stopping the Version of a Data Processing Task +============================================== + +Function +-------- + +This API is used to stop the version of a data processing task. + +URI +--- + +POST /v2/{project_id}/processor-tasks/{task_id}/versions/{version_id}/stop + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | String | Version ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +This API is used to stop the version of a data processing task. + +.. code-block:: + + POST https://{endpoint}/v2/{project_id}/processor-tasks/{task_id}/versions/{version_id}/stop + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _StopProcessorTaskVersionstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/processing_task/updating_a_processing_task.rst b/api-ref/source/data_management/processing_task/updating_a_processing_task.rst new file mode 100644 index 0000000..e6eacbe --- /dev/null +++ b/api-ref/source/data_management/processing_task/updating_a_processing_task.rst @@ -0,0 +1,87 @@ +Updating a Processing Task +========================== + +Function +-------- + +This API is used to update a processing task. You can update feature analysis tasks and data processing tasks. Only the description of updated tasks is supported. You can specify the **task_id** path parameter to update a specific task. + +URI +--- + +PUT /v2/{project_id}/processor-tasks/{task_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | task_id | Yes | String | ID of a data processing task. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateProcessorTaskrequestUpdateProcessorTaskReq: + +.. table:: **Table 2** Request body parameters + + +-------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+=====================================================================================================================================================+ + | description | No | String | Description of a data processing task. The description contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Updating a Data Processing Task + +.. code-block:: + + { + "description" : "test" + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _UpdateProcessorTaskstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/sample_management/adding_samples_in_batches.rst b/api-ref/source/data_management/sample_management/adding_samples_in_batches.rst new file mode 100644 index 0000000..8bac8bb --- /dev/null +++ b/api-ref/source/data_management/sample_management/adding_samples_in_batches.rst @@ -0,0 +1,562 @@ +Adding Samples in Batches +========================= + +Function +-------- + +This API is used to add samples in batches. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/data-annotations/samples + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _UploadSamplesJsonrequestUploadSamplesReq: + +.. table:: **Table 2** Request body parameters + + +------------------+-----------------+---------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==================+=================+===============================================================+=======================================================================================================================================================================+ + | final_annotation | No | Boolean | Whether to directly import to the final result. The options are as follows: | + | | | | | + | | | | - **true**: Import labels to the labeled dataset. (Default value). | + | | | | | + | | | | - **false**: Import labels to the to-be-confirmed dataset. Currently, to-be-confirmed datasets only support categories of image classification and object detection. | + +------------------+-----------------+---------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_format | No | `LabelFormat <#uploadsamplesjsonrequestlabelformat>`__ object | Label format. This parameter is used only for text datasets. | + +------------------+-----------------+---------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | No | Array of `Sample <#uploadsamplesjsonrequestsample>`__ objects | Sample list. | + +------------------+-----------------+---------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UploadSamplesJsonrequestLabelFormat: + +.. table:: **Table 3** LabelFormat + + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=======================+=================+=================+=========================================================================================================================================================================================================================================================================+ + | label_type | No | String | Label type of text classification. The options are as follows: | + | | | | | + | | | | - **0**: The label is separated from the text, and they are distinguished by the fixed suffix **\_result**. For example, the text file is **abc.txt**, and the label file is **abc_result.txt**. | + | | | | | + | | | | - **1**: Default value. Labels and texts are stored in the same file and separated by separators. You can use **text_sample_separator** to specify the separator between the text and label and **text_label_separator** to specify the separator between labels. | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | text_label_separator | No | String | Separator between labels. By default, the comma (,) is used as the separator. The separator needs to be escaped. Only one character can be used as the separator. The value must contain letters, digits, and one special character (!@#$%^&*_=|?/':.;,). | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | text_sample_separator | No | String | Separator between the text and label. By default, the **Tab** key is used as the separator. The separator needs to be escaped. Only one character can be used as the separator. The value must contain letters, digits, and one special character (!@#$%^&*_=|?/':.;,). | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UploadSamplesJsonrequestSample: + +.. table:: **Table 4** Sample + + +-----------------+-----------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=========================================================================+================================================================================================================================================================+ + | data | No | Object | Byte data of sample files. The type is **java.nio.ByteBuffer**. When this parameter is called, the string converted from the byte data is uploaded. | + +-----------------+-----------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | No | `DataSource <#uploadsamplesjsonrequestdatasource>`__ object | Data source. | + +-----------------+-----------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | encoding | No | String | Encoding type of sample files, which is used to upload .txt or .csv files. The value can be **UTF-8**, **GBK**, or **GB2312**. The default value is **UTF-8**. | + +-----------------+-----------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labels | No | Array of `SampleLabel <#uploadsamplesjsonrequestsamplelabel>`__ objects | Sample label list. | + +-----------------+-----------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | No | `SampleMetadata <#uploadsamplesjsonrequestsamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------+-----------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Name of sample files. The value contains 0 to 1,024 characters and cannot contain special characters (!<>=&"'). | + +-----------------+-----------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_type | No | Integer | Sample type. The options are as follows: | + | | | | | + | | | | - **0**: image | + | | | | | + | | | | - **1**: text | + | | | | | + | | | | - **2**: speech | + | | | | | + | | | | - **4**: table | + | | | | | + | | | | - **6**: video | + | | | | | + | | | | - **9**: custom format | + +-----------------+-----------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UploadSamplesJsonrequestDataSource: + +.. table:: **Table 5** DataSource + + +--------------------+-----------------+---------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+=================+=====================================================================+============================================================================================================================+ + | data_path | No | String | Data source path. | + +--------------------+-----------------+---------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | data_type | No | Integer | Data type. The options are as follows: | + | | | | | + | | | | - **0**: OBS bucket (default value) | + | | | | | + | | | | - **1**: GaussDB(DWS) | + | | | | | + | | | | - **2**: DLI | + | | | | | + | | | | - **3**: RDS | + | | | | | + | | | | - **4**: MRS | + | | | | | + | | | | - **5**: AI Gallery | + | | | | | + | | | | - **6**: Inference service | + +--------------------+-----------------+---------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | schema_maps | No | Array of `SchemaMap <#uploadsamplesjsonrequestschemamap>`__ objects | Schema mapping information corresponding to the table data. | + +--------------------+-----------------+---------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | source_info | No | `SourceInfo <#uploadsamplesjsonrequestsourceinfo>`__ object | Information required for importing a table data source. | + +--------------------+-----------------+---------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | with_column_header | No | Boolean | Whether the first row in the file is a column name. This field is valid for the table dataset. The options are as follows: | + | | | | | + | | | | - **true**: The first row in the file is the column name. | + | | | | | + | | | | - **false**: The first row in the file is not the column name. | + +--------------------+-----------------+---------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UploadSamplesJsonrequestSchemaMap: + +.. table:: **Table 6** SchemaMap + + ========= ========= ====== =============================== + Parameter Mandatory Type Description + ========= ========= ====== =============================== + dest_name No String Name of the destination column. + src_name No String Name of the source column. + ========= ========= ====== =============================== + + + +.. _UploadSamplesJsonrequestSourceInfo: + +.. table:: **Table 7** SourceInfo + + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==============================================================+ + | cluster_id | No | String | ID of an MRS cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | cluster_mode | No | String | Running mode of an MRS cluster. The options are as follows: | + | | | | | + | | | | - **0**: normal cluster | + | | | | | + | | | | - **1**: security cluster | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | cluster_name | No | String | Name of an MRS cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | database_name | No | String | Name of the database to which the table dataset is imported. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | input | No | String | HDFS path of a table dataset. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | ip | No | String | IP address of your GaussDB(DWS) cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | port | No | String | Port number of your GaussDB(DWS) cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | queue_name | No | String | DLI queue name of a table dataset. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | subnet_id | No | String | Subnet ID of an MRS cluster. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | table_name | No | String | Name of the table to which a table dataset is imported. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | user_name | No | String | Username, which is mandatory for GaussDB(DWS) data. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | user_password | No | String | User password, which is mandatory for GaussDB(DWS) data. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + | vpc_id | No | String | ID of the VPC where an MRS cluster resides. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------+ + + + +.. _UploadSamplesJsonrequestSampleLabel: + +.. table:: **Table 8** SampleLabel + + +-----------------+-----------------+-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===============================================================================+=======================================================================================================================================+ + | annotated_by | No | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | | + | | | | - **human**: manual labeling | + | | | | | + | | | | - **auto**: automatic labeling | + +-----------------+-----------------+-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | No | String | Label ID. | + +-----------------+-----------------+-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Label name. | + +-----------------+-----------------+-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | No | `SampleLabelProperty <#uploadsamplesjsonrequestsamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------+-----------------+-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | No | Float | Confidence. | + +-----------------+-----------------+-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UploadSamplesJsonrequestSampleLabelProperty: + +.. table:: **Table 9** SampleLabelProperty + + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============================+=================+=================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | No | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | No | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | | + | | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | | + | | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | No | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | No | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | | + | | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | | + | | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | | + | | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | | + | | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | | + | | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | | + | | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | | + | | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | No | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | No | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | | + | | | | - **0/false**: not a hard example | + | | | | | + | | | | - **1/true**: hard example | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | No | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | No | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | | + | | | | - **0**: No target objects are identified. | + | | | | | + | | | | - **1**: The confidence is low. | + | | | | | + | | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | | + | | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | | + | | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | | + | | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | | + | | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | No | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | | + | | | | - **bndbox**: rectangle | + | | | | | + | | | | - **polygon**: polygon | + | | | | | + | | | | - **circle**: circle | + | | | | | + | | | | - **line**: straight line | + | | | | | + | | | | - **dashed**: dotted line | + | | | | | + | | | | - **point**: point | + | | | | | + | | | | - **polyline**: polyline | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | No | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | No | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | No | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | No | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UploadSamplesJsonrequestSampleMetadata: + +.. table:: **Table 10** SampleMetadata + + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============================+=================+===================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | No | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | | + | | | | - **0**: non-hard sample | + | | | | | + | | | | - **1**: hard sample | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | No | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | No | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | | + | | | | - **0**: No target objects are identified. | + | | | | | + | | | | - **1**: The confidence is low. | + | | | | | + | | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | | + | | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | | + | | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | | + | | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | | + | | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | No | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _UploadSamplesJsonresponseUploadSamplesResp: + +.. table:: **Table 11** Response body parameters + + +-----------------------+------------------------------------------------------------------------------------+------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+====================================================================================+==================================================================+ + | error_code | String | Error code. | + +-----------------------+------------------------------------------------------------------------------------+------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+------------------------------------------------------------------------------------+------------------------------------------------------------------+ + | results | Array of `UploadSampleResp <#uploadsamplesjsonresponseuploadsampleresp>`__ objects | Response list for adding samples in batches. | + +-----------------------+------------------------------------------------------------------------------------+------------------------------------------------------------------+ + | success | Boolean | Whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: successful | + | | | | + | | | - **false**: failed | + +-----------------------+------------------------------------------------------------------------------------+------------------------------------------------------------------+ + + + +.. _UploadSamplesJsonresponseUploadSampleResp: + +.. table:: **Table 12** UploadSampleResp + + +-----------------------+-----------------------+------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------+ + | info | String | Description. | + +-----------------------+-----------------------+------------------------------------------------------------------+ + | name | String | Name of a sample file. | + +-----------------------+-----------------------+------------------------------------------------------------------+ + | success | Boolean | Whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: successful | + | | | | + | | | - **false**: failed | + +-----------------------+-----------------------+------------------------------------------------------------------+ + +Example Requests +---------------- + +Adding Samples in Batches + +.. code-block:: + + { + "samples" : [ { + "name" : "2.jpg", + "data" : "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjL/wAARCAA1AJUDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL" + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "success" : true, + "results" : [ { + "success" : true, + "name" : "/test-obs/classify/input/cat-dog/2.jpg", + "info" : "960585877c92d63911ba555ab3129d36" + } ] + } + +Status Codes +------------ + + + +.. _UploadSamplesJsonstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/sample_management/deleting_samples_in_batches.rst b/api-ref/source/data_management/sample_management/deleting_samples_in_batches.rst new file mode 100644 index 0000000..7b14c53 --- /dev/null +++ b/api-ref/source/data_management/sample_management/deleting_samples_in_batches.rst @@ -0,0 +1,137 @@ +Deleting Samples in Batches +=========================== + +Function +-------- + +This API is used to delete samples in batches. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/data-annotations/samples/delete + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _DeleteSamplesrequestDeleteSamplesReq: + +.. table:: **Table 2** Request body parameters + + +-----------------+-----------------+------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+==================+=============================================================================================================================================================================================================================================+ + | delete_source | No | Boolean | Whether to delete the source file. This field is valid for non-text datasets. (A text dataset is the entire text file. Therefore, deleting a piece of data from the text file does not affect the source text.) The options are as follows: | + | | | | | + | | | | - **false**: Do not delete the source file. (Default value) | + | | | | | + | | | | - **true**: Delete the source file. (Note: This operation may affect the dataset versions or other datasets that have used these files. As a result, the page display, training, or inference is abnormal.) | + +-----------------+-----------------+------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | samples | No | Array of strings | Sample ID list. | + +-----------------+-----------------+------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DeleteSamplesresponseDeleteSamplesResp: + +.. table:: **Table 3** Response body parameters + + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==========================================================================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------+ + | results | Array of `BatchResponse <#deletesamplesresponsebatchresponse>`__ objects | Response list for deleting a sample in batches. | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------+ + + + +.. _DeleteSamplesresponseBatchResponse: + +.. table:: **Table 4** BatchResponse + + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + +Example Requests +---------------- + +Deleting Samples in Batches + +.. code-block:: + + { + "samples" : [ "9cb9bc9b34bf53b6ec9a84998b1711bf", "9ea63ef78d8c9037c9bcb12b477821bf" ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "success" : true + } + +Status Codes +------------ + + + +.. _DeleteSamplesstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/sample_management/index.rst b/api-ref/source/data_management/sample_management/index.rst new file mode 100644 index 0000000..1f28dd5 --- /dev/null +++ b/api-ref/source/data_management/sample_management/index.rst @@ -0,0 +1,14 @@ +================= +Sample Management +================= + +.. toctree:: + :maxdepth: 1 + + querying_the_sample_list + adding_samples_in_batches + deleting_samples_in_batches + querying_details_about_a_sample + obtaining_sample_search_condition + querying_the_sample_list_of_a_team_labeling_task_by_page + querying_details_about_team_labeling_samples diff --git a/api-ref/source/data_management/sample_management/obtaining_sample_search_condition.rst b/api-ref/source/data_management/sample_management/obtaining_sample_search_condition.rst new file mode 100644 index 0000000..9903026 --- /dev/null +++ b/api-ref/source/data_management/sample_management/obtaining_sample_search_condition.rst @@ -0,0 +1,218 @@ +Obtaining Sample Search Condition +================================= + +Function +-------- + +This API is used to obtain sample search condition. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/data-annotations/search-condition + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListSearchresponseListSearchResp: + +.. table:: **Table 2** Response body parameters + + +-----------+-------------------------------------------------------+----------------------------------------+ + | Parameter | Type | Description | + +===========+=======================================================+========================================+ + | labelers | Array of strings | List of labeling team members. | + +-----------+-------------------------------------------------------+----------------------------------------+ + | labels | Array of `Label <#listsearchresponselabel>`__ objects | Label list. | + +-----------+-------------------------------------------------------+----------------------------------------+ + | metadata | Map> | Attribute key-value pair of a dataset. | + +-----------+-------------------------------------------------------+----------------------------------------+ + + + +.. _ListSearchresponseLabel: + +.. table:: **Table 3** Label + + +-----------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=========================================================================+==================================================================================================================================+ + | attributes | Array of `LabelAttribute <#listsearchresponselabelattribute>`__ objects | Multi-dimensional attribute of a label. For example, if the label is music, attributes such as style and artist may be included. | + +-----------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | property | `LabelProperty <#listsearchresponselabelproperty>`__ object | Basic attribute key-value pair of a label, such as color and shortcut keys. | + +-----------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListSearchresponseLabelAttribute: + +.. table:: **Table 4** LabelAttribute + + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===================================================================================+===================================================+ + | default_value | String | Default value of a label attribute. | + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + | id | String | Label attribute ID. | + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + | name | String | Label attribute name. | + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + | type | String | Label attribute type. The options are as follows: | + | | | | + | | | - **text**: text | + | | | | + | | | - **select**: single-choice drop-down list | + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + | values | Array of `LabelAttributeValue <#listsearchresponselabelattributevalue>`__ objects | List of label attribute values. | + +-----------------------+-----------------------------------------------------------------------------------+---------------------------------------------------+ + + + +.. _ListSearchresponseLabelAttributeValue: + +.. table:: **Table 5** LabelAttributeValue + + ========= ====== ========================= + Parameter Type Description + ========= ====== ========================= + id String Label attribute value ID. + value String Label attribute value. + ========= ====== ========================= + + + +.. _ListSearchresponseLabelProperty: + +.. table:: **Table 6** LabelProperty + + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==========================+=======================+================================================================================================================================================================================================================+ + | @modelarts:color | String | Default attribute: Label color, which is a hexadecimal code of the color. By default, this parameter is left blank. Example: **#FFFFF0**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:default_shape | String | Default attribute: Default shape of an object detection label (dedicated attribute). By default, this parameter is left blank. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from_type | String | Default attribute: Type of the head entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:rename_to | String | Default attribute: The new name of the label. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shortcut | String | Default attribute: Label shortcut key. By default, this parameter is left blank. For example: **D**. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to_type | String | Default attribute: Type of the tail entity in the triplet relationship label. This attribute must be specified when a relationship label is created. This parameter is used only for the text triplet dataset. | + +--------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Obtaining Sample Search Condition + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/data-annotations/search-condition + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "labels" : [ { + "name" : "Cat", + "type" : 0, + "property" : { + "@modelarts:color" : "#3399ff" + } + }, { + "name" : "Dog", + "type" : 0, + "property" : { + "@modelarts:color" : "#3399ff" + } + } ], + "metadata" : { }, + "labelers" : [ "human/test_123/test_123", "human/xxx@xxx.com", "human/xxx@xxx.com" ] + } + +Status Codes +------------ + + + +.. _ListSearchstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/sample_management/querying_details_about_a_sample.rst b/api-ref/source/data_management/sample_management/querying_details_about_a_sample.rst new file mode 100644 index 0000000..03eb555 --- /dev/null +++ b/api-ref/source/data_management/sample_management/querying_details_about_a_sample.rst @@ -0,0 +1,562 @@ +Querying Details About a Sample +=============================== + +Function +-------- + +Query details about a sample. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/data-annotations/samples/{sample_id} + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_id | Yes | String | Sample ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+======================================================+ + | locale | No | String | Language. The options are as follows: | + | | | | | + | | | | - **en-us**: English (default value) | + | | | | | + | | | | - **zh-cn**: Chinese | + +-----------------+-----------------+-----------------+------------------------------------------------------+ + | sample_state | No | String | Sample status. The options are as follows: | + | | | | | + | | | | - **ALL**: labeled | + | | | | | + | | | | - **NONE**: unlabeled | + | | | | | + | | | | - **UNCHECK**: pending acceptance | + | | | | | + | | | | - **ACCEPTED**: accepted | + | | | | | + | | | | - **REJECTED**: rejected | + | | | | | + | | | | - **UNREVIEWED**: pending review | + | | | | | + | | | | - **REVIEWED**: reviewed | + | | | | | + | | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | | + | | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | | + | | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | | + | | | | - **AUTO_ANNOTATION**: to be confirmed | + +-----------------+-----------------+-----------------+------------------------------------------------------+ + | worker_id | No | String | ID of a labeling team member. | + +-----------------+-----------------+-----------------+------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DescribeSampleresponseDescribeSampleResp: + +.. table:: **Table 3** Response body parameters + + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================================================================+========================================================================================================================================+ + | check_accept | Boolean | Whether the acceptance is passed, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: The acceptance is passed. | + | | | | + | | | - **false**: The acceptance is not passed. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_comment | String | Acceptance comment, which is used for team labeling. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_score | String | Acceptance score, which is used for team labeling. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_reasons | Array of strings | Reason for deleting a sample, which is used for healthcare. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | hard_details | Map | Details about difficulties, including description, causes, and suggestions of difficult problems. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labelers | Array of `Worker <#describesampleresponseworker>`__ objects | Labeling personnel list of sample assignment. The labelers record the team members to which the sample is allocated for team labeling. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labels | Array of `SampleLabel <#describesampleresponsesamplelabel>`__ objects | Sample label list. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SampleMetadata <#describesampleresponsesamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_accept | Boolean | Whether to accept the review, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: accepted | + | | | | + | | | - **false**: rejected | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_comment | String | Review comment, which is used for team labeling. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_score | String | Review score, which is used for team labeling. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_data | Array of strings | Sample data list. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Sample path. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_id | String | Sample ID. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Sample name. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_size | Long | Sample size or text length, in bytes. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_status | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | Long | Sample time, when OBS is last modified. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_type | Integer | Sample type. The options are as follows: | + | | | | + | | | - **0**: image | + | | | | + | | | - **1**: text | + | | | | + | | | - **2**: speech | + | | | | + | | | - **4**: table | + | | | | + | | | - **6**: video | + | | | | + | | | - **9**: custom format | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Comprehensive score, which is used for team labeling. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | source | String | Source address of sample data. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sub_sample_url | String | Subsample URL, which is used for healthcare. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member, which is used for team labeling. | + +-----------------------+-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeSampleresponseHardDetail: + +.. table:: **Table 4** HardDetail + + ========== ======= ==================== + Parameter Type Description + ========== ======= ==================== + alo_name String Alias. + id Integer Reason ID. + reason String Reason description. + suggestion String Handling suggestion. + ========== ======= ==================== + + + +.. _DescribeSampleresponseWorker: + +.. table:: **Table 5** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeSampleresponseSampleLabel: + +.. table:: **Table 6** SampleLabel + + +-----------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=============================================================================+=======================================================================================================================================+ + | annotated_by | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | + | | | - **human**: manual labeling | + | | | | + | | | - **auto**: automatic labeling | + +-----------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | Label ID. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | `SampleLabelProperty <#describesampleresponsesamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | Float | Confidence. | + +-----------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeSampleresponseSampleLabelProperty: + +.. table:: **Table 7** SampleLabelProperty + + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | + | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | + | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | + | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | + | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | + | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | + | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | + | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | + | | | - **0/false**: not a hard example | + | | | | + | | | - **1/true**: hard example | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeSampleresponseSampleMetadata: + +.. table:: **Table 8** SampleMetadata + + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About a Sample + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/data-annotations/samples/{sample_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "sample_id" : "012f99f3cf405860130b6ed2350c2228", + "sample_type" : 0, + "labels" : [ { + "name" : "car", + "type" : 0, + "property" : { } + } ], + "source" : "https://test-obs.obs.xxx.com:443/image/aifood/%E5%86%B0%E6%BF%80%E5%87%8C/36502.jpg?AccessKeyId=RciyO7RHmhNTfOZVryUH&Expires=1606297079&Signature=Ju4FYpEu973ii%2FAdUVLTfpLCTbg%3D", + "metadata" : { + "@modelarts:import_origin" : 0 + }, + "sample_time" : 1589190552106, + "sample_status" : "MANUAL_ANNOTATION", + "annotated_by" : "human/test_123/test_123", + "labelers" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "5d8d4033b428fed5ac158942c33940a2", + "role" : 0 + } ] + } + +Status Codes +------------ + + + +.. _DescribeSamplestatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/sample_management/querying_details_about_team_labeling_samples.rst b/api-ref/source/data_management/sample_management/querying_details_about_team_labeling_samples.rst new file mode 100644 index 0000000..b75e2f4 --- /dev/null +++ b/api-ref/source/data_management/sample_management/querying_details_about_team_labeling_samples.rst @@ -0,0 +1,561 @@ +Querying Details About Team Labeling Samples +============================================ + +Function +-------- + +This API is used to query details about team labeling samples. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/samples/{sample_id} + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_id | Yes | String | Sample ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+======================================================+ + | locale | No | String | Language. The options are as follows: | + | | | | | + | | | | - **en-us**: English (default value) | + | | | | | + | | | | - **zh-cn**: Chinese | + +-----------------+-----------------+-----------------+------------------------------------------------------+ + | sample_state | No | String | Sample status. The options are as follows: | + | | | | | + | | | | - **ALL**: labeled | + | | | | | + | | | | - **NONE**: unlabeled | + | | | | | + | | | | - **UNCHECK**: pending acceptance | + | | | | | + | | | | - **ACCEPTED**: accepted | + | | | | | + | | | | - **REJECTED**: rejected | + | | | | | + | | | | - **UNREVIEWED**: pending review | + | | | | | + | | | | - **REVIEWED**: reviewed | + | | | | | + | | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | | + | | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | | + | | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | | + | | | | - **AUTO_ANNOTATION**: to be confirmed | + +-----------------+-----------------+-----------------+------------------------------------------------------+ + | worker_id | No | String | ID of a labeling team member. | + +-----------------+-----------------+-----------------+------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DescribeWorkforceTaskSampleresponseDescribeSampleResp: + +.. table:: **Table 3** Response body parameters + + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+====================================================================================+========================================================================================================================================+ + | check_accept | Boolean | Whether the acceptance is passed, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: The acceptance is passed. | + | | | | + | | | - **false**: The acceptance is not passed. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_comment | String | Acceptance comment, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_score | String | Acceptance score, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_reasons | Array of strings | Reason for deleting a sample, which is used for healthcare. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | hard_details | Map | Details about difficulties, including description, causes, and suggestions of difficult problems. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labelers | Array of `Worker <#describeworkforcetasksampleresponseworker>`__ objects | Labeling personnel list of sample assignment. The labelers record the team members to which the sample is allocated for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labels | Array of `SampleLabel <#describeworkforcetasksampleresponsesamplelabel>`__ objects | Sample label list. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SampleMetadata <#describeworkforcetasksampleresponsesamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_accept | Boolean | Whether to accept the review, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: accepted | + | | | | + | | | - **false**: rejected | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_comment | String | Review comment, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_score | String | Review score, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_data | Array of strings | Sample data list. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Sample path. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_id | String | Sample ID. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Sample name. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_size | Long | Sample size or text length, in bytes. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_status | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | Long | Sample time, when OBS is last modified. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_type | Integer | Sample type. The options are as follows: | + | | | | + | | | - **0**: image | + | | | | + | | | - **1**: text | + | | | | + | | | - **2**: speech | + | | | | + | | | - **4**: table | + | | | | + | | | - **6**: video | + | | | | + | | | - **9**: custom format | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Comprehensive score, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | source | String | Source address of sample data. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sub_sample_url | String | Subsample URL, which is used for healthcare. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member, which is used for team labeling. | + +-----------------------+------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeWorkforceTaskSampleresponseHardDetail: + +.. table:: **Table 4** HardDetail + + ========== ======= ==================== + Parameter Type Description + ========== ======= ==================== + alo_name String Alias. + id Integer Reason ID. + reason String Reason description. + suggestion String Handling suggestion. + ========== ======= ==================== + + + +.. _DescribeWorkforceTaskSampleresponseWorker: + +.. table:: **Table 5** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeWorkforceTaskSampleresponseSampleLabel: + +.. table:: **Table 6** SampleLabel + + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==========================================================================================+=======================================================================================================================================+ + | annotated_by | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | + | | | - **human**: manual labeling | + | | | | + | | | - **auto**: automatic labeling | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | Label ID. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | `SampleLabelProperty <#describeworkforcetasksampleresponsesamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | Float | Confidence. | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeWorkforceTaskSampleresponseSampleLabelProperty: + +.. table:: **Table 7** SampleLabelProperty + + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | + | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | + | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | + | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | + | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | + | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | + | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | + | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | + | | | - **0/false**: not a hard example | + | | | | + | | | - **1/true**: hard example | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _DescribeWorkforceTaskSampleresponseSampleMetadata: + +.. table:: **Table 8** SampleMetadata + + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About Team Labeling Samples + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/samples/{sample_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "sample_id" : "26c6dd793d80d3274eb89349ec76d678", + "sample_type" : 0, + "labels" : [ ], + "source" : "https://test-obs.obs.xxx.com:443/detect/data/dataset-car-and-person/IMG_kitti_0000_000016.png?AccessKeyId=4D34AYDTK93HUY79NSD7&Expires=1606300437&x-obs-security-token=gQpjbi1ub3J0aC03jELficNKUP87aSTIhvsHQAvImcyVbXlYTrU2XJIc28F7kiXanJ3TyJV39iXl0yi5mzQ...", + "metadata" : { + "@modelarts:import_origin" : 0, + "@modelarts:size" : [ 1242, 375, 3 ] + }, + "sample_time" : 1598263639997, + "sample_status" : "UN_ANNOTATION", + "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", + "labelers" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "afdda13895bc66322ffbf36ae833bcf0", + "role" : 0 + } ] + } + +Status Codes +------------ + + + +.. _DescribeWorkforceTaskSamplestatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/sample_management/querying_the_sample_list.rst b/api-ref/source/data_management/sample_management/querying_the_sample_list.rst new file mode 100644 index 0000000..eb130bb --- /dev/null +++ b/api-ref/source/data_management/sample_management/querying_the_sample_list.rst @@ -0,0 +1,663 @@ +Querying the Sample List +======================== + +Function +-------- + +This API is used to query the sample list by page. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/data-annotations/samples + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+=================+=================+=====================================================================================================================================================================================================================================+ + | email | No | String | Email address of a labeling team member. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | high_score | No | String | Upper confidence limit. The default value is **1**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_name | No | String | Label name. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_type | No | Integer | Labeling type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet | + | | | | | + | | | | - **200**: sound classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **400**: table dataset | + | | | | | + | | | | - **600**: video labeling | + | | | | | + | | | | - **900**: custom format | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | locale | No | String | Language. The options are as follows: | + | | | | | + | | | | - **en-us**: English (default value) | + | | | | | + | | | | - **zh-cn**: Chinese | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | low_score | No | String | Lower confidence limit. The default value is **0**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting sequence of the query. The options are as follows: | + | | | | | + | | | | - **asc**: ascending order | + | | | | | + | | | | - **desc**: descending order (default value) | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | preview | No | Boolean | Whether to support preview. The options are as follows: | + | | | | | + | | | | - **true**: Preview is supported. | + | | | | | + | | | | - **false**: Preview is not supported. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | process_parameter | No | String | Image resizing setting, which is the same as the OBS resizing setting. For details, see . For example, **image/resize,m_lfit,h_200** indicates that the target image is resized proportionally and the height is set to 200 pixels. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | No | String | Sample status. The options are as follows: | + | | | | | + | | | | - **ALL**: labeled | + | | | | | + | | | | - **NONE**: unlabeled | + | | | | | + | | | | - **UNCHECK**: pending acceptance | + | | | | | + | | | | - **ACCEPTED**: accepted | + | | | | | + | | | | - **REJECTED**: rejected | + | | | | | + | | | | - **UNREVIEWED**: pending review | + | | | | | + | | | | - **REVIEWED**: reviewed | + | | | | | + | | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | | + | | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | | + | | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | | + | | | | - **AUTO_ANNOTATION**: to be confirmed | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_type | No | Integer | Sample file type. The options are as follows: | + | | | | | + | | | | - **0**: image | + | | | | | + | | | | - **1**: text | + | | | | | + | | | | - **2**: audio | + | | | | | + | | | | - **4**: table | + | | | | | + | | | | - **6**: video | + | | | | | + | | | | - **9**: custom format (default value) | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_conditions | No | String | Multi-dimensional search condition after URL encoding. The relationship between multiple search conditions is AND. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | No | String | Dataset version ID. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListSamplesresponseListSamplesResp: + +.. table:: **Table 3** Response body parameters + + +--------------+----------------------------------------------------------------------------------+--------------------+ + | Parameter | Type | Description | + +==============+==================================================================================+====================+ + | sample_count | Integer | Number of samples. | + +--------------+----------------------------------------------------------------------------------+--------------------+ + | samples | Array of `DescribeSampleResp <#listsamplesresponsedescribesampleresp>`__ objects | Sample list. | + +--------------+----------------------------------------------------------------------------------+--------------------+ + + + +.. _ListSamplesresponseDescribeSampleResp: + +.. table:: **Table 4** DescribeSampleResp + + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+====================================================================+========================================================================================================================================+ + | check_accept | Boolean | Whether the acceptance is passed, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: The acceptance is passed. | + | | | | + | | | - **false**: The acceptance is not passed. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_comment | String | Acceptance comment, which is used for team labeling. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_score | String | Acceptance score, which is used for team labeling. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_reasons | Array of strings | Reason for deleting a sample, which is used for healthcare. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | hard_details | Map | Details about difficulties, including description, causes, and suggestions of difficult problems. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labelers | Array of `Worker <#listsamplesresponseworker>`__ objects | Labeling personnel list of sample assignment. The labelers record the team members to which the sample is allocated for team labeling. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labels | Array of `SampleLabel <#listsamplesresponsesamplelabel>`__ objects | Sample label list. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SampleMetadata <#listsamplesresponsesamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_accept | Boolean | Whether to accept the review, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: accepted | + | | | | + | | | - **false**: rejected | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_comment | String | Review comment, which is used for team labeling. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_score | String | Review score, which is used for team labeling. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_data | Array of strings | Sample data list. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Sample path. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_id | String | Sample ID. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Sample name. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_size | Long | Sample size or text length, in bytes. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_status | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | Long | Sample time, when OBS is last modified. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_type | Integer | Sample type. The options are as follows: | + | | | | + | | | - **0**: image | + | | | | + | | | - **1**: text | + | | | | + | | | - **2**: speech | + | | | | + | | | - **4**: table | + | | | | + | | | - **6**: video | + | | | | + | | | - **9**: custom format | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Comprehensive score, which is used for team labeling. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | source | String | Source address of sample data. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sub_sample_url | String | Subsample URL, which is used for healthcare. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member, which is used for team labeling. | + +-----------------------+--------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListSamplesresponseHardDetail: + +.. table:: **Table 5** HardDetail + + ========== ======= ==================== + Parameter Type Description + ========== ======= ==================== + alo_name String Alias. + id Integer Reason ID. + reason String Reason description. + suggestion String Handling suggestion. + ========== ======= ==================== + + + +.. _ListSamplesresponseWorker: + +.. table:: **Table 6** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListSamplesresponseSampleLabel: + +.. table:: **Table 7** SampleLabel + + +-----------------------+--------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==========================================================================+=======================================================================================================================================+ + | annotated_by | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | + | | | - **human**: manual labeling | + | | | | + | | | - **auto**: automatic labeling | + +-----------------------+--------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | Label ID. | + +-----------------------+--------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+--------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | `SampleLabelProperty <#listsamplesresponsesamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------------+--------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | Float | Confidence. | + +-----------------------+--------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+--------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListSamplesresponseSampleLabelProperty: + +.. table:: **Table 8** SampleLabelProperty + + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | + | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | + | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | + | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | + | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | + | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | + | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | + | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | + | | | - **0/false**: not a hard example | + | | | | + | | | - **1/true**: hard example | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListSamplesresponseSampleMetadata: + +.. table:: **Table 9** SampleMetadata + + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the Sample List by Page + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/data-annotations/samples + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "sample_count" : 2, + "samples" : [ { + "sample_id" : "012f99f3cf405860130b6ed2350c2228", + "sample_type" : 0, + "labels" : [ { + "name" : "car", + "type" : 0, + "property" : { } + } ], + "source" : "https://test-obs.obs.xxx.com:443/image/aifood/%E5%86%B0%E6%BF%80%E5%87%8C/36502.jpg?AccessKeyId=RciyO7RHmhNTfOZVryUH&Expires=1606296688&x-image-process=image%2Fresize%2Cm_lfit%2Ch_200&Signature=icyvHhFew9vnmy3zh1uZMP15Mbg%3D", + "metadata" : { + "@modelarts:import_origin" : 0 + }, + "sample_time" : 1589190552106, + "sample_status" : "MANUAL_ANNOTATION", + "annotated_by" : "human/test_123/test_123", + "labelers" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "5d8d4033b428fed5ac158942c33940a2", + "role" : 0 + } ] + }, { + "sample_id" : "0192f3acfb000666033a0f85c21577c7", + "sample_type" : 0, + "labels" : [ { + "name" : "car", + "type" : 0, + "property" : { } + } ], + "source" : "https://test-obs.obs.xxx.com:443/image/aifood/%E5%86%B0%E6%BF%80%E5%87%8C/36139.jpg?AccessKeyId=RciyO7RHmhNTfOZVryUH&Expires=1606296688&x-image-process=image%2Fresize%2Cm_lfit%2Ch_200&Signature=RRr9r2cghLCXk%2B0%2BfHtYJi8eZ4k%3D", + "metadata" : { + "@modelarts:import_origin" : 0 + }, + "sample_time" : 1589190543327, + "sample_status" : "MANUAL_ANNOTATION", + "annotated_by" : "human/test_123/test_123", + "labelers" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "a2abd3f27b4e92c593c15282f8b6bd29", + "role" : 0 + } ] + } ] + } + +Status Codes +------------ + + + +.. _ListSamplesstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/sample_management/querying_the_sample_list_of_a_team_labeling_task_by_page.rst b/api-ref/source/data_management/sample_management/querying_the_sample_list_of_a_team_labeling_task_by_page.rst new file mode 100644 index 0000000..8de82a4 --- /dev/null +++ b/api-ref/source/data_management/sample_management/querying_the_sample_list_of_a_team_labeling_task_by_page.rst @@ -0,0 +1,625 @@ +Querying the Sample List of a Team Labeling Task by Page +======================================================== + +Function +-------- + +This API is used to query the sample list of a team labeling task by page. + +URI +--- + +GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/samples + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a team labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+=================+=================+=====================================================================================================================================================================================================================================+ + | label_name | No | String | Label name. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | label_type | No | Integer | Labeling type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet | + | | | | | + | | | | - **200**: sound classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **400**: table dataset | + | | | | | + | | | | - **600**: video labeling | + | | | | | + | | | | - **900**: custom format | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | limit | No | Integer | Maximum number of records returned on each page. The value ranges from 1 to 100. The default value is **10**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | locale | No | String | Language. The options are as follows: | + | | | | | + | | | | - **en-us**: English (default value) | + | | | | | + | | | | - **zh-cn**: Chinese | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. The default value is **0**. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | process_parameter | No | String | Image resizing setting, which is the same as the OBS resizing setting. For details, see . For example, **image/resize,m_lfit,h_200** indicates that the target image is resized proportionally and the height is set to 200 pixels. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sample_state | No | String | Sample status. The options are as follows: | + | | | | | + | | | | - **ALL**: labeled | + | | | | | + | | | | - **NONE**: unlabeled | + | | | | | + | | | | - **UNCHECK**: pending acceptance | + | | | | | + | | | | - **ACCEPTED**: accepted | + | | | | | + | | | | - **REJECTED**: rejected | + | | | | | + | | | | - **UNREVIEWED**: pending review | + | | | | | + | | | | - **REVIEWED**: reviewed | + | | | | | + | | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | | + | | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | | + | | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | | + | | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | | + | | | | - **AUTO_ANNOTATION**: to be confirmed | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_conditions | No | String | Multi-dimensional search condition after URL encoding. The relationship between multiple search conditions is AND. | + +-------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListWorkforceTaskSamplesresponseListSamplesResp: + +.. table:: **Table 3** Response body parameters + + +--------------+-----------------------------------------------------------------------------------------------+--------------------+ + | Parameter | Type | Description | + +==============+===============================================================================================+====================+ + | sample_count | Integer | Number of samples. | + +--------------+-----------------------------------------------------------------------------------------------+--------------------+ + | samples | Array of `DescribeSampleResp <#listworkforcetasksamplesresponsedescribesampleresp>`__ objects | Sample list. | + +--------------+-----------------------------------------------------------------------------------------------+--------------------+ + + + +.. _ListWorkforceTaskSamplesresponseDescribeSampleResp: + +.. table:: **Table 4** DescribeSampleResp + + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=================================================================================+========================================================================================================================================+ + | check_accept | Boolean | Whether the acceptance is passed, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: The acceptance is passed. | + | | | | + | | | - **false**: The acceptance is not passed. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_comment | String | Acceptance comment, which is used for team labeling. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | check_score | String | Acceptance score, which is used for team labeling. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | deletion_reasons | Array of strings | Reason for deleting a sample, which is used for healthcare. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | hard_details | Map | Details about difficulties, including description, causes, and suggestions of difficult problems. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labelers | Array of `Worker <#listworkforcetasksamplesresponseworker>`__ objects | Labeling personnel list of sample assignment. The labelers record the team members to which the sample is allocated for team labeling. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | labels | Array of `SampleLabel <#listworkforcetasksamplesresponsesamplelabel>`__ objects | Sample label list. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | metadata | `SampleMetadata <#listworkforcetasksamplesresponsesamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_accept | Boolean | Whether to accept the review, which is used for team labeling. The options are as follows: | + | | | | + | | | - **true**: accepted | + | | | | + | | | - **false**: rejected | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_comment | String | Review comment, which is used for team labeling. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | review_score | String | Review score, which is used for team labeling. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_data | Array of strings | Sample data list. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_dir | String | Sample path. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_id | String | Sample ID. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_name | String | Sample name. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_size | Long | Sample size or text length, in bytes. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_status | String | Sample status. The options are as follows: | + | | | | + | | | - **ALL**: labeled | + | | | | + | | | - **NONE**: unlabeled | + | | | | + | | | - **UNCHECK**: pending acceptance | + | | | | + | | | - **ACCEPTED**: accepted | + | | | | + | | | - **REJECTED**: rejected | + | | | | + | | | - **UNREVIEWED**: pending review | + | | | | + | | | - **REVIEWED**: reviewed | + | | | | + | | | - **WORKFORCE_SAMPLED**: sampled | + | | | | + | | | - **WORKFORCE_SAMPLED_UNCHECK**: sampling unchecked | + | | | | + | | | - **WORKFORCE_SAMPLED_CHECKED**: sampling checked | + | | | | + | | | - **WORKFORCE_SAMPLED_ACCEPTED**: sampling accepted | + | | | | + | | | - **WORKFORCE_SAMPLED_REJECTED**: sampling rejected | + | | | | + | | | - **AUTO_ANNOTATION**: to be confirmed | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_time | Long | Sample time, when OBS is last modified. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sample_type | Integer | Sample type. The options are as follows: | + | | | | + | | | - **0**: image | + | | | | + | | | - **1**: text | + | | | | + | | | - **2**: speech | + | | | | + | | | - **4**: table | + | | | | + | | | - **6**: video | + | | | | + | | | - **9**: custom format | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | score | String | Comprehensive score, which is used for team labeling. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | source | String | Source address of sample data. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | sub_sample_url | String | Subsample URL, which is used for healthcare. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member, which is used for team labeling. | + +-----------------------+---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTaskSamplesresponseHardDetail: + +.. table:: **Table 5** HardDetail + + ========== ======= ==================== + Parameter Type Description + ========== ======= ==================== + alo_name String Alias. + id Integer Reason ID. + reason String Reason description. + suggestion String Handling suggestion. + ========== ======= ==================== + + + +.. _ListWorkforceTaskSamplesresponseWorker: + +.. table:: **Table 6** Worker + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================+ + | create_time | Long | Creation time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | email | String | Email address of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | role | Integer | Role. The options are as follows: | + | | | | + | | | - **0**: labeling personnel | + | | | | + | | | - **1**: reviewer | + | | | | + | | | - **2**: team administrator | + | | | | + | | | - **3**: dataset owner | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Current login status of a labeling team member. The options are as follows: | + | | | | + | | | - **0**: The invitation email has not been sent. | + | | | | + | | | - **1**: The invitation email has been sent but the user has not logged in. | + | | | | + | | | - **2**: The user has logged in. | + | | | | + | | | - **3**: The labeling team member has been deleted. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Long | Update time. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_id | String | ID of a labeling team member. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_id | String | ID of a labeling team. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTaskSamplesresponseSampleLabel: + +.. table:: **Table 7** SampleLabel + + +-----------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================================================================================+=======================================================================================================================================+ + | annotated_by | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | + | | | - **human**: manual labeling | + | | | | + | | | - **auto**: automatic labeling | + +-----------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | String | Label ID. | + +-----------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Label name. | + +-----------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | `SampleLabelProperty <#listworkforcetasksamplesresponsesamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | Float | Confidence. | + +-----------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | Integer | Label type. The options are as follows: | + | | | | + | | | - **0**: image classification | + | | | | + | | | - **1**: object detection | + | | | | + | | | - **100**: text classification | + | | | | + | | | - **101**: named entity recognition | + | | | | + | | | - **102**: text triplet relationship | + | | | | + | | | - **103**: text triplet entity | + | | | | + | | | - **200**: speech classification | + | | | | + | | | - **201**: speech content | + | | | | + | | | - **202**: speech paragraph labeling | + | | | | + | | | - **600**: video classification | + +-----------------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTaskSamplesresponseSampleLabelProperty: + +.. table:: **Table 8** SampleLabelProperty + + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | + | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | + | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | + | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | + | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | + | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | + | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | + | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | + | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | + | | | - **0/false**: not a hard example | + | | | | + | | | - **1/true**: hard example | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | + | | | - **bndbox**: rectangle | + | | | | + | | | - **polygon**: polygon | + | | | | + | | | - **circle**: circle | + | | | | + | | | - **line**: straight line | + | | | | + | | | - **dashed**: dotted line | + | | | | + | | | - **point**: point | + | | | | + | | | - **polyline**: polyline | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ListWorkforceTaskSamplesresponseSampleMetadata: + +.. table:: **Table 9** SampleMetadata + + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: non-hard sample | + | | | | + | | | - **1**: hard sample | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | + | | | - **0**: No target objects are identified. | + | | | | + | | | - **1**: The confidence is low. | + | | | | + | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | + | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | + | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | + | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | + | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | + | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | + | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | + | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | + | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | + | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | + | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | + | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | + | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | + | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | + | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | + | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | + | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | + | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | + | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | + | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | + | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | + | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying the Sample List of a Team Labeling Task by Page + +.. code-block:: + + GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/samples + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "sample_count" : 2, + "samples" : [ { + "sample_id" : "26c6dd793d80d3274eb89349ec76d678", + "sample_type" : 0, + "labels" : [ ], + "source" : "https://test-obs.obs.xxx.com:443/detect/data/dataset-car-and-person/IMG_kitti_0000_000016.png?AccessKeyId=P19W9X830R1Z39P5X5M5&Expires=1606300137&x-obs-security-token=gQpjbi1ub3J0aC03jKj8N6gtS4VsdTTW3QFoHMtpMoFLtCa6W_J4DxT0nYIfx...", + "metadata" : { + "@modelarts:import_origin" : 0, + "@modelarts:size" : [ 1242, 375, 3 ] + }, + "sample_time" : 1598263639997, + "sample_status" : "UN_ANNOTATION", + "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", + "labelers" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "afdda13895bc66322ffbf36ae833bcf0", + "role" : 0 + } ] + }, { + "sample_id" : "2971815bbb11a462161b48dddf19344f", + "sample_type" : 0, + "labels" : [ ], + "source" : "https://test-obs.obs.xxx.com:443/detect/data/dataset-car-and-person/IMG_kitti_0000_000011.png?AccessKeyId=P19W9X830R1Z39P5X5M5&Expires=1606300137&x-obs-security-token=gQpjbi1ub3J0aC03jKj8N6gtS4VsdTTW3QFoHMtpMoFLtC...", + "metadata" : { + "@modelarts:import_origin" : 0, + "@modelarts:size" : [ 1242, 375, 3 ] + }, + "sample_time" : 1598263639997, + "sample_status" : "UN_ANNOTATION", + "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", + "labelers" : [ { + "email" : "xxx@xxx.com", + "worker_id" : "305595e1901a526017d2e11f3ab0ffe1", + "role" : 0 + } ] + } ] + } + +Status Codes +------------ + + + +.. _ListWorkforceTaskSamplesstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/team_labeling_process_management/index.rst b/api-ref/source/data_management/team_labeling_process_management/index.rst new file mode 100644 index 0000000..aa17825 --- /dev/null +++ b/api-ref/source/data_management/team_labeling_process_management/index.rst @@ -0,0 +1,10 @@ +================================ +Team Labeling Process Management +================================ + +.. toctree:: + :maxdepth: 1 + + submitting_sample_review_comments_of_an_acceptance_task + reviewing_team_labeling_results + updating_labels_of_team_labeling_samples_in_batches diff --git a/api-ref/source/data_management/team_labeling_process_management/reviewing_team_labeling_results.rst b/api-ref/source/data_management/team_labeling_process_management/reviewing_team_labeling_results.rst new file mode 100644 index 0000000..91aaa70 --- /dev/null +++ b/api-ref/source/data_management/team_labeling_process_management/reviewing_team_labeling_results.rst @@ -0,0 +1,119 @@ +Reviewing Team Labeling Results +=============================== + +Function +-------- + +This API is used to review team labeling results. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/review + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _ReviewSamplesrequestReviewSamplesReq: + +.. table:: **Table 2** Request body parameters + + +-----------+-----------+-------------------------------------------------------------------------+----------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+=========================================================================+======================+ + | comments | No | Array of `SampleComment <#reviewsamplesrequestsamplecomment>`__ objects | Review comment list. | + +-----------+-----------+-------------------------------------------------------------------------+----------------------+ + + + +.. _ReviewSamplesrequestSampleComment: + +.. table:: **Table 3** SampleComment + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=============================================================================================+ + | accept | Yes | Boolean | Whether the submitted sample review comments are passed. The options are as follows: | + | | | | | + | | | | - **true**: passed | + | | | | | + | | | | - **false**: not passed | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + | comment | No | String | Review comment, which contains 0 to 256 characters, excluding special characters (!<>=&"'). | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + | sample_id | No | String | Sample ID. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + | score | No | String | Review score, whose value can be **A**, **B**, **C**, or **D**, in descending order. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + | worker_id | No | String | ID of a labeling team member. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Reviewing Team Labeling Results + +.. code-block:: + + { + "comments" : [ { + "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", + "sample_id" : "0d43f9811d3808a3146c673257d4a1dbhh", + "accept" : true, + "comment" : "", + "score" : "A" + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _ReviewSamplesstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/team_labeling_process_management/submitting_sample_review_comments_of_an_acceptance_task.rst b/api-ref/source/data_management/team_labeling_process_management/submitting_sample_review_comments_of_an_acceptance_task.rst new file mode 100644 index 0000000..2f693f0 --- /dev/null +++ b/api-ref/source/data_management/team_labeling_process_management/submitting_sample_review_comments_of_an_acceptance_task.rst @@ -0,0 +1,119 @@ +Submitting Sample Review Comments of an Acceptance Task +======================================================= + +Function +-------- + +This API is used to submit sample review comments of an acceptance task. + +URI +--- + +POST /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/acceptance/batch-comment + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _AcceptSamplesrequestAcceptSamplesReq: + +.. table:: **Table 2** Request body parameters + + +-----------+-----------+-------------------------------------------------------------------------+----------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+=========================================================================+======================+ + | comments | No | Array of `SampleComment <#acceptsamplesrequestsamplecomment>`__ objects | Review comment list. | + +-----------+-----------+-------------------------------------------------------------------------+----------------------+ + + + +.. _AcceptSamplesrequestSampleComment: + +.. table:: **Table 3** SampleComment + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=============================================================================================+ + | accept | Yes | Boolean | Whether the submitted sample review comments are passed. The options are as follows: | + | | | | | + | | | | - **true**: passed | + | | | | | + | | | | - **false**: not passed | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + | comment | No | String | Review comment, which contains 0 to 256 characters, excluding special characters (!<>=&"'). | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + | sample_id | No | String | Sample ID. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + | score | No | String | Review score, whose value can be **A**, **B**, **C**, or **D**, in descending order. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + | worker_id | No | String | ID of a labeling team member. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +None + +Example Requests +---------------- + +Submitting Sample Review Comments of an Acceptance Task + +.. code-block:: + + { + "comments" : [ { + "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", + "sample_id" : "09ac49d5b06385849c8769fdcf0f6d60", + "accept" : true, + "comment" : "", + "score" : "A" + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { } + +Status Codes +------------ + + + +.. _AcceptSamplesstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/data_management/team_labeling_process_management/updating_labels_of_team_labeling_samples_in_batches.rst b/api-ref/source/data_management/team_labeling_process_management/updating_labels_of_team_labeling_samples_in_batches.rst new file mode 100644 index 0000000..605a72d --- /dev/null +++ b/api-ref/source/data_management/team_labeling_process_management/updating_labels_of_team_labeling_samples_in_batches.rst @@ -0,0 +1,455 @@ +Updating Labels of Team Labeling Samples in Batches +=================================================== + +Function +-------- + +This API is used to update labels of team labeling samples in batches. + +URI +--- + +PUT /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/samples + +.. table:: **Table 1** Path parameters + + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+===========+========+============================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workforce_task_id | Yes | String | ID of a labeling task. | + +-------------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateWorkforceTaskSamplesrequestUpdateSamplesReq: + +.. table:: **Table 2** Request body parameters + + +-----------+-----------+------------------------------------------------------------------------------------+------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+====================================================================================+==========================================+ + | email | No | String | Email address of a labeling team member. | + +-----------+-----------+------------------------------------------------------------------------------------+------------------------------------------+ + | samples | No | Array of `SampleLabels <#updateworkforcetasksamplesrequestsamplelabels>`__ objects | Updated sample list. | + +-----------+-----------+------------------------------------------------------------------------------------+------------------------------------------+ + + + +.. _UpdateWorkforceTaskSamplesrequestSampleLabels: + +.. table:: **Table 3** SampleLabels + + +-----------------+-----------------+----------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+==================================================================================+====================================================================================+ + | labels | No | Array of `SampleLabel <#updateworkforcetasksamplesrequestsamplelabel>`__ objects | Sample label list. If this parameter is left blank, all sample labels are deleted. | + +-----------------+-----------------+----------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | metadata | No | `SampleMetadata <#updateworkforcetasksamplesrequestsamplemetadata>`__ object | Key-value pair of the sample **metadata** attribute. | + +-----------------+-----------------+----------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_id | No | String | Sample ID. | + +-----------------+-----------------+----------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_type | No | Integer | Sample type. The options are as follows: | + | | | | | + | | | | - **0**: image | + | | | | | + | | | | - **1**: text | + | | | | | + | | | | - **2**: speech | + | | | | | + | | | | - **4**: table | + | | | | | + | | | | - **6**: video | + | | | | | + | | | | - **9**: custom format | + +-----------------+-----------------+----------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | sample_usage | No | String | Sample usage. The options are as follows: | + | | | | | + | | | | - **TRAIN**: training | + | | | | | + | | | | - **EVAL**: evaluation | + | | | | | + | | | | - **TEST**: test | + | | | | | + | | | | - **INFERENCE**: inference | + +-----------------+-----------------+----------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | source | No | String | Source address of sample data. | + +-----------------+-----------------+----------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + | worker_id | No | String | ID of a labeling team member. | + +-----------------+-----------------+----------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + + + +.. _UpdateWorkforceTaskSamplesrequestSampleLabel: + +.. table:: **Table 4** SampleLabel + + +-----------------+-----------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+========================================================================================+=======================================================================================================================================+ + | annotated_by | No | String | Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. The options are as follows: | + | | | | | + | | | | - **human**: manual labeling | + | | | | | + | | | | - **auto**: automatic labeling | + +-----------------+-----------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | id | No | String | Label ID. | + +-----------------+-----------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Label name. | + +-----------------+-----------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | property | No | `SampleLabelProperty <#updateworkforcetasksamplesrequestsamplelabelproperty>`__ object | Attribute key-value pair of the sample label, such as the object shape and shape feature. | + +-----------------+-----------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | score | No | Float | Confidence. | + +-----------------+-----------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | Integer | Label type. The options are as follows: | + | | | | | + | | | | - **0**: image classification | + | | | | | + | | | | - **1**: object detection | + | | | | | + | | | | - **100**: text classification | + | | | | | + | | | | - **101**: named entity recognition | + | | | | | + | | | | - **102**: text triplet relationship | + | | | | | + | | | | - **103**: text triplet entity | + | | | | | + | | | | - **200**: speech classification | + | | | | | + | | | | - **201**: speech content | + | | | | | + | | | | - **202**: speech paragraph labeling | + | | | | | + | | | | - **600**: video classification | + +-----------------+-----------------+----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateWorkforceTaskSamplesrequestSampleLabelProperty: + +.. table:: **Table 5** SampleLabelProperty + + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============================+=================+=================+===========================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:content | No | String | Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_index | No | Integer | End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of **end_index**. Examples are as follows. | + | | | | | + | | | | - If the text content is "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", the **start_index** and **end_index** values of "Barack Hussein Obama II" are **0** and **23**, respectively. | + | | | | | + | | | | - If the text content is "By the end of 2018, the company has more than 100 employees.", the **start_index** and **end_index** values of "By the end of 2018" are **0** and **18**, respectively. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:end_time | No | String | Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:feature | No | Object | Shape feature, which is a default attribute dedicated to the object detection label, with type of **List**. The upper left corner of an image is used as the coordinate origin **[0,0]**. Each coordinate point is represented by *[x, y]*. *x* indicates the horizontal coordinate, and *y* indicates the vertical coordinate (both *x* and *y* are greater than or equal to 0). The format of each shape is as follows: | + | | | | | + | | | | - **bndbox**: consists of two points, for example, **[[0,10],[50,95]]**. The first point is located at the upper left corner of the rectangle and the second point is located at the lower right corner of the rectangle. That is, the X coordinate of the first point must be smaller than that of the second point, and the Y coordinate of the second point must be smaller than that of the first point. | + | | | | | + | | | | - **polygon**: consists of multiple points that are connected in sequence to form a polygon, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + | | | | | + | | | | - **circle**: consists of the center point and radius, for example, **[[100,100],[50]]**. | + | | | | | + | | | | - **line**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | | + | | | | - **dashed**: consists of two points, for example, **[[0,100],[50,95]]**. The first point is the start point, and the second point is the end point. | + | | | | | + | | | | - **point**: consists of one point, for example, **[[0,100]]**. | + | | | | | + | | | | - **polyline**: consists of multiple points, for example, **[[0,100],[50,95],[10,60],[500,400]]**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:from | No | String | ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard | No | String | Sample labeled as a hard sample or not, which is a default attribute. Options: | + | | | | | + | | | | - **0/false**: not a hard example | + | | | | | + | | | | - **1/true**: hard example | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | No | String | Coefficient of difficulty of each label level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | No | String | Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, **3-20-21-19**. The options are as follows: | + | | | | | + | | | | - **0**: No target objects are identified. | + | | | | | + | | | | - **1**: The confidence is low. | + | | | | | + | | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | | + | | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | | + | | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | | + | | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | | + | | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:shape | No | String | Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. The options are as follows: | + | | | | | + | | | | - **bndbox**: rectangle | + | | | | | + | | | | - **polygon**: polygon | + | | | | | + | | | | - **circle**: circle | + | | | | | + | | | | - **line**: straight line | + | | | | | + | | | | - **dashed**: dotted line | + | | | | | + | | | | - **point**: point | + | | | | | + | | | | - **polyline**: polyline | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:source | No | String | Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_index | No | Integer | Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of **start_index**. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:start_time | No | String | Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of **hh:mm:ss.SSS**. (**hh** indicates hour; **mm** indicates minute; **ss** indicates second; and **SSS** indicates millisecond.) | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:to | No | String | ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. | + +-----------------------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateWorkforceTaskSamplesrequestSampleMetadata: + +.. table:: **Table 6** SampleMetadata + + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============================+=================+===================+====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | @modelarts:hard | No | Double | Whether the sample is labeled as a hard sample, which is a default attribute. The options are as follows: | + | | | | | + | | | | - **0**: non-hard sample | + | | | | | + | | | | - **1**: hard sample | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_coefficient | No | Double | Coefficient of difficulty of each sample level, which is a default attribute. The value range is **[0,1]**. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:hard_reasons | No | Array of integers | ID of a hard sample reason, which is a default attribute. The options are as follows: | + | | | | | + | | | | - **0**: No target objects are identified. | + | | | | | + | | | | - **1**: The confidence is low. | + | | | | | + | | | | - **2**: The clustering result based on the training dataset is inconsistent with the prediction result. | + | | | | | + | | | | - **3**: The prediction result is greatly different from the data of the same type in the training dataset. | + | | | | | + | | | | - **4**: The prediction results of multiple consecutive similar images are inconsistent. | + | | | | | + | | | | - **5**: There is a large offset between the image resolution and the feature distribution of the training dataset. | + | | | | | + | | | | - **6**: There is a large offset between the aspect ratio of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **7**: There is a large offset between the brightness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **8**: There is a large offset between the saturation of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **9**: There is a large offset between the color richness of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **10**: There is a large offset between the definition of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **11**: There is a large offset between the number of frames of the image and the feature distribution of the training dataset. | + | | | | | + | | | | - **12**: There is a large offset between the standard deviation of area of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **13**: There is a large offset between the aspect ratio of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **14**: There is a large offset between the area portion of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **15**: There is a large offset between the edge of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **16**: There is a large offset between the brightness of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **17**: There is a large offset between the definition of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **18**: There is a large offset between the stack of image frames and the feature distribution of the training dataset. | + | | | | | + | | | | - **19**: The data enhancement result based on GaussianBlur is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **20**: The data enhancement result based on fliplr is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **21**: The data enhancement result based on Crop is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **22**: The data enhancement result based on flipud is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **23**: The data enhancement result based on scale is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **24**: The data enhancement result based on translate is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **25**: The data enhancement result based on shear is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **26**: The data enhancement result based on superpixels is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **27**: The data enhancement result based on sharpen is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **28**: The data enhancement result based on add is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **29**: The data enhancement result based on invert is inconsistent with the prediction result of the original image. | + | | | | | + | | | | - **30**: The data is predicted to be abnormal. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | @modelarts:size | No | Array of objects | Image size (width, height, and depth of the image), which is a default attribute, with type of **List**. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is **3**). For example, **[100,200,3]** and **[100,200]** are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. | + +-----------------------------+-----------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _UpdateWorkforceTaskSamplesresponseUpdateSamplesResp: + +.. table:: **Table 7** Response body parameters + + +-----------------------+---------------------------------------------------------------------------------------+------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================================================================================+==================================================================+ + | error_code | String | Error code. | + +-----------------------+---------------------------------------------------------------------------------------+------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+---------------------------------------------------------------------------------------+------------------------------------------------------------------+ + | results | Array of `BatchResponse <#updateworkforcetasksamplesresponsebatchresponse>`__ objects | Response list for updating sample labels in batches. | + +-----------------------+---------------------------------------------------------------------------------------+------------------------------------------------------------------+ + | success | Boolean | Whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: successful | + | | | | + | | | - **false**: failed | + +-----------------------+---------------------------------------------------------------------------------------+------------------------------------------------------------------+ + + + +.. _UpdateWorkforceTaskSamplesresponseBatchResponse: + +.. table:: **Table 8** BatchResponse + + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================+ + | error_code | String | Error code. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | error_msg | String | Error message. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + | success | Boolean | Check whether the operation is successful. The options are as follows: | + | | | | + | | | - **true**: The operation is successful. | + | | | | + | | | - **false**: The operation is failed. | + +-----------------------+-----------------------+------------------------------------------------------------------------+ + +Example Requests +---------------- + +Updating Labels of Team Labeling Samples in Batches + +.. code-block:: + + { + "samples" : [ { + "sample_id" : "0a0939d6d3c48a3d2a2619245943ac21", + "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", + "labels" : [ { + "name" : "tulips" + } ] + }, { + "sample_id" : "0e1b5a16a5a577ee53aeb34278a4b3e7", + "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f", + "labels" : [ { + "name" : "tulips" + } ] + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "success" : true + } + +Status Codes +------------ + + + +.. _UpdateWorkforceTaskSamplesstatuscode: + +=========== ============ +Status Code Description +=========== ============ +200 OK +401 Unauthorized +403 Forbidden +404 Not Found +=========== ============ + +Error Codes +----------- + +See `Error Codes <../../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/devenviron/creating_a_development_environment_instance.rst b/api-ref/source/devenviron/creating_a_development_environment_instance.rst new file mode 100644 index 0000000..b43517b --- /dev/null +++ b/api-ref/source/devenviron/creating_a_development_environment_instance.rst @@ -0,0 +1,738 @@ +Creating a Development Environment Instance +=========================================== + +Function +-------- + +This API is used to create a development environment instance for code development. + +Calling this API is an asynchronous operation. The job status can be obtained by calling the API described in `Querying the Details About a Development Environment Instance <../devenviron/querying_the_details_about_a_development_environment_instance.html#modelarts030112>`__. + +URI +--- + +POST /v1/{project_id}/demanager/instances + +`Table 1 <#modelarts030110enustopic0136223949table569625523811>`__ describes the required parameters. + +.. _modelarts030110enustopic0136223949table569625523811: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030110enustopic0136223949table2542581515>`__ describes the request parameters. + +.. _modelarts030110enustopic0136223949table2542581515: + +.. table:: **Table 2** Parameters + + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=============================================================================================================================================================================+ + | name | Yes | String | Instance name, which contains a maximum of 64 characters. | + | | | | | + | | | | The value can contain letters, digits, hyphens (-), and underscores (_). | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | profile_id | Yes | String | Configuration ID. The options are as follows: | + | | | | | + | | | | - Ascend-Power-Engine 1.0(python3) | + | | | | - Multi-Engine 1.0 (python3)-cpu | + | | | | - Multi-Engine 1.0 (python3)-gpu | + | | | | - Multi-Engine 2.0 (python3) | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Instance description. The value contains a maximum of 512 characters and cannot contain the following special characters: &<>"'/. By default, this parameter is left blank. | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | Yes | String | Instance flavor. The options are as follows: | + | | | | | + | | | | - modelarts.kat1.xlarge | + | | | | - modelarts.vm.cpu.2u | + | | | | - modelarts.vm.cpu.8u | + | | | | - modelarts.vm.gpu.v100 | + | | | | | + | | | | The preceding flavors are for reference only. The actual flavors depend on the region. If you need to use other flavors, contact the administrator to change the flavors. | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec | Yes | Object | Instance definition. Only **Notebook** is supported. For example, see `Table 3 <#modelarts030110enustopic0136223949table1661540121718>`__. | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace | No | Object | Workspace. The default workspace ID is **0**. For details, see `Table 7 <#modelarts030110enustopic0136223949table195831523711>`__. | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool | No | Object | Resource pool. For details, see `Table 8 <#modelarts030110enustopic0136223949requestpoolspec>`__. | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ai_project | No | Object | AI project. For details, see `Table 10 <#modelarts030110enustopic0136223949requestaiproject>`__. | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table1661540121718: + +.. table:: **Table 3** **notebook** parameters + + +----------------+-----------+--------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +================+===========+====================+=================================================================================================================================================================================================================+ + | storage | Yes | Object | Storage path. For details, see `Table 4 <#modelarts030110enustopic0136223949table14531721311>`__. | + +----------------+-----------+--------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | extend_storage | No | Array | Extended storage list. For details, see `Table 4 <#modelarts030110enustopic0136223949table14531721311>`__. Extended storage supports only **obsfs** and is available only for certain dedicated resource pools. | + +----------------+-----------+--------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | auto_stop | No | Object | Auto stop parameter. For details, see `Table 6 <#modelarts030110enustopic0136223949table756291982911>`__. | + +----------------+-----------+--------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotations | No | Map | Label information, which can be extended. By default, this parameter is left blank. | + +----------------+-----------+--------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table14531721311: + +.. table:: **Table 4** **storage** parameters + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+================================================================================================================================================================================================+ + | type | Yes | String | Storage type. | + | | | | | + | | | | Only **obs** and **evs** are supported. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | location | No | Object | Storage location. If **type** is set to **obs**, this parameter is mandatory. See `Table 5 <#modelarts030110enustopic0136223949table10263721145>`__. By default, this parameter is left blank. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table10263721145: + +.. table:: **Table 5** **location** parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=============================================================================================================================================================================================================================================+ + | path | No | String | Storage path | + | | | | | + | | | | - If **type** is set to **obs**, this parameter is mandatory. The value must be a valid OBS bucket path and end with a slash (/). The value must be a specific directory in an OBS bucket rather than the root directory of an OBS bucket. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table756291982911: + +.. table:: **Table 6** **auto_stop** parameters + + +-----------+-----------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+=========+=================================================================================================================================================================================================================================================================================+ + | enable | No | Boolean | Whether to enable the auto stop function. The value **true** indicates that the function is enabled and the instance will automatically stop when the running duration is reached. The value **false** indicates that the function is disabled. The default value is **false**. | + +-----------+-----------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | No | Integer | Running duration, in seconds. The value ranges from 3,600 to 86,400. After this parameter is set, it is valid for each startup. This parameter is mandatory when **enable** is set to **true**. | + +-----------+-----------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | prompt | No | Boolean | Whether to display a prompt again. This parameter is provided for the console to determine whether to display a prompt again. The default value is **true**. | + +-----------+-----------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table195831523711: + +.. table:: **Table 7** **workspace** parameters + + +-----------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+=================================================================================================================================+ + | id | No | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +-----------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949requestpoolSpec: + +.. table:: **Table 8** **poolSpec** parameters + + +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+================================================================================================================+ + | id | Yes | String | Resource pool ID. | + +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------+ + | type | No | String | Resource pool type. | + +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------+ + | name | No | String | Resource pool name. | + +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------+ + | owner | No | Object | Owner of the resource pool. For details, see `Table 9 <#modelarts030110enustopic0136223949requestuserspec>`__. | + +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949requestuserSpec: + +.. table:: **Table 9** **userSpec** parameters + + +------------+-----------+--------+--------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+==================================================+ + | project_id | No | String | ID of the project to which the resource belongs. | + +------------+-----------+--------+--------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949requestAIProject: + +.. table:: **Table 10** **AIProject** parameters + + ========= ========= ====== ========================================== + Parameter Mandatory Type Description + ========= ========= ====== ========================================== + id No String AI project ID. This parameter is reserved. + ========= ========= ====== ========================================== + +Response Body +------------- + +`Table 11 <#modelarts030110enustopic0136223949table1282791914324>`__ describes the response parameters. + +.. _modelarts030110enustopic0136223949table1282791914324: + +.. table:: **Table 11** Parameters + + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=========================+========+=========================================================================================================================================================================================================+ + | id | String | Instance ID | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Instance name | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Instance description | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Instance status | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | creation_timestamp | String | Time when an instance is created | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | latest_update_timestamp | String | Time when an instance is modified | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | profile | Object | Configuration information. For details, see `Table 12 <#modelarts030110enustopic0136223949table14360146192514>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | String | Instance flavor | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor_details | Object | For details about the flavor, see `Table 16 <#modelarts030110enustopic0136223949table15315195310273>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool | Object | For details about the dedicated resource pool, see `Table 17 <#modelarts030110enustopic0136223949table1757552712913>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec | Object | Instance definition For details about parameters of a notebook instance, see `Table 19 <#modelarts030110enustopic0136223949table8449155512217>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace | Object | Workspace. For details, see `Table 24 <#modelarts030110enustopic0136223949table11410143081110>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ai_project | Object | AI project. For details, see `Table 25 <#modelarts030110enustopic0136223949responseaiproject>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code. For details, see `Error Codes <../common_parameters/error_codes.html>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | queuing_info | Object | Queuing information. For details, see `Table 26 <#modelarts030110enustopic0136223949table1535133818408>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user | Object | User information. For details, see `Table 27 <#modelarts030110enustopic0136223949table478950164319>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | repository | Object | Git repository information. For details, see `Table 28 <#modelarts030110enustopic0136223949table63971252184512>`__. This parameter cannot be used. It is automatically returned when the API is called. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table14360146192514: + +.. table:: **Table 12** **profile** parameters + + +-------------+--------------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+====================+===============================================================================================================+ + | id | String | Configuration ID | + +-------------+--------------------+---------------------------------------------------------------------------------------------------------------+ + | name | String | Configuration name | + +-------------+--------------------+---------------------------------------------------------------------------------------------------------------+ + | description | String | Configuration description | + +-------------+--------------------+---------------------------------------------------------------------------------------------------------------+ + | de_type | String | Development environment type. Only **Notebook** is supported. | + +-------------+--------------------+---------------------------------------------------------------------------------------------------------------+ + | flavor_type | String | Hardware, which can be **CPU**, **GPU**, or **Ascend**. | + +-------------+--------------------+---------------------------------------------------------------------------------------------------------------+ + | provision | Object | Deployment information. For details, see `Table 13 <#modelarts030110enustopic0136223949table108415111491>`__. | + +-------------+--------------------+---------------------------------------------------------------------------------------------------------------+ + | labels | Map | Label | + +-------------+--------------------+---------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table108415111491: + +.. table:: **Table 13** **provision** parameters + + +-----------+--------+-----------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+===========================================================================================================+ + | type | String | Deployment type. Only **Docker** is supported. | + +-----------+--------+-----------------------------------------------------------------------------------------------------------+ + | spec | Object | Deployment details. For details, see `Table 14 <#modelarts030110enustopic0136223949table368911231548>`__. | + +-----------+--------+-----------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table368911231548: + +.. table:: **Table 14** **spec** parameters + + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+============================================================================================================================================+ + | engine | String | Deployment engine. Only **CCE** is supported. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------+ + | params | Object | Deployment parameters. Only **Docker** is supported. For details, see `Table 15 <#modelarts030110enustopic0136223949table932452015018>`__. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table932452015018: + +.. table:: **Table 15** Docker deployment parameters + + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+====================+=====================================================================================+ + | namespace | String | SWR organization name, which is globally unique | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | image_name | String | Image name | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | image_tag | String | Image tag | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | annotations | Map | Label information, which can be extended. By default, this parameter is left blank. | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table15315195310273: + +.. table:: **Table 16** **flavor_details** parameters + + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================+ + | name | String | Flavor name | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | status | String | Flavor sale status The options are as follows: | + | | | | + | | | - **onSale** | + | | | - **soldOut** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | queuing_num | Integer | This parameter is mandatory when **promo_type** is set to **Free** and **status** is set to **soldOut**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | queue_left_time | Integer | Left queuing time, in seconds | + | | | | + | | | This parameter is mandatory when **promo_type** is set to **Free** and **status** is set to **soldOut**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | storage_list | Array | Supported storage type. The options are as follows: | + | | | | + | | | - **obs** | + | | | - **evs** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | is_permitted | Boolean | Whether the current user has the permission to use this flavor | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | type | String | Flavor status. The options are as follows: | + | | | | + | | | - **GPU** | + | | | - **CPU** | + | | | - **ASCEND** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | params | Dict | Parameters that describing flavor | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | promo_type | String | Promotion type. The options are as follows: | + | | | | + | | | - Free | + | | | - NoDiscount | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | instance_num | Integer | Number of instances of this flavor the current created | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | duration | Integer | Auto stop time after startup, in seconds | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | store_time | Integer | Maximum retention period of an inactive instance of this flavor in the database, in hours | + | | | | + | | | The default value is **-1**, indicating that the instance can be permanently saved. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | billing_flavor | String | Billing specifications. If this field is left blank, the specifications name is used for billing. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | billing_params | Integer | Billing ratio This parameter is mandatory when **billing_flavor** is specified. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table1757552712913: + +.. table:: **Table 17** **pool** parameters + + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+==============================================================================================================================================================+ + | id | String | ID of a resource pool | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Name of a resource pool | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Type of a resource pool. **USER_DEFINED** indicates a dedicated resource pool. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | owner | Object | This parameter is mandatory when **type** is set to **USER_DEFINED**. For details, see `Table 18 <#modelarts030110enustopic0136223949table1532233153818>`__. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table1532233153818: + +.. table:: **Table 18** **owner** parameters + + ========== ====== =========== + Parameter Type Description + ========== ====== =========== + project_id String Project ID + ========== ====== =========== + + + +.. _modelarts030110enustopic0136223949table8449155512217: + +.. table:: **Table 19** **notebook** parameters + + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+=========================================================================================================================================================================================================+ + | log_path | String | Path for storing custom image logs | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | custom_script_path | String | Path for storing custom initialization scripts used when a notebook instance is started | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | storage | Object | Storage path. For details, see `Table 20 <#modelarts030110enustopic0136223949table9228954163219>`__. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | credential | Object | AK and SK for accessing OBS. For details, see `Table 30 <#modelarts030110enustopic0136223949table970685216555>`__. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | repository | Object | Git repository information. For details, see `Table 28 <#modelarts030110enustopic0136223949table63971252184512>`__. This parameter cannot be used. It is automatically returned when the API is called. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource_reserved_timestamp | Integer | Time when the resource is reserved | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | auto_stop | Object | Auto stop parameter. For details, see `Table 23 <#modelarts030110enustopic0136223949table14279174582613>`__. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | failed_reasons | Object | Cause for a creation or startup failure. For details, see `Table 22 <#modelarts030110enustopic0136223949table72771614152013>`__. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotations | Map | Annotations | + | | | | + | | | The generated URL cannot be directly accessed. | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | extend_params | Map | Extended parameter | + +-----------------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table9228954163219: + +.. table:: **Table 20** **storage** parameters + + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==================================================================================================================================================================================================+ + | type | String | Storage type. | + | | | | + | | | Only **obs** and **evs** are supported. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | location | Object | Storage location. If **type** is set to **obs**, this parameter is mandatory. See `Table 21 <#modelarts030110enustopic0136223949table212131963416>`__. By default, this parameter is left blank. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table212131963416: + +.. table:: **Table 21** **location** parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=============================================================================================================================================================================================================================================+ + | path | String | Storage path | + | | | | + | | | - If **type** is set to **obs**, this parameter is mandatory. The value must be a valid OBS bucket path and end with a slash (/). The value must be a specific directory in an OBS bucket rather than the root directory of an OBS bucket. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | volume_size | Integer | If **type** is set to **obs**, this parameter does not need to be set. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table72771614152013: + +.. table:: **Table 22** **failed_reasons** parameters + + ========= ================== ============= + Parameter Type Description + ========= ================== ============= + code String Error code. + message String Error message + detail Map Error details + ========= ================== ============= + + + +.. _modelarts030110enustopic0136223949table14279174582613: + +.. table:: **Table 23** **auto_stop** parameters + + +----------------+---------+---------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+=========+=======================================================================================+ + | enable | Boolean | Whether to enable the auto stop function | + +----------------+---------+---------------------------------------------------------------------------------------+ + | duration | Integer | Running duration, in seconds | + +----------------+---------+---------------------------------------------------------------------------------------+ + | prompt | Boolean | Whether to display a prompt again. This parameter is provided for the console to use. | + +----------------+---------+---------------------------------------------------------------------------------------+ + | stop_timestamp | Integer | Time when the instance stops. The value is a 13-digit timestamp. | + +----------------+---------+---------------------------------------------------------------------------------------+ + | remain_time | Integer | Remaining time before actual stop, in seconds | + +----------------+---------+---------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table11410143081110: + +.. table:: **Table 24** **workspace** parameters + + ========= ====== ============ + Parameter Type Description + ========= ====== ============ + id String Workspace ID + ========= ====== ============ + + + +.. _modelarts030110enustopic0136223949responseAIProject: + +.. table:: **Table 25** **AIProject** parameters + + ========= ====== ============= + Parameter Type Description + ========= ====== ============= + id String AI project ID + ========= ====== ============= + + + +.. _modelarts030110enustopic0136223949table1535133818408: + +.. table:: **Table 26** **queuing_info** parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=================================================================================================================================================================================+ + | id | String | Instance ID | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Instance name | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | de_type | String | Development environment type. By default, all types are returned. | + | | | | + | | | Only **Notebook** is supported. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | String | Instance flavor. By default, all types are returned. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor_details | Object | Flavor details, which display the flavor information and whether the flavor is sold out For details, see `Table 16 <#modelarts030110enustopic0136223949table15315195310273>`__. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Instance status. By default, all statuses are returned, including: | + | | | | + | | | - **CREATE_QUEUING** | + | | | - **START_QUEUING** | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | begin_timestamp | Integer | Time when an instance starts queuing. The value is a 13-digit timestamp. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | remain_time | Integer | Left queuing time, in seconds | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | end_timestamp | Integer | Time when an instance completes queuing. The value is a 13-digit timestamp. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rank | Integer | Ranking of an instance in a queue | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table478950164319: + +.. table:: **Table 27** **user** parameters + + ========= ====== =========== + Parameter Type Description + ========= ====== =========== + id String User ID + name String Username + ========= ====== =========== + + + +.. _modelarts030110enustopic0136223949table63971252184512: + +.. table:: **Table 28** **repository** parameters + + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=================+========+======================================================================================================================+ + | id | String | Repository ID | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | branch | String | Repository branch | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | user_name | String | Repository username | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | user_email | String | Repository user mailbox | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | type | String | Repository type. The options are **CodeClub** and **GitHub**. | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | connection_info | Object | Repository link information. For details, see `Table 29 <#modelarts030110enustopic0136223949table13487192116490>`__. | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table13487192116490: + +.. table:: **Table 29** **connection_info** parameters + + +------------+--------+----------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +============+========+================================================================================================================+ + | protocol | String | Repository link protocol. The options are **ssh** and **https**. | + +------------+--------+----------------------------------------------------------------------------------------------------------------+ + | url | String | Repository link address | + +------------+--------+----------------------------------------------------------------------------------------------------------------+ + | credential | Object | Certificate information. For details, see `Table 30 <#modelarts030110enustopic0136223949table970685216555>`__. | + +------------+--------+----------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030110enustopic0136223949table970685216555: + +.. table:: **Table 30** **credential** parameters + + =============== ====== ======================= + Parameter Type Description + =============== ====== ======================= + ssh_private_key String SSH private certificate + access_token String OAuth token of GitHub + =============== ====== ======================= + +Samples +------- + +The following shows how to create the **notebook-instance** instance with ID **Python3-gpu**. + +- Sample request + + .. code-block:: + + { + "name": "notebook-instance", + "description": "", + "profile_id": "Multi-Engine 1.0 (python3)-gpu", + "flavor": "modelarts.bm.gpu.v100NV32", + "spec": { + "storage": { + "location": { + "volume_size": 5 + }, + "type": "evs" + }, + "auto_stop": { + "enable": true, + "duration": 3600 + } + }, + "workspace": { + "id": "0" + } + } + +- Successful sample response + + .. code-block:: + + { + "ai_project": { + "id": "default-ai-project" + }, + "creation_timestamp": "1594887749962", + "description": "", + "flavor": "modelarts.bm.gpu.v100NV32", + "flavor_details": { + "name": "modelarts.bm.gpu.v100NV32", + "params": { + "CPU": 8, + "GPU": 1, + "gpu_type": "v100NV32", + "memory": "64GiB" + }, + "status": "onSale", + "type": "GPU" + }, + "id": "DE-7d558ef8-c73d-11ea-964c-0255ac100033", + "latest_update_timestamp": "1594887749962", + "name": "notebook-c6fd", + "profile": { + "de_type": "Notebook", + "description": "multi engine, gpu, python 3.6 for notebook", + "flavor_type": "GPU", + "id": "Multi-Engine 1.0 (python3)-gpu", + "name": "Multi-Engine 1.0 (python3)-gpu", + "provision": { + "annotations": { + "category": "Multi-Engine 1.0", + + "type": "system" + }, + "spec": { + "engine": "CCE", + "params": { + "image_name": "mul-kernel-gpu-cuda-cp36", + "image_tag": "2.0.5-B003", + "namespace": "atelier" + } + }, + "type": "Docker" + } + }, + "spec": { + "annotations": { + "target_domain": "https://xxx", + "url": "" + }, + "auto_stop": { + "duration": 3600, + "enable": true, + "prompt": true + }, + "extend_params": null, + "failed_reasons": null, + "repository": null, + "extend_storage": null, + "storage": { + "location": { + "path": "/home/ma-user/work", + "volume_size": 5, + "volume_unit": "GB" + }, + "type": "evs" + } + }, + "status": "CREATING", + "user": { + "id": "15dda26361214ca2a5953917d2f48ffb", + "name": "ops_dev_env" + }, + "workspace": { + "id": "0" + } + } + +- Failed sample response + + .. code-block:: + + { + "error_message": "The param path needs to end with /.", + "error_code": "ModelArts.6318" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/devenviron/deleting_a_development_environment_instance.rst b/api-ref/source/devenviron/deleting_a_development_environment_instance.rst new file mode 100644 index 0000000..ab165ff --- /dev/null +++ b/api-ref/source/devenviron/deleting_a_development_environment_instance.rst @@ -0,0 +1,83 @@ +Deleting a Development Environment Instance +=========================================== + +Function +-------- + +This API is used to delete a development environment instance. + +URI +--- + +DELETE /v1/{project_id}/demanager/instances/{instance_id} + +`Table 1 <#modelarts030114enustopic0136223953table569625523811>`__ describes the required parameters. + +.. _modelarts030114enustopic0136223953table569625523811: + +.. table:: **Table 1** Parameter description + + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_id | Yes | String | Instance ID | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030114enustopic0136223953table14581542113111>`__ describes the response parameters. + + + +.. _modelarts030114enustopic0136223953table14581542113111: + +.. table:: **Table 2** Parameter description + + =========== ====== =========== + Parameter Type Description + =========== ====== =========== + instance_id String Instance ID + =========== ====== =========== + +Samples +------- + +The following shows how to delete instance **6fa459ea-ee8a-3ca4-894e-db77e160355e**. + +- Sample request + + .. code-block:: + + DELETE https://endpoint/v1/{project_id}/demanager/instances/6fa459ea-ee8a-3ca4-894e-db77e160355e + +- Successful sample response + + .. code-block:: + + { + "instance_id": "6fa459ea-ee8a-3ca4-894e-db77e160355e" + } + +- Failed sample response + + .. code-block:: + + { + "error_message": "The instance does not exist.", + "error_code": "ModelArts.6309" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/devenviron/index.rst b/api-ref/source/devenviron/index.rst new file mode 100644 index 0000000..5765fbb --- /dev/null +++ b/api-ref/source/devenviron/index.rst @@ -0,0 +1,15 @@ +========== +DevEnviron +========== + +.. toctree:: + :maxdepth: 1 + + querying_the_authentication_information_of_a_development_environment_instance + creating_a_development_environment_instance + querying_a_list_of_development_environment_instances + querying_the_details_about_a_development_environment_instance + modifying_the_description_of_a_development_environment_instance + deleting_a_development_environment_instance + managing_a_development_environment_instance + restarting_an_ml_studio_instance diff --git a/api-ref/source/devenviron/managing_a_development_environment_instance.rst b/api-ref/source/devenviron/managing_a_development_environment_instance.rst new file mode 100644 index 0000000..ca77a29 --- /dev/null +++ b/api-ref/source/devenviron/managing_a_development_environment_instance.rst @@ -0,0 +1,100 @@ +Managing a Development Environment Instance +=========================================== + +Function +-------- + +This API is used to startor stop a notebook instance. + +URI +--- + +POST /v1/{project_id}/demanager/instances/{instance_id}/action + +`Table 1 <#modelarts030115enustopic0136223954table569625523811>`__ describes the required parameters. + +.. _modelarts030115enustopic0136223954table569625523811: + +.. table:: **Table 1** Parameters + + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_id | Yes | String | Instance ID | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030115enustopic0136223954table46411941555>`__ describes the request parameters. + +.. _modelarts030115enustopic0136223954table46411941555: + +.. table:: **Table 2** Parameters + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==============================================================================+ + | action | Yes | String | Operation on a development environment instance. The options are as follows: | + | | | | | + | | | | - **start** | + | | | | - **stop** | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030115enustopic0136223954table14581542113111>`__ describes the response parameters. + + + +.. _modelarts030115enustopic0136223954table14581542113111: + +.. table:: **Table 3** Parameters + + ============== ====== ============================== + Parameter Type Description + ============== ====== ============================== + current_status String Current status of an instance + previous_state String Previous status of an instance + ============== ====== ============================== + +Samples +------- + +The following shows how to start instance **6fa459ea-ee8a-3ca4-894e-db77e160355e**. + +- Sample request + + .. code-block:: + + { + "action": "start" + } + +- Successful sample response + + .. code-block:: + + { + "current_status": "STARTING", + "previous_state": "STOPPED" + } + +- Failed sample response + + .. code-block:: + + { + "error_message": "The instance does not exist.", + "error_code": "ModelArts.6309" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/devenviron/modifying_the_description_of_a_development_environment_instance.rst b/api-ref/source/devenviron/modifying_the_description_of_a_development_environment_instance.rst new file mode 100644 index 0000000..831f873 --- /dev/null +++ b/api-ref/source/devenviron/modifying_the_description_of_a_development_environment_instance.rst @@ -0,0 +1,600 @@ +Modifying the Description of a Development Environment Instance +=============================================================== + +Function +-------- + +This API is used to modify the description of a development environment instance or information about the auto stop function. + +URI +--- + +PUT /v1/{project_id}/demanager/instances/{instance_id} + +`Table 1 <#modelarts030113enustopic0136223952table569625523811>`__ describes the required parameters. + +.. _modelarts030113enustopic0136223952table569625523811: + +.. table:: **Table 1** Parameters + + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_id | Yes | String | Instance ID | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030113enustopic0136223952table534718186518>`__ describes the request parameters. + +.. _modelarts030113enustopic0136223952table534718186518: + +.. table:: **Table 2** Parameters + + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+========================================================================================================================================+ + | description | No | String | Configuration description. The value contains a maximum of 512 characters and cannot contain the following special characters: &<>"'/. | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | spec | No | Object | Instance definition. For details, see `Table 3 <#modelarts030113enustopic0136223952table3175143201714>`__. | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table3175143201714: + +.. table:: **Table 3** **spec** parameters + + +-----------+-----------+--------+-----------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+===========================================================================================================+ + | auto_stop | No | Object | Auto stop parameter. For details, see `Table 4 <#modelarts030113enustopic0136223952table756291982911>`__. | + +-----------+-----------+--------+-----------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table756291982911: + +.. table:: **Table 4** **auto_stop** parameters + + +-----------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+=========+=============================================================================================================================================================================================================================================================================================================================+ + | enable | No | Boolean | Whether to enable the auto stop function. The value **true** indicates that the function is enabled and the instance will automatically stop when the running duration is reached. The value **false** indicates that the function is disabled. The default value is **false**. | + +-----------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | No | Integer | Running duration, in seconds. The value ranges from 3,600 to 86,400. After this parameter is set, it is valid for each startup. This parameter is mandatory when **enable** is set to **true**. If the current instance status is **Running**, the modifications of this parameter take effect only after the next startup. | + +-----------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | prompt | No | Boolean | Whether to display a prompt again. This parameter is provided for the console to determine whether to display a prompt again. The default value is **true**. | + +-----------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 5 <#modelarts030113enustopic0136223952table1282791914324>`__ describes the response parameters. + +.. _modelarts030113enustopic0136223952table1282791914324: + +.. table:: **Table 5** Parameters + + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=========================+========+=======================================================================================================================================================================================================================================================================+ + | id | String | Instance ID | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Instance name | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Instance description | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Instance status | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | creation_timestamp | String | Time when an instance is created | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | latest_update_timestamp | String | Time when an instance is modified | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | profile | Object | Configuration information. For details, see `Table 12 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table14360146192514>`__. | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | String | Instance flavor | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor_details | Object | For details about the flavor, see `Table 16 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table15315195310273>`__. | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool | Object | For details about the dedicated resource pool, see `Table 17 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table1757552712913>`__. | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec | Object | Instance definition For details about parameters of a notebook instance, see `Table 19 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table8449155512217>`__. | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace | Object | Workspace. For details, see `Table 24 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table11410143081110>`__. | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ai_project | Object | AI project. For details, see `Table 25 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949responseaiproject>`__. | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code. For details, see `Error Codes <../common_parameters/error_codes.html>`__. | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | queuing_info | Object | Queuing information. For details, see `Table 26 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table1535133818408>`__. | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user | Object | User information. For details, see `Table 27 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table478950164319>`__. | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | repository | Object | Git repository information. For details, see `Table 28 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table63971252184512>`__. This parameter cannot be used. It is automatically returned when the API is called. | + +-------------------------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table91791695387: + +.. table:: **Table 6** **profile** parameters + + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+====================+==============================================================================================================================================================================================+ + | id | String | Configuration ID | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Configuration name | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Configuration description | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | de_type | String | Development environment type. Only **Notebook** is supported. | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | provision | Object | Deployment information. For details, see `Table 4 <../devenviron/querying_the_details_about_a_development_environment_instance.html#modelarts030112enustopic0136223951table108415111491>`__. | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labels | Map | Label information | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor_type | String | Hardware, which can be **CPU**, **GPU**, or **Ascend**. | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table108415111491: + +.. table:: **Table 7** **provision** parameters + + +-----------+--------+----------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+==========================================================================================================+ + | type | String | Deployment type. Only **Docker** is supported. | + +-----------+--------+----------------------------------------------------------------------------------------------------------+ + | spec | Object | Deployment details. For details, see `Table 8 <#modelarts030113enustopic0136223952table368911231548>`__. | + +-----------+--------+----------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table368911231548: + +.. table:: **Table 8** **spec** parameters + + +-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+===========================================================================================================================================+ + | engine | String | Deployment engine. Only **CCE** is supported. | + +-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | params | Object | Deployment parameters. Only **Docker** is supported. For details, see `Table 9 <#modelarts030113enustopic0136223952table932452015018>`__. | + +-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table932452015018: + +.. table:: **Table 9** Docker deployment parameters + + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+====================+=====================================================================================+ + | namespace | String | SWR organization name, which is globally unique | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | image_name | String | Image name | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | image_tag | String | Image tag | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | annotations | Map | Label information, which can be extended. By default, this parameter is left blank. | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table15315195310273: + +.. table:: **Table 10** **flavor_details** parameters + + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================+ + | name | String | Flavor name | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | status | String | Flavor sale status The options are as follows: | + | | | | + | | | - **onSale** | + | | | - **soldOut** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | queuing_num | Integer | This parameter is mandatory when **promo_type** is set to **Free** and **status** is set to **soldOut**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | queue_left_time | Integer | Left queuing time, in seconds | + | | | | + | | | This parameter is mandatory when **promo_type** is set to **Free** and **status** is set to **soldOut**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | storage_list | Array | Supported storage type. The options are as follows: | + | | | | + | | | - **obs** | + | | | - **evs** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | is_permitted | Boolean | Whether the current user has the permission to use this flavor | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | type | String | Flavor status. The options are as follows: | + | | | | + | | | - **GPU** | + | | | - **CPU** | + | | | - **ASCEND** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | params | Dict | Parameters that describing flavor | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | promo_type | String | Promotion type. The options are as follows: | + | | | | + | | | - Free | + | | | - NoDiscount | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | instance_num | Integer | Number of instances of this flavor the current created | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | duration | Integer | Auto stop time after startup, in seconds | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | store_time | Integer | Maximum retention period of an inactive instance of this flavor in the database, in hours | + | | | | + | | | The default value is **-1**, indicating that the instance can be permanently saved. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | billing_flavor | String | Billing specifications. If this field is left blank, the specifications name is used for billing. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | billing_params | Integer | Billing ratio This parameter is mandatory when **billing_flavor** is specified. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table1757552712913: + +.. table:: **Table 11** **pool** parameters + + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+==============================================================================================================================================================+ + | id | String | ID of a resource pool | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Name of a resource pool | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Type of a resource pool. **USER_DEFINED** indicates a dedicated resource pool. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | owner | Object | This parameter is mandatory when **type** is set to **USER_DEFINED**. For details, see `Table 13 <#modelarts030113enustopic0136223952table1532233153818>`__. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table4598102745311: + +.. table:: **Table 12** **AIProject** parameters + + ========= ====== ============== + Parameter Type Description + ========= ====== ============== + id String AI project ID. + ========= ====== ============== + + + +.. _modelarts030113enustopic0136223952table1532233153818: + +.. table:: **Table 13** **owner** parameters + + ========== ========= ====== =========== + Parameter Mandatory Type Description + ========== ========= ====== =========== + project_id Yes String Project ID + ========== ========= ====== =========== + + + +.. _modelarts030113enustopic0136223952table115411254165418: + +.. table:: **Table 14** **notebook** parameters + + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+=======================================================================================================================================================================================================================================================================+ + | log_path | String | Path for storing custom image logs | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | custom_script_path | String | Path for storing custom initialization scripts used when a notebook instance is started | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | storage | Object | Storage path. For details, see `Table 20 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table9228954163219>`__. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | credential | Object | AK and SK for accessing OBS. For details, see `Table 30 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table970685216555>`__. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | repository | Object | Git repository information. For details, see `Table 28 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table63971252184512>`__. This parameter cannot be used. It is automatically returned when the API is called. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource_reserved_timestamp | Integer | Time when the resource is reserved | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | auto_stop | Object | Auto stop parameter. For details, see `Table 23 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table14279174582613>`__. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | failed_reasons | Object | Cause for a creation or startup failure. For details, see `Table 22 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table72771614152013>`__. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotations | Map | Annotations | + | | | | + | | | The generated URL cannot be directly accessed. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | extend_params | Map | Extended parameter | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table9228954163219: + +.. table:: **Table 15** **storage** parameters + + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+==================================================================================================================================================================================================+ + | type | String | Storage type. Only **obs** and **evs** are supported. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | location | Object | Storage location. If **type** is set to **obs**, this parameter is mandatory. See `Table 16 <#modelarts030113enustopic0136223952table212131963416>`__. By default, this parameter is left blank. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table212131963416: + +.. table:: **Table 16** **location** parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=============================================================================================================================================================================================================================================+ + | path | No | String | Storage path | + | | | | | + | | | | - If **type** is set to **obs**, this parameter is mandatory. The value must be a valid OBS bucket path and end with a slash (/). The value must be a specific directory in an OBS bucket rather than the root directory of an OBS bucket. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table14279174582613: + +.. table:: **Table 17** **auto_stop** parameters + + +----------------+---------+---------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+=========+=======================================================================================+ + | enable | Boolean | Whether to enable the auto stop function | + +----------------+---------+---------------------------------------------------------------------------------------+ + | duration | Integer | Running duration, in seconds | + +----------------+---------+---------------------------------------------------------------------------------------+ + | prompt | Boolean | Whether to display a prompt again. This parameter is provided for the console to use. | + +----------------+---------+---------------------------------------------------------------------------------------+ + | stop_timestamp | Integer | Time when the instance stops. The value is a 13-digit timestamp. | + +----------------+---------+---------------------------------------------------------------------------------------+ + | remain_time | Integer | Remaining time before actual stop, in seconds | + +----------------+---------+---------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table72771614152013: + +.. table:: **Table 18** **failed_reasons** parameters + + ========= ================== ============= + Parameter Type Description + ========= ================== ============= + code String Error code + message String Error message + detail Map Error details + ========= ================== ============= + + + +.. _modelarts030113enustopic0136223952table82085111012: + +.. table:: **Table 19** **workspace** parameters + + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+================================================================================================================================+ + | id | String | Workspace ID If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table1535133818408: + +.. table:: **Table 20** **queuing_info** parameters + + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================================================================================================================================================+ + | id | String | Instance ID | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Instance name | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | de_type | String | Development environment type. By default, all types are returned. | + | | | | + | | | Only **Notebook** is supported. | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | String | Instance flavor. By default, all types are returned. | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor_details | Object | Flavor details, which display the flavor information and whether the flavor is sold out For details, see `Table 16 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table15315195310273>`__. | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Instance status. By default, all statuses are returned, including: | + | | | | + | | | - **CREATE_QUEUING** | + | | | - **START_QUEUING** | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | begin_timestamp | Integer | Time when an instance starts queuing. The value is a 13-digit timestamp. | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | remain_time | Integer | Left queuing time, in seconds | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | end_timestamp | Integer | Time when an instance completes queuing. The value is a 13-digit timestamp. | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rank | Integer | Ranking of an instance in a queue | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table478950164319: + +.. table:: **Table 21** **user** parameters + + ========= ====== =========== + Parameter Type Description + ========= ====== =========== + id String User ID + name String Username + ========= ====== =========== + + + +.. _modelarts030113enustopic0136223952table63971252184512: + +.. table:: **Table 22** **repository** parameters + + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=================+========+====================================================================================================================================================================================+ + | id | String | Repository ID | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | branch | String | Repository branch | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_name | String | Repository username | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_email | String | Repository user mailbox | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Repository type. The options are **CodeClub** and **GitHub**. | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | connection_info | Object | Repository link information. For details, see `Table 29 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table13487192116490>`__. | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table13487192116490: + +.. table:: **Table 23** **connection_info** parameters + + +------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +============+========+==============================================================================================================================================================================+ + | protocol | String | Repository link protocol. The options are **ssh** and **https**. | + +------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | url | String | Repository link address | + +------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | credential | Object | Certificate information. For details, see `Table 30 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table970685216555>`__. | + +------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030113enustopic0136223952table970685216555: + +.. table:: **Table 24** **credential** parameters + + =============== ====== ======================= + Parameter Type Description + =============== ====== ======================= + ssh_private_key String SSH private certificate + access_token String OAuth token of GitHub + =============== ====== ======================= + +Samples +------- + +The following shows how to modify the details about instance **6fa459ea-ee8a-3ca4-894e-db77e160355e**. + +- Sample request + + .. code-block:: + + {"description":"This is for test."} + +- Successful sample response + + .. code-block:: + + { + "ai_project": { + "id": "default-ai-project" + }, + "creation_timestamp": "1594887749962", + "description": "update notebook", + "flavor": "modelarts.bm.gpu.v100NV32", + "flavor_details": { + "name": "modelarts.bm.gpu.v100NV32", + "params": { + "CPU": 8, + "GPU": 1, + "gpu_type": "v100NV32", + "memory": "64GiB" + }, + "status": "onSale", + "type": "GPU" + }, + "id": "DE-7d558ef8-c73d-11ea-964c-0255ac100033", + "latest_update_timestamp": "1594888143062", + "name": "notebook-c6fd", + "profile": { + "de_type": "Notebook", + "description": "multi engine, gpu, python 3.6 for notebook", + "flavor_type": "GPU", + "id": "Python3-gpu", + "name": "Python3", + "provision": { + "annotations": { + "category": "Multi-Engine (Recommend)", + "flavor": "modelarts.vm.gpu.p100", + "type": "system" + }, + "spec": { + "engine": "CCE", + "params": { + "annotations": null, + "image_name": "mul-kernel-gpu-cuda-cp36", + "image_tag": "2.0.5-B003", + "namespace": "atelier" + } + }, + "type": "Docker" + } + }, + "spec": { + "annotations": { + "target_domain": "https://xxx", + "url": "https://xxx/modelarts/hubv100/notebook/user/DE-7d558ef8-c73d-11ea-964c-0255ac100033" + }, + "auto_stop": { + "duration": 3600, + "enable": true, + "prompt": true, + "remain_time": 3266, + "stop_timestamp": 1594891408723 + }, + "extend_params": null, + "failed_reasons": null, + "repository": null, + "storage": { + "location": { + "path": "/home/ma-user/work", + "volume_size": 5, + "volume_unit": "GB" + }, + "type": "evs" + } + }, + "status": "RUNNING", + "user": { + "id": "15dda26361214ca2a5953917d2f48ffb", + "name": "ops_dev_env" + }, + "workspace": { + "id": "0" + } + } + +- Failed sample response + + .. code-block:: + + { + "error_message": "The instance does not exist.", + "error_code": "ModelArts.6309" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/devenviron/querying_a_list_of_development_environment_instances.rst b/api-ref/source/devenviron/querying_a_list_of_development_environment_instances.rst new file mode 100644 index 0000000..47ca4e8 --- /dev/null +++ b/api-ref/source/devenviron/querying_a_list_of_development_environment_instances.rst @@ -0,0 +1,661 @@ +Querying a List of Development Environment Instances +==================================================== + +Function +-------- + +This API is used to query the development environment instances that meet the search criteria. + +URI +--- + +GET /v1/{project_id}/demanager/instances?de_type={de_type}&provision_type={provision_type}&status={status}&sortby={sortby}&order={order}&offset={offset}&limit={limit} + +`Table 1 <#modelarts030111enustopic0136223950table569625523811>`__ describes the required parameters. + +.. _modelarts030111enustopic0136223950table569625523811: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030111enustopic0136223950table92801116194411>`__ describes the request parameters. + + + +.. _modelarts030111enustopic0136223950table92801116194411: + +.. table:: **Table 2** Parameters + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==========================================================================================================================================+ + | de_type | Yes | String | Development environment type. Only **Notebook** is supported. The first letter must be capitalized. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | provision_type | No | String | Deployment type. Only **Docker** is supported. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | status | No | String | Instance status. By default, all statuses are returned. The options are as follows: | + | | | | | + | | | | - **CREATING**: The instance is being created. | + | | | | - **CREATE_FAILED**: The instance fails to be created. | + | | | | - **STARTING**: The instance is being started. | + | | | | - **RESTARTING**: The instance is being restarted. | + | | | | - **START_FAILED**: The instance fails to be started. | + | | | | - **RUNNING**: The instance is running. | + | | | | - **STOPPING**: The instance is being stopped. | + | | | | - **STOPPED**: The instance has been stopped. | + | | | | - **UNAVAILABLE**: The instance is unavailable. | + | | | | - **DELETED**: The instance has been deleted. | + | | | | - **RESIZING**: The instance specifications are being changed. | + | | | | - **RESIZE_FAILED**: The instance specifications fail to be changed. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | sortby | No | String | Classification standard. The value can be **name** or **creation_timestamp**. The default value is **name**. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting mode. The value can be **asc** or **desc**. The default value is **asc**. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start index. The default value is **0**. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | limit | No | Integer | Number of returned result records. The value range is (0, ∞). The default value is **0**, which indicates that all results are returned. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | show_self | No | String | Only the user is displayed. The default value is **true**. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | ai_project | No | String | AI project ID | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_id | No | String | ID of a dedicated resource pool. This parameter can be used to query information about all instances in a dedicated resource pool. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030111enustopic0136223950table1282791914324>`__ describes the response parameters. + +.. _modelarts030111enustopic0136223950table1282791914324: + +.. table:: **Table 3** Parameters + + +-------------+---------+------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+=========+============================================================================================================+ + | total_count | Integer | Total number of development environments. | + +-------------+---------+------------------------------------------------------------------------------------------------------------+ + | instances | Array | Configuration list. For details, see `Table 4 <#modelarts030111enustopic0136223950table12784181511314>`__. | + +-------------+---------+------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table12784181511314: + +.. table:: **Table 4** **instances** parameters + + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=========================+========+=========================================================================================================================================================================================================+ + | id | String | Instance ID | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Instance name | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Instance description | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Instance status | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | creation_timestamp | String | Time when an instance is created | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | profile | Object | Configuration information. For details, see `Table 5 <#modelarts030111enustopic0136223950table8786115121319>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | String | Instance flavor | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec | Object | Instance definition. For details about parameters of a notebook instance, see `Table 13 <#modelarts030111enustopic0136223950table8449155512217>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace | Object | Workspace. For details, see `Table 17 <#modelarts030111enustopic0136223950table82085111012>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | latest_update_timestamp | String | Time when an instance is modified | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor_details | Object | Flavor details. For details, see `Table 9 <#modelarts030111enustopic0136223950table15315195310273>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool | Object | Dedicated resource pool. For details, see `Table 10 <#modelarts030111enustopic0136223950table1757552712913>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | ai_project | Object | AI project. For details, see `Table 11 <#modelarts030111enustopic0136223950table4598102745311>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code. For details, see `Error Codes <../common_parameters/error_codes.html>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | queuing_info | Object | Queuing information. For details, see `Table 18 <#modelarts030111enustopic0136223950table1535133818408>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user | Object | User information. For details, see `Table 19 <#modelarts030111enustopic0136223950table478950164319>`__. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | repository | Object | Git repository information. For details, see `Table 20 <#modelarts030111enustopic0136223950table63971252184512>`__. This parameter cannot be used. It is automatically returned when the API is called. | + +-------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table8786115121319: + +.. table:: **Table 5** **profile** parameters + + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+====================+================================================================================================================+ + | id | String | Configuration ID | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------+ + | name | String | Configuration name | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------+ + | description | String | Configuration description | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------+ + | de_type | String | Development environment type. Only **Notebook** is supported. | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------+ + | provision | Object | Deployment information. For details, see `Table 6 <#modelarts030111enustopic0136223950table17787181516134>`__. | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------+ + | labels | Map | Label information, which can be extended | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------+ + | flavor_type | String | Hardware, which can be **CPU**, **GPU**, or **Ascend**. | + +-------------+--------------------+----------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table17787181516134: + +.. table:: **Table 6** **provision** parameters + + +-------------+--------------------+------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+====================+============================================================================================================+ + | type | String | Deployment type. Only **Docker** is supported. | + +-------------+--------------------+------------------------------------------------------------------------------------------------------------+ + | spec | Object | Deployment details. For details, see `Table 7 <#modelarts030111enustopic0136223950table12789111541310>`__. | + +-------------+--------------------+------------------------------------------------------------------------------------------------------------+ + | annotations | Map | Label information, which can be extended. By default, this parameter is left blank. | + +-------------+--------------------+------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table12789111541310: + +.. table:: **Table 7** **spec** parameters + + +-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+==========================================================================================================================================+ + | engine | String | Deployment engine. Only **CCE** is supported. | + +-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------+ + | params | Object | Deployment parameters. Only **Docker** is supported. For details, see `Table 8 <#modelarts030111enustopic0136223950table77908157134>`__. | + +-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table77908157134: + +.. table:: **Table 8** Docker deployment parameters + + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+====================+=====================================================================================+ + | namespace | String | SWR organization name, which is globally unique | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | image_name | String | Image name | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | image_tag | String | Image tag | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | annotations | Map | Label information, which can be extended. By default, this parameter is left blank. | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table15315195310273: + +.. table:: **Table 9** **flavor_details** parameters + + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================+ + | name | String | Flavor name | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | status | String | Flavor sale status The options are as follows: | + | | | | + | | | - **onSale** | + | | | - **soldOut** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | queuing_num | Integer | This parameter is mandatory when **promo_type** is set to **Free** and **status** is set to **soldOut**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | queue_left_time | Integer | Left queuing time, in seconds | + | | | | + | | | This parameter is mandatory when **promo_type** is set to **Free** and **status** is set to **soldOut**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | storage_list | Array | Supported storage type. The options are **obs**, **evs**, and **efs**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | is_permitted | Boolean | Whether the current user has the permission to use this flavor | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | type | String | Flavor status. The options are as follows: | + | | | | + | | | - **GPU** | + | | | - **CPU** | + | | | - **ASCEND** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | params | Dict | Parameters that describing flavor | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | promo_type | String | Promotion type. The options are as follows: | + | | | | + | | | - **Free** | + | | | - **NoDiscount** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | instance_num | Integer | Number of instances of this flavor the current created | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | duration | Integer | Auto stop time after startup, in seconds | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | store_time | Integer | Maximum retention period of an inactive instance of this flavor in the database, in hours | + | | | | + | | | The default value is **-1**, indicating that the instance can be permanently saved. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | billing_flavor | String | Billing specifications. If this field is left blank, the specifications name is used for billing. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | billing_params | Integer | Billing ratio This parameter is mandatory when **billing_flavor** is specified. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table1757552712913: + +.. table:: **Table 10** **pool** parameters + + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+==============================================================================================================================================================+ + | id | String | ID of a resource pool | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Name of a resource pool | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Type of a resource pool. **USER_DEFINED** indicates a dedicated resource pool. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | owner | Object | This parameter is mandatory when **type** is set to **USER_DEFINED**. For details, see `Table 12 <#modelarts030111enustopic0136223950table1532233153818>`__. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table4598102745311: + +.. table:: **Table 11** **AIProject** parameters + + ========= ====== ============= + Parameter Type Description + ========= ====== ============= + id String AI project ID + ========= ====== ============= + + + +.. _modelarts030111enustopic0136223950table1532233153818: + +.. table:: **Table 12** **owner** parameters + + ========== ====== =========== + Parameter Type Description + ========== ====== =========== + project_id String Project ID + ========== ====== =========== + + + +.. _modelarts030111enustopic0136223950table8449155512217: + +.. table:: **Table 13** **notebook** parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=====================================================================================================================+ + | auto_stop | Object | Auto stop parameter. For details, see `Table 16 <#modelarts030111enustopic0136223950table14279174582613>`__. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | annotations | Map | Annotations | + | | | | + | | | The generated URL cannot be directly accessed. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | failed_reasons | Object | Cause for a creation or startup failure. See `Table 15 <#modelarts030111enustopic0136223950table72771614152013>`__. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | extend_params | Map | Extended parameter | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table10263721145: + +.. table:: **Table 14** **location** parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=============================================================================================================================================================================================================================================+ + | path | No | String | Storage path. | + | | | | | + | | | | - If **type** is set to **obs**, this parameter is mandatory. The value must be a valid OBS bucket path and end with a slash (/). The value must be a specific directory in an OBS bucket rather than the root directory of an OBS bucket. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | volume_size | No | Integer | If **type** is set to **obs**, this parameter does not need to be set. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table72771614152013: + +.. table:: **Table 15** **failed_reasons** parameters + + ========= ================== ============= + Parameter Type Description + ========= ================== ============= + code String Error code + message String Error message + detail Map Error details + ========= ================== ============= + + + +.. _modelarts030111enustopic0136223950table14279174582613: + +.. table:: **Table 16** **auto_stop** parameters + + +----------------+---------+---------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+=========+=======================================================================================+ + | enable | Boolean | Whether to enable the auto stop function | + +----------------+---------+---------------------------------------------------------------------------------------+ + | duration | Integer | Running duration, in seconds | + +----------------+---------+---------------------------------------------------------------------------------------+ + | prompt | Boolean | Whether to display a prompt again. This parameter is provided for the console to use. | + +----------------+---------+---------------------------------------------------------------------------------------+ + | stop_timestamp | Integer | Time when the instance stops. The value is a 13-digit timestamp. | + +----------------+---------+---------------------------------------------------------------------------------------+ + | remain_time | Integer | Remaining time before actual stop, in seconds | + +----------------+---------+---------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table82085111012: + +.. table:: **Table 17** **workspace** parameters + + ========= ====== ============ + Parameter Type Description + ========= ====== ============ + id String Workspace ID + ========= ====== ============ + + + +.. _modelarts030111enustopic0136223950table1535133818408: + +.. table:: **Table 18** **queuing_info** parameters + + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+================================================================================================================================================================================+ + | id | String | Instance ID | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Instance name | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | de_type | String | Development environment type. By default, all types are returned. | + | | | | + | | | Only **Notebook** is supported. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | String | Instance flavor. By default, all types are returned. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor_details | Object | Flavor details, which display the flavor information and whether the flavor is sold out For details, see `Table 9 <#modelarts030111enustopic0136223950table15315195310273>`__. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Instance status. By default, all statuses are returned, including: | + | | | | + | | | - **CREATE_QUEUING** | + | | | - **START_QUEUING** | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | begin_timestamp | Integer | Time when an instance starts queuing. The value is a 13-digit timestamp. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | remain_time | Integer | Left queuing time, in seconds | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | end_timestamp | Integer | Time when an instance completes queuing. The value is a 13-digit timestamp. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rank | Integer | Ranking of an instance in a queue | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table478950164319: + +.. table:: **Table 19** **user** parameters + + ========= ====== =========== + Parameter Type Description + ========= ====== =========== + id String User ID + name String Username + ========= ====== =========== + + + +.. _modelarts030111enustopic0136223950table63971252184512: + +.. table:: **Table 20** **repository** parameters + + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=================+========+======================================================================================================================+ + | id | String | Repository ID | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | branch | String | Repository branch | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | user_name | String | Repository username | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | user_email | String | Repository user mailbox | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | type | String | Repository type. The options are **CodeClub** and **GitHub**. | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + | connection_info | Object | Repository link information. For details, see `Table 21 <#modelarts030111enustopic0136223950table13487192116490>`__. | + +-----------------+--------+----------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table13487192116490: + +.. table:: **Table 21** **connection_info** parameters + + +------------+--------+----------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +============+========+================================================================================================================+ + | protocol | String | Repository link protocol. The options are **ssh** and **https**. | + +------------+--------+----------------------------------------------------------------------------------------------------------------+ + | url | String | Repository link address | + +------------+--------+----------------------------------------------------------------------------------------------------------------+ + | credential | Object | Certificate information. For details, see `Table 22 <#modelarts030111enustopic0136223950table970685216555>`__. | + +------------+--------+----------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030111enustopic0136223950table970685216555: + +.. table:: **Table 22** **credential** parameters + + =============== ====== ======================= + Parameter Type Description + =============== ====== ======================= + ssh_private_key String SSH private certificate + access_token String OAuth token of GitHub + =============== ====== ======================= + +Samples +------- + +The following shows how to query the list of Notebook development environments. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/demanager/instances?de_type=Notebook + +- Successful sample response + + .. code-block:: + + { + "instances": [ + { + "ai_project": { + "id": "default-ai-project" + }, + "creation_timestamp": "1594887749962", + "description": "", + "flavor": "modelarts.bm.gpu.v100NV32", + "flavor_details": { + "name": "modelarts.bm.gpu.v100NV32", + "params": { + "CPU": 8, + "GPU": 1, + "gpu_type": "v100NV32", + "memory": "64GiB" + }, + "status": "onSale", + "type": "GPU" + }, + "id": "DE-7d558ef8-c73d-11ea-964c-0255ac100033", + "latest_update_timestamp": "1594887749962", + "name": "notebook-c6fd", + "profile": { + "de_type": "Notebook", + "description": "multi engine, gpu, python 3.6 for notebook", + "flavor_type": "GPU", + "id": "Multi-Engine 1.0 (python3)-gpu", + "name": "Multi-Engine 1.0 (python3)-gpu", + "provision": { + "annotations": { + "category": "Multi-Engine 1.0 (python3)", + "type": "system" + }, + "spec": { + "engine": "CCE", + "params": { + "annotations": null, + "image_name": "mul-kernel-gpu-cuda-cp36", + "image_tag": "2.0.5-B003", + "namespace": "atelier" + } + }, + "type": "Docker" + } + }, + "spec": { + "annotations": { + "target_domain": "https://xxx", + "url": "https://xxx:32000/modelartshubv100/notebook/user/DE-7d558ef8-c73d-11ea-964c-0255ac100033" + }, + "auto_stop": { + "duration": 3600, + "enable": true, + "prompt": true, + "remain_time": 3450, + "stop_timestamp": 1594891408723 + }, + "extend_params": null, + "failed_reasons": null, + "repository": null, + "extend_storage": null, + "storage": { + "location": { + "path": "/home/ma-user/work", + "volume_size": 5, + "volume_unit": "GB" + }, + "type": "evs" + } + }, + "status": "RUNNING", + "user": { + "id": "15dda26361214ca2a5953917d2f48ffb", + "name": "ops_dev_env" + }, + "workspace": { + "id": "0" + } + }, + { + "ai_project": { + "id": "default-ai-project" + }, + "creation_timestamp": "1594883877728", + "description": "", + "flavor": "modelarts.vm.cpu.2u", + "flavor_details": { + "name": "modelarts.vm.cpu.2u", + "params": { + "CPU": 2, + "GPU": 0, + "memory": "8GiB" + }, + "status": "onSale", + "type": "CPU" + }, + "id": "DE-7936a360-c734-11ea-a72b-0255ac100033", + "latest_update_timestamp": "1594883877728", + "name": "notebook-b1b8", + "profile": { + "de_type": "Notebook", + "description": "multi engine, cpu, python 3.6 for notebook", + "flavor_type": "CPU", + "id": "Multi-Engine 1.0 (python3)-cpu", + "name": "Multi-Engine 1.0 (python3)-cpu", + "provision": { + "annotations": { + "category": "Multi-Engine 1.0 (Python3, Recommended)", + "type": "system" + }, + "spec": { + "engine": "CCE", + "params": { + "annotations": null, + "image_name": "mul-kernel-cpu-cp36", + "image_tag": "2.0.5-B003", + "namespace": "atelier" + } + }, + "type": "Docker" + } + }, + "spec": { + "annotations": { + "target_domain": "https://xxx", + "url": "" + }, + "auto_stop": { + "duration": 3600, + "enable": true, + "prompt": true + }, + "extend_params": null, + "failed_reasons": null, + "repository": null, + "storage": { + "location": { + "path": "/home/ma-user/work", + "volume_size": 5, + "volume_unit": "GB" + }, + "type": "evs" + } + }, + "status": "STOPPED", + "user": { + "id": "15dda26361214ca2a5953917d2f48ffb", + "name": "ops_dev_env" + }, + "workspace": { + "id": "0" + } + }], + "total_count": 2 + } + +Status Code +----------- + +For details about the status code, see `Status Code <../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/devenviron/querying_the_authentication_information_of_a_development_environment_instance.rst b/api-ref/source/devenviron/querying_the_authentication_information_of_a_development_environment_instance.rst new file mode 100644 index 0000000..fd4f2b3 --- /dev/null +++ b/api-ref/source/devenviron/querying_the_authentication_information_of_a_development_environment_instance.rst @@ -0,0 +1,81 @@ +Querying the Authentication Information of a Development Environment Instance +============================================================================= + +Function +-------- + +This API is used to query the authentication information of a development environment instance, which is used to open the development environment instance. + +URI +--- + +GET /v1/{project_id}/demanager/instances/{instance_id}/token + +`Table 1 <#modelarts030109enustopic0136223948table569625523811>`__ describes the required parameters. + +.. _modelarts030109enustopic0136223948table569625523811: + +.. table:: **Table 1** Parameter description + + +-------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+=========================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | project_id | Yes | String | Project ID | + +-------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_id | Yes | String | Instance ID It is the ID of the development environment instance you create. The instance ID is contained in the response code after the instance has been created. For details, see `Creating a Development Environment Instance <../devenviron/creating_a_development_environment_instance.html#modelarts030110>`__. If the development environment instance is created on the ModelArts management console, you can view the ID of the instance on the ModelArts management console. | + +-------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030109enustopic0136223948table973120224596>`__ describes the response parameters. + +.. _modelarts030109enustopic0136223948table973120224596: + +.. table:: **Table 2** Parameter description + + ========= ====== ==================== + Parameter Type Description + ========= ====== ==================== + token String Authentication token + ========= ====== ==================== + +Samples +------- + +The following shows how to obtain the authentication token of instance **6fa459ea-ee8a-3ca4-894e-db77e160355e**. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/demanager/instances/6fa459ea-ee8a-3ca4-894e-db77e160355e/token + +- Successful sample response + + .. code-block:: + + { + "token": "7211546f57cd432790643bb6612da19d" + } + +- Failed sample response + + .. code-block:: + + { + "error_message": "The instance does not exist.", + "error_code": "ModelArts.6309" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/devenviron/querying_the_details_about_a_development_environment_instance.rst b/api-ref/source/devenviron/querying_the_details_about_a_development_environment_instance.rst new file mode 100644 index 0000000..b3ab65c --- /dev/null +++ b/api-ref/source/devenviron/querying_the_details_about_a_development_environment_instance.rst @@ -0,0 +1,559 @@ +Querying the Details About a Development Environment Instance +============================================================= + +Function +-------- + +This API is used to query the details about a development environment instance. + +URI +--- + +GET /v1/{project_id}/demanager/instances/{instance_id} + +`Table 1 <#modelarts030112enustopic0136223951table569625523811>`__ describes the required parameters. + +.. _modelarts030112enustopic0136223951table569625523811: + +.. table:: **Table 1** Parameters + + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_id | Yes | String | Instance ID | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030112enustopic0136223951table1282791914324>`__ describes the response parameters. + +.. _modelarts030112enustopic0136223951table1282791914324: + +.. table:: **Table 2** Parameters + + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=========================+========+========================================================================================================================================+ + | id | String | Instance ID | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Instance name | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Instance description | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Instance status | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | creation_timestamp | String | Time when an instance is created | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | profile | Object | Configuration information. For details, see `Table 3 <#modelarts030112enustopic0136223951table91791695387>`__. | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | String | Instance flavor | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | spec | Object | Instance specifications of the notebook type. For details, see `Table 11 <#modelarts030112enustopic0136223951table115411254165418>`__. | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | workspace | Object | Workspace. For details, see `Table 16 <#modelarts030112enustopic0136223951table82085111012>`__. | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | latest_update_timestamp | String | Time when an instance is modified | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | flavor_details | Object | Flavor details. See `Table 7 <#modelarts030112enustopic0136223951table15315195310273>`__. | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | pool | Object | Dedicated resource pool. See `Table 8 <#modelarts030112enustopic0136223951table1757552712913>`__. | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | ai_project | Object | AI project. For details, see `Table 9 <#modelarts030112enustopic0136223951responseaiproject>`__. | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code. For details, see `Error Codes <../common_parameters/error_codes.html>`__. | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | queuing_info | Object | Queuing information. For details, see `Table 17 <#modelarts030112enustopic0136223951table1535133818408>`__. | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + | user | Object | User information. For details, see `Table 18 <#modelarts030112enustopic0136223951table478950164319>`__. | + +-------------------------+--------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table91791695387: + +.. table:: **Table 3** **profile** parameters + + +-------------+--------------------+--------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+====================+==============================================================================================================+ + | id | String | Configuration ID | + +-------------+--------------------+--------------------------------------------------------------------------------------------------------------+ + | name | String | Configuration name | + +-------------+--------------------+--------------------------------------------------------------------------------------------------------------+ + | description | String | Configuration description | + +-------------+--------------------+--------------------------------------------------------------------------------------------------------------+ + | de_type | String | Development environment type. Only **Notebook** is supported. | + +-------------+--------------------+--------------------------------------------------------------------------------------------------------------+ + | provision | Object | Deployment information. For details, see `Table 4 <#modelarts030112enustopic0136223951table108415111491>`__. | + +-------------+--------------------+--------------------------------------------------------------------------------------------------------------+ + | labels | Map | Label information | + +-------------+--------------------+--------------------------------------------------------------------------------------------------------------+ + | flavor_type | String | Hardware, which can be **CPU**, **GPU**, or **Ascend**. | + +-------------+--------------------+--------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table108415111491: + +.. table:: **Table 4** **provision** parameters + + +-----------+--------+----------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+==========================================================================================================+ + | type | String | Deployment type. Only **Docker** is supported. | + +-----------+--------+----------------------------------------------------------------------------------------------------------+ + | spec | Object | Deployment details. For details, see `Table 5 <#modelarts030112enustopic0136223951table368911231548>`__. | + +-----------+--------+----------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table368911231548: + +.. table:: **Table 5** **spec** parameters + + +-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+===========================================================================================================================================+ + | engine | String | Deployment engine. Only **CCE** is supported. | + +-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | params | Object | Deployment parameters. Only **Docker** is supported. For details, see `Table 6 <#modelarts030112enustopic0136223951table932452015018>`__. | + +-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table932452015018: + +.. table:: **Table 6** Docker deployment parameters + + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+====================+=====================================================================================+ + | namespace | String | SWR organization name, which is globally unique | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | image_name | String | Image name | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | image_tag | String | Image tag | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + | annotations | Map | Label information, which can be extended. By default, this parameter is left blank. | + +-------------+--------------------+-------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table15315195310273: + +.. table:: **Table 7** **flavor_details** parameters + + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================+ + | name | String | Flavor name | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | status | String | Flavor sale status The options are as follows: | + | | | | + | | | - **onSale** | + | | | - **soldOut** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | queuing_num | Integer | This parameter is mandatory when **promo_type** is set to **Free** and **status** is set to **soldOut**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | queue_left_time | Integer | Left queuing time, in seconds | + | | | | + | | | This parameter is mandatory when **promo_type** is set to **Free** and **status** is set to **soldOut**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | storage_list | Array | Supported storage type. The options are **obs**, **evs**, and **efs**. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | is_permitted | Boolean | Whether the current user has the permission to use this flavor | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | type | String | Flavor status. The options are as follows: | + | | | | + | | | - **GPU** | + | | | - **CPU** | + | | | - **ASCEND** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | params | Dict | Parameters that describing flavor | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | promo_type | String | Promotion type. The options are as follows: | + | | | | + | | | - **Free** | + | | | - **NoDiscount** | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | instance_num | Integer | Number of instances of this flavor the current created | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | duration | Integer | Auto stop time after startup, in seconds | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | store_time | Integer | Maximum retention period of an inactive instance of this flavor in the database, in hours | + | | | | + | | | The default value is **-1**, indicating that the instance can be permanently saved. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | billing_flavor | String | Billing specifications. If this field is left blank, the specifications name is used for billing. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + | billing_params | Integer | Billing ratio This parameter is mandatory when **billing_flavor** is specified. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table1757552712913: + +.. table:: **Table 8** **pool** parameters + + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+==============================================================================================================================================================+ + | id | String | ID of a resource pool | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Name of a resource pool | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Type of a resource pool. **USER_DEFINED** indicates a dedicated resource pool. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | owner | Object | This parameter is mandatory when **type** is set to **USER_DEFINED**. For details, see `Table 10 <#modelarts030112enustopic0136223951table1532233153818>`__. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951responseAIProject: + +.. table:: **Table 9** **AIProject** parameters + + ========= ====== ============= + Parameter Type Description + ========= ====== ============= + id String AI project ID + ========= ====== ============= + + + +.. _modelarts030112enustopic0136223951table1532233153818: + +.. table:: **Table 10** **owner** parameters + + ========== ====== =========== + Parameter Type Description + ========== ====== =========== + project_id String Project ID + ========== ====== =========== + + + +.. _modelarts030112enustopic0136223951table115411254165418: + +.. table:: **Table 11** **notebook** parameters + + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+=======================================================================================================================================================================================================================================================================+ + | log_path | String | Path for storing custom image logs | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | custom_script_path | String | Path for storing custom initialization scripts used when a notebook instance is started | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | storage | Object | Storage path. For details, see `Table 20 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table9228954163219>`__. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | credential | Object | AK and SK for accessing OBS. For details, see `Table 30 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table970685216555>`__. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | repository | Object | Git repository information. For details, see `Table 28 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table63971252184512>`__. This parameter cannot be used. It is automatically returned when the API is called. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource_reserved_timestamp | Integer | Time when the resource is reserved | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | auto_stop | Object | Auto stop parameter. For details, see `Table 23 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table14279174582613>`__. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | failed_reasons | Object | Cause for a creation or startup failure. For details, see `Table 22 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table72771614152013>`__. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | annotations | Map | Annotations | + | | | | + | | | The generated URL cannot be directly accessed. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | extend_params | Map | Extended parameter | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table9228954163219: + +.. table:: **Table 12** **storage** parameters + + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+================================================================================================================================================================================================================================================================+ + | type | String | Storage type. | + | | | | + | | | Only **obs** and **evs** are supported. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | location | Object | Storage location. If **type** is set to **obs**, this parameter is mandatory. See `Table 21 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table212131963416>`__. By default, this parameter is left blank. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table212131963416: + +.. table:: **Table 13** **location** parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=============================================================================================================================================================================================================================================+ + | path | String | Storage path | + | | | | + | | | - If **type** is set to **obs**, this parameter is mandatory. The value must be a valid OBS bucket path and end with a slash (/). The value must be a specific directory in an OBS bucket rather than the root directory of an OBS bucket. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | volume_size | Integer | If **type** is set to **obs**, this parameter does not need to be set. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table14279174582613: + +.. table:: **Table 14** **auto_stop** parameters + + +----------------+---------+---------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+=========+=======================================================================================+ + | enable | Boolean | Whether to enable the auto stop function | + +----------------+---------+---------------------------------------------------------------------------------------+ + | duration | Integer | Running duration, in seconds | + +----------------+---------+---------------------------------------------------------------------------------------+ + | prompt | Boolean | Whether to display a prompt again. This parameter is provided for the console to use. | + +----------------+---------+---------------------------------------------------------------------------------------+ + | stop_timestamp | Integer | Time when the instance stops. The value is a 13-digit timestamp. | + +----------------+---------+---------------------------------------------------------------------------------------+ + | remain_time | Integer | Remaining time before actual stop, in seconds | + +----------------+---------+---------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table72771614152013: + +.. table:: **Table 15** **failed_reasons** parameters + + ========= ================== ============= + Parameter Type Description + ========= ================== ============= + code String Error code + message String Error message + detail Map Error details + ========= ================== ============= + + + +.. _modelarts030112enustopic0136223951table82085111012: + +.. table:: **Table 16** **workspace** parameters + + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+================================================================================================================================+ + | id | String | Workspace ID If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. | + +-----------+--------+--------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table1535133818408: + +.. table:: **Table 17** **queuing_info** parameters + + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================================================================================================================================================+ + | id | String | Instance ID | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Instance name | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | de_type | String | Development environment type. By default, all types are returned. | + | | | | + | | | Only **Notebook** is supported. | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | String | Instance flavor. By default, all types are returned. | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor_details | Object | Flavor details, which display the flavor information and whether the flavor is sold out For details, see `Table 16 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table15315195310273>`__. | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Instance status. By default, all statuses are returned, including: | + | | | | + | | | - **CREATE_QUEUING** | + | | | - **START_QUEUING** | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | begin_timestamp | Integer | Time when an instance starts queuing. The value is a 13-digit timestamp. | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | remain_time | Integer | Left queuing time, in seconds | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | end_timestamp | Integer | Time when an instance completes queuing. The value is a 13-digit timestamp. | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | rank | Integer | Ranking of an instance in a queue | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table478950164319: + +.. table:: **Table 18** **user** parameters + + ========= ====== =========== + Parameter Type Description + ========= ====== =========== + id String User ID + name String Username + ========= ====== =========== + + + +.. _modelarts030112enustopic0136223951table63971252184512: + +.. table:: **Table 19** **repository** parameters + + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=================+========+====================================================================================================================================================================================+ + | id | String | Repository ID | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | branch | String | Repository branch | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_name | String | Repository username | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_email | String | Repository user mailbox | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | String | Repository type. The options are **CodeClub** and **GitHub**. | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | connection_info | Object | Repository link information. For details, see `Table 29 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table13487192116490>`__. | + +-----------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table13487192116490: + +.. table:: **Table 20** **connection_info** parameters + + +------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +============+========+==============================================================================================================================================================================+ + | protocol | String | Repository link protocol. The options are **ssh** and **https**. | + +------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | url | String | Repository link address | + +------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | credential | Object | Certificate information. For details, see `Table 30 <../devenviron/creating_a_development_environment_instance.html#modelarts030110enustopic0136223949table970685216555>`__. | + +------------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030112enustopic0136223951table970685216555: + +.. table:: **Table 21** **credential** parameters + + =============== ====== ======================= + Parameter Type Description + =============== ====== ======================= + ssh_private_key String SSH private certificate + access_token String OAuth token of GitHub + =============== ====== ======================= + +Samples +------- + +The following shows how to obtain the details about instance **6fa459ea-ee8a-3ca4-894e-db77e160355e**. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/demanager/instances/6fa459ea-ee8a-3ca4-894e-db77e160355e + +- Successful sample response + + .. code-block:: + + { + "ai_project": { + "id": "default-ai-project" + }, + "creation_timestamp": "1594887749962", + "description": "", + "flavor": "modelarts.bm.gpu.v100NV32", + "flavor_details": { + "name": "modelarts.bm.gpu.v100NV32", + "params": { + "CPU": 8, + "GPU": 1, + "gpu_type": "v100NV32", + "memory": "64GiB" + }, + "status": "onSale", + "type": "GPU" + }, + "id": "DE-7d558ef8-c73d-11ea-964c-0255ac100033", + "latest_update_timestamp": "1594888070775", + "name": "notebook-c6fd", + "profile": { + "de_type": "Notebook", + "description": "multi engine, gpu, python 3.6 for notebook", + "flavor_type": "GPU", + "id": "Multi-Engine 1.0 (python3)-gpu", + "name": "Multi-Engine 1.0 (python3)-gpu", + "provision": { + "annotations": { + "category": "Multi-Engine 1.0 (python3)", + "type": "system" + }, + "spec": { + "engine": "CCE", + "params": { + "annotations": null, + "image_name": "mul-kernel-gpu-cuda-cp36", + "image_tag": "2.0.5-B003", + "namespace": "atelier" + } + }, + "type": "Docker" + } + }, + "spec": { + "annotations": { + "target_domain": "https://xxx", + "url": "https://xxx:32000/modelarts/hubv100/notebook/user/DE-7d558ef8-c73d-11ea-964c-0255ac100033" + }, + "auto_stop": { + "duration": 3600, + "enable": true, + "prompt": true, + "remain_time": 3336, + "stop_timestamp": 1594891408723 + }, + "extend_params": null, + "failed_reasons": null, + "repository": null, + "extend_storage": null, + "storage": { + "location": { + "path": "/home/ma-user/work", + "volume_size": 5, + "volume_unit": "GB" + }, + "type": "evs" + } + }, + "status": "RUNNING", + "user": { + "id": "15dda26361214ca2a5953917d2f48ffb", + "name": "ops_dev_env" + }, + "workspace": { + "id": "0" + } + } + +- Failed sample response + + .. code-block:: + + { + "error_message": "The instance does not exist.", + "error_code": "ModelArts.6309" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/devenviron/restarting_an_ml_studio_instance.rst b/api-ref/source/devenviron/restarting_an_ml_studio_instance.rst new file mode 100644 index 0000000..7f85144 --- /dev/null +++ b/api-ref/source/devenviron/restarting_an_ml_studio_instance.rst @@ -0,0 +1,92 @@ +Restarting an ML Studio Instance +================================ + +Function +-------- + +This API is used to restart an ML Studio development environment instance. + +URI +--- + +POST /v1/{project_id}/demanager/instances/{instance_id}/action + +`Table 1 <#modelarts030152enustopic0181453353table569625523811>`__ describes the required parameters. + + + +.. _modelarts030152enustopic0181453353table569625523811: + +.. table:: **Table 1** Parameter description + + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_id | Yes | String | Instance ID | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030152enustopic0181453353table46411941555>`__ describes the request parameters. + + + +.. _modelarts030152enustopic0181453353table46411941555: + +.. table:: **Table 2** Parameter description + + +-----------+-----------+--------+--------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+================================================================================+ + | action | Yes | String | Operation on a development environment instance. The value can be **restart**. | + +-----------+-----------+--------+--------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030152enustopic0181453353table1399617427385>`__ describes the response parameters. + + + +.. _modelarts030152enustopic0181453353table1399617427385: + +.. table:: **Table 3** Parameter description + + ============== ====== ============================== + Parameter Type Description + ============== ====== ============================== + current_status String Current status of an instance + previous_state String Previous status of an instance + ============== ====== ============================== + +Samples +------- + +The following shows how to restart the ML Studio instance whose ID is **47cf4ff3-0c59-44fe-9821-2840a34c02a9**. + +- Sample request + + .. code-block:: + + { + "action": "restart" + } + +- Sample response + + .. code-block:: + + { + "current_status": "REBOOTING", + "previous_state": "ACTIVE" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/index.rst b/api-ref/source/index.rst new file mode 100644 index 0000000..d6470ac --- /dev/null +++ b/api-ref/source/index.rst @@ -0,0 +1,20 @@ +========== +Main Index +========== + +.. toctree:: + :maxdepth: 1 + + before_you_start/index + api_overview + calling_apis/index + devenviron/index + data_management/index + training_management/index + model_management/index + service_management/index + authorization_management/index + workspace_management/index + application_cases/index + common_parameters/index + change_history diff --git a/api-ref/source/model_management/index.rst b/api-ref/source/model_management/index.rst new file mode 100644 index 0000000..67d3b0c --- /dev/null +++ b/api-ref/source/model_management/index.rst @@ -0,0 +1,8 @@ +================ +Model Management +================ + +.. toctree:: + :maxdepth: 1 + + models/index diff --git a/api-ref/source/model_management/models/deleting_a_model.rst b/api-ref/source/model_management/models/deleting_a_model.rst new file mode 100644 index 0000000..7dd4553 --- /dev/null +++ b/api-ref/source/model_management/models/deleting_a_model.rst @@ -0,0 +1,106 @@ +Deleting a Model +================ + +Function +-------- + +This API is used to delete a model based on the model ID. When **cascade** is set to **true**, the model specified by the model ID and models of different versions with the same name as the specified model are deleted. By default, only the model with the specified model ID is deleted. + +URI +--- + +DELETE /v1/{project_id}/models/{model_id} + +`Table 1 <#modelarts030079enustopic0130168819table16518993181628>`__ describes the required parameters. + +.. _modelarts030079enustopic0130168819table16518993181628: + +.. table:: **Table 1** Parameter description + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | Yes | String | ID of the model to be deleted | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030079enustopic0130168819table2918868102420: + +.. table:: **Table 2** Parameter description + + +-----------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+=========+================================================================================================================================================================================================================================================================================================================================================+ + | cascade | No | Boolean | The default value is **false**, indicating that only the model with the specified model ID is deleted. The value **true** indicates that not only the model with the specified model ID but also all models with the same name but different versions as the specified model will be deleted. A maximum of 20 models can be deleted at a time. | + +-----------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 3 <#modelarts030079enustopic0130168819table1954662185412>`__ describes the response parameters. + +.. _modelarts030079enustopic0130168819table1954662185412: + +.. table:: **Table 3** Parameter description + + +---------------------+---------------------------------+-------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=====================+=================================+===============================================================================================================================+ + | delete_success_list | String array | ID list of models successfully deleted | + +---------------------+---------------------------------+-------------------------------------------------------------------------------------------------------------------------------+ + | delete_failed_list | **DeleteModelFailResult** array | List of models that fail to be deleted. For details, see `Table 4 <#modelarts030079enustopic0130168819table1198992710540>`__. | + +---------------------+---------------------------------+-------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030079enustopic0130168819table1198992710540: + +.. table:: **Table 4** **DeleteModelFailResult** parameters + + ============= ====== ====================================== + Parameter Type Description + ============= ====== ====================================== + model_id String ID of a model that fails to be deleted + error_code String Error code of the deletion failure + error_message String Error message of the deletion failure + ============= ====== ====================================== + +Samples +------- + +The following shows how to delete the model whose ID is **023e90be-7e2a-4169-bab4-1bc34ff0ca45** and all models of the same name but different versions. + +- Sample request + + .. code-block:: + + DELETE https://endpoint/v1/{project_id}/models/023e90be-7e2a-4169-bab4-1bc34ff0ca45?cascade=true + +- Sample response + + .. code-block:: + + { + "delete_success_list": ["fc9e88a1-0005-40b3-867e-7aee61449aeb", "f3f3ba0e-f073-454e-9e3f-14b7d786f45e"], + "delete_failed_list": [ + { + "model_id": "759645d9-3672-4db1-bb6d-49ed58b84e10", + "error_code": "ModelArts.3009", + "error_message": "Failed to delete model, model (759645d9-3672-4db1-bb6d-49ed58b84e10) already deploy service." + }] + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/model_management/models/importing_a_model.rst b/api-ref/source/model_management/models/importing_a_model.rst new file mode 100644 index 0000000..d039e6d --- /dev/null +++ b/api-ref/source/model_management/models/importing_a_model.rst @@ -0,0 +1,355 @@ +Importing a Model +================= + +Function +-------- + +You can use the API to import a model. + +Ensure that the execution code and model have been uploaded to OBS. By default, the models generated by a training job are stored in OBS. + +URI +--- + +POST /v1/{project_id}/models + +`Table 1 <#modelarts030076enustopic0130147365table16518993181628>`__ describes the required parameters. + +.. _modelarts030076enustopic0130147365table16518993181628: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030076enustopic0130147365table24514577587>`__ describes the request parameters. + +.. _modelarts030076enustopic0130147365table24514577587: + +.. table:: **Table 2** Parameters + + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+===========+======================+=======================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | model_name | Yes | String | Model name. Enter 1 to 64 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_version | Yes | String | Model version in the format of *Digit.Digit.Digit*. The value range of the digits is [1, 99]. Note that no part of the version number can start with 0. For example, **01.01.01** is not allowed. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_location | Yes | String | OBS path where the model is located or the SWR image location | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_job_id | No | String | ID of the source training job. If the model is generated from a training job, input this parameter for source tracing. If the model is imported from a third-party meta model, leave this parameter blank. By default, this parameter is left blank. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_job_version | No | String | Version of the source training job. If the model is generated from a training job, input this parameter for source tracing. If the model is imported from a third-party meta model, leave this parameter blank. By default, this parameter is left blank. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_type | No | String | Model source type. The value can only be **auto**, which indicates ExeML models (model download is not supported). If a model is deployed through a training job, this parameter is left blank by default. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_type | Yes | String | Model type. The value can be **TensorFlow**, **MXNet**, **Caffe**, **Spark_MLlib**, **Scikit_Learn**, **XGBoost**, **Image**, **PyTorch**, or **Template**, which is read from the configuration file. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | runtime | No | String | For details about **runtime** options, see **Model Management** > **Importing a Model** > **Importing a Meta Model from OBS** in *ModelArts User Guide*. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Model remarks. The value contains a maximum of 100 characters and cannot contain the following special characters and more: &!'\"<>= | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_algorithm | No | String | Model algorithm. If the algorithm is read from the configuration file, this parameter can be left blank. For example, the value can be **predict_analysis**, **object_detection**, or **image_classification**. The value must start with a letter and contain no more than 36 characters. Chinese characters and special characters (&!'\"<>=) are not allowed. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | execution_code | No | String | OBS path for storing the execution code. By default, this parameter is left blank. The name of the execution code file is fixed to **customize_service.py**. The inference code file must be stored in the **model** directory. If this parameter is left blank, the system can automatically identify the inference code in the **model** directory. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | input_params | No | **params** array | Collection of input parameters of a model. By default, this parameter is left blank. For details, see `Table 3 <#modelarts030076enustopic0130147365table01082501075>`__. If the collection of input parameters is read from **apis** in the configuration file, you only need to provide the **initial_config** field and do not need to set **input_params**. **input_params** is optional when the **initial_config** field exists. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | output_params | No | **params** array | Collection of output parameters of a model. By default, this parameter is left blank. For details, see `Table 3 <#modelarts030076enustopic0130147365table01082501075>`__. If the collection of output parameters is read from **apis** in the configuration file, you only need to provide the **initial_config** field and do not need to set **output_params**. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dependencies | No | **dependency** array | Package required for inference code and model. By default, this parameter is left blank. If the package is read from the configuration file, this parameter can be left blank. `Table 4 <#modelarts030076enustopic0130147365table649013511785>`__ shows the dependency structure. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_metrics | No | String | Model precision, which is read from the configuration file | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | apis | No | **apis** array | All **apis** input and output parameters of the model. If the parameters are read from the configuration file, this parameter can be left blank. For details, see `Table 10 <#modelarts030076enustopic0130147365table53974919117>`__. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | initial_config | No | String | Character string converted from the final model configuration file. It is recommended that the **initial_config** file be used to provide information about the fields such as **apis**, **dependencies**, **input_params**, and **output_params**. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | ID of the workspace to which a service belongs. The default value is **0**, indicating the default workspace. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_docs | No | **doc** array | List of model description documents. A maximum of three documents are supported. For details, see `Table 7 <#modelarts030076enustopic0130147365table9739172671118>`__. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | install_type | No | String array | Deployment type. Only lowercase letters are supported. The value can be **real-time**, or **batch**. Default value: [**real-time**, **batch**] | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | template | No | Template object | Template configuration items. This parameter is mandatory when **model_type** is set to **Template**. For details, see `Table 8 <#modelarts030076enustopic0130147365table89901124131016>`__. | + +--------------------+-----------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030076enustopic0130147365table01082501075: + +.. table:: **Table 3** **params** parameters + + +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+========================================================================================================================================================+ + | url | Yes | String | API URL | + +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | method | Yes | String | Request method. Possible values are **post** and **get**. | + +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | protocol | Yes | String | Request protocol | + +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | param_name | Yes | String | Parameter name. It is recommended that the parameter name contain a maximum of 64 characters. | + +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | param_type | Yes | String | Parameter type. The value can be **int**, **string**, **float**, **timestamp**, **date**, or **file**. | + +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | min | No | Number | This parameter is optional when **param_type** is set to **int** or **float**. By default, this parameter is left blank. | + +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | max | No | Number | This parameter is optional when **param_type** is set to **int** or **float**. By default, this parameter is left blank. | + +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | param_desc | No | String | Parameter description. It is recommended that the parameter description contain a maximum of 100 characters. By default, this parameter is left blank. | + +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030076enustopic0130147365table649013511785: + +.. table:: **Table 4** **dependency** parameters + + +-----------+-----------+-------------------+-----------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+===================+===============================================+ + | installer | Yes | String | Installation mode. Only **pip** is supported. | + +-----------+-----------+-------------------+-----------------------------------------------+ + | packages | Yes | **package** array | Collection of dependency packages | + +-----------+-----------+-------------------+-----------------------------------------------+ + + + +.. _modelarts030076enustopic0130147365table137621937181116: + +.. table:: **Table 5** **package** parameters + + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+===========+========+====================================================================================================================================================================================+ + | package_name | Yes | String | Name of a dependency package. Ensure that the package name is correct and exists. Chinese characters and special characters (&!'"<>=) are not allowed. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | package_version | No | String | Version of a dependency package. If this parameter is left blank, the latest version is installed by default. Chinese characters and special characters (&!'"<>=) are not allowed. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | restraint | No | String | Version restriction. The value can be **EXACT**, **ATLEAST**, or **ATMOST**. This parameter is mandatory only when **package_version** exists. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030076enustopic0130147365table918415903219: + +.. table:: **Table 6** **metric** parameters + + ========= ========= ====== =========== + Parameter Mandatory Type Description + ========= ========= ====== =========== + f1 No Double F1 score + recall No Double Recall + precision No Double Precision + accuracy No Double Accuracy + ========= ========= ====== =========== + + + +.. _modelarts030076enustopic0130147365table9739172671118: + +.. table:: **Table 7** **doc** parameters + + +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+==============================================================================================================================================+ + | doc_name | Yes | String | Document name, which must start with a letter. Enter 1 to 48 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. | + +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------+ + | doc_url | Yes | String | HTTP(S) link of the document | + +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030076enustopic0130147365table89901124131016: + +.. table:: **Table 8** **Template** parameters + + +-----------------+-----------+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+===========+=================================+==========================================================================================================================================================================+ + | infer_format | No | String | Input and output mode. When this parameter is used, the input and output mode built in the template does not take effect. | + +-----------------+-----------+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | template_id | Yes | String | ID of the used template. The template has a built-in input and output mode. | + +-----------------+-----------+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | template_inputs | Yes | Array of TemplateInputs objects | Template input configuration, specifying the source path for configuring a model. For details, see `Table 9 <#modelarts030076enustopic0130147365table12364181131310>`__. | + +-----------------+-----------+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030076enustopic0130147365table12364181131310: + +.. table:: **Table 9** **template_inputs** parameters + + +-----------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+=========================================================================================================================================================================================================================================================================================================================================+ + | input | Yes | String | Template input path, which can be an OBS file path or OBS directory path. When you use a template with multiple input items to create a model, if the target paths **input_properties** specified in the template are the same, the OBS directory or OBS file name entered here must be unique to prevent files from being overwritten. | + +-----------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | input_id | Yes | String | Input item ID, which is obtained from the template details. | + +-----------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030076enustopic0130147365table53974919117: + +.. table:: **Table 10** **apis** parameters + + +---------------+-----------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===============+===========+============================+=======================================================================================================================================================+ + | input_params | No | **InputParams** structure | Input parameters in **apis**, described in JSON Schema format. For details, see `Table 11 <#modelarts030076enustopic0130147365table116145629>`__. | + +---------------+-----------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | method | No | String | Request method. The options are **POST** and **GET**. | + +---------------+-----------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | output_params | No | **OutputParams** structure | Output parameters in **apis**, described in JSON Schema format. For details, see `Table 12 <#modelarts030076enustopic0130147365table890117461320>`__. | + +---------------+-----------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | protocol | No | String | Request protocol. | + +---------------+-----------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | url | No | String | Inference request URL. | + +---------------+-----------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030076enustopic0130147365table116145629: + +.. table:: **Table 11** **InputParams** parameters + + +------------+-----------+--------------------+-----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+====================+===================================================================================================================================+ + | properties | No | Map | Properties of an object element in JSON Schema. You can set parameters, including the parameter name and type, in **properties**. | + +------------+-----------+--------------------+-----------------------------------------------------------------------------------------------------------------------------------+ + | type | No | String | Type in JSON Schema, which can be **object**. | + +------------+-----------+--------------------+-----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030076enustopic0130147365table890117461320: + +.. table:: **Table 12** **OutputParams** parameters + + +------------+-----------+--------------------+-----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+====================+===================================================================================================================================+ + | properties | No | Map | Properties of an object element in JSON Schema. You can set parameters, including the parameter name and type, in **properties**. | + +------------+-----------+--------------------+-----------------------------------------------------------------------------------------------------------------------------------+ + | type | No | String | Type in JSON Schema, which can be **object**. | + +------------+-----------+--------------------+-----------------------------------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 13 <#modelarts030076enustopic0130147365table88391251102419>`__ describes the response parameters. + +.. _modelarts030076enustopic0130147365table88391251102419: + +.. table:: **Table 13** Parameters + + ========= ====== =========== + Parameter Type Description + ========= ====== =========== + model_id String Model ID + ========= ====== =========== + +Samples +------- + +The following shows how to import a model whose name is **mnist**, version is **1.0.0**, and type is **TensorFlow**. The model file comes from an OBS bucket. + +- Sample request + + .. code-block:: + + POST https://endpoint/v1/{project_id}/models + { + "model_name": "mnist", + "model_version": "1.0.0", + "source_location": "https://models.obs.xxxx.com/mnist", + "source_job_id": "55", + "source_job_version": "V100", + "model_type": "TensorFlow", + "runtime": "python2.7", + "description": "mnist model", + "execution_code": "https://testmodel.obs.xxxx.com/customize_service.py", + "input_params": [ + { + "url": "/v1/xxx/image", + "protocol": "http", + "method": "post", + "param_name": "image_url", + "param_type": "string", + "min": 0, + "max": 9, + "param_desc": "http://test/test.jpeg" + } + ], + "output_params": [ + { + "url": "/v1/xxx/image", + "protocol": "http", + "method": "post", + "param_name": "face_location", + "param_type": "box", + "param_desc": "face_location param value description" + } + ], + "dependencies": [ + { + "installer": "pip", + "packages": [ + { + "package_name": "numpy", + "package_version": "1.5.0", + "restraint": "ATLEAST" + } + ] + } + ], + "model_algorithm": "object_detection", + "model_metrics":"{\"f1\":0.52381,\"recall\":0.666667,\"precision\":0.466667,\"accuracy\":0.625}", + "apis": [ + { + "url": "/v1/xxx/image", + "protocol": "http", + "method": "post", + "input_params": { + "type": "object", + "properties": { + "image_url": { + "type": "string" + } + } + }, + "output_params": { + "type": "object", + "properties": { + "face_location": { + "type": "box" + } + } + } + } + ] + } + +- Sample response + + .. code-block:: + + { + "model_id": "10eb0091-887f-4839-9929-cbc884f1e20e" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/model_management/models/index.rst b/api-ref/source/model_management/models/index.rst new file mode 100644 index 0000000..d8f6d89 --- /dev/null +++ b/api-ref/source/model_management/models/index.rst @@ -0,0 +1,11 @@ +====== +Models +====== + +.. toctree:: + :maxdepth: 1 + + importing_a_model + querying_a_model_list + querying_the_details_about_a_model + deleting_a_model diff --git a/api-ref/source/model_management/models/querying_a_model_list.rst b/api-ref/source/model_management/models/querying_a_model_list.rst new file mode 100644 index 0000000..32dfe17 --- /dev/null +++ b/api-ref/source/model_management/models/querying_a_model_list.rst @@ -0,0 +1,212 @@ +Querying a Model List +===================== + +Function +-------- + +This API is used to query the models that meet the search criteria. + +URI +--- + +GET /v1/{project_id}/models + +`Table 1 <#modelarts030077enustopic0130168816table16518993181628>`__ describes the required parameters. + +.. _modelarts030077enustopic0130168816table16518993181628: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030077enustopic0130168816table2918868102420: + +.. table:: **Table 2** Search parameters + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+======================================================================================================================================================================================================================================================+ + | model_name | No | String | Model name. Fuzzy match is supported. | + | | | | | + | | | | .. note:: | + | | | | | + | | | | If a model name contains an underscore (_), add the **exact_match** parameter to the request and set the parameter value to **true** because the underscore needs to be escaped. This ensures that the query operation can be performed properly. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_version | No | String | Model version | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_status | No | String | Model status. You can query models based on the model status. Options: | + | | | | | + | | | | - **Publishing** | + | | | | - **Published** | + | | | | - **Failed** | + | | | | - **Building** | + | | | | - **Building_failed** | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_type | No | String | Model type. The models of this type are queried. **model_type** and **not_model_type** are mutually exclusive and cannot co-exist. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | not_model_type | No | String | Model type. A list of models of types except for this type are queried. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Description. Fuzzy match is supported. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Index of the page to be queried. Default value: **0** | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | limit | No | Integer | Maximum number of records returned on each page. The default value is **100**. The recommended value ranges from 10 to 50. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Sorting mode. The value can be **create_at**, **model_version**, or **model_size**. Default value: **create_at** | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting order. The value can be **asc** or **desc**, indicating ascending or descending order. Default value: **desc** | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | ID of the workspace to which a service belongs. The default value is **0**, indicating the default workspace. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 3 <#modelarts030077enustopic0130168816table1954662185412>`__ describes the response parameters. + +.. _modelarts030077enustopic0130168816table1954662185412: + +.. table:: **Table 3** Parameters + + +-------------+-----------------+-------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+=================+=======================================================================================================+ + | total_count | Integer | Total number of models that meet the search criteria when no paging is implemented | + +-------------+-----------------+-------------------------------------------------------------------------------------------------------+ + | count | Integer | Number of models | + +-------------+-----------------+-------------------------------------------------------------------------------------------------------+ + | models | **model** array | Model metadata. For details, see `Table 4 <#modelarts030077enustopic0130168816table1198992710540>`__. | + +-------------+-----------------+-------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030077enustopic0130168816table1198992710540: + +.. table:: **Table 4** **model** parameters + + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=========================+=============================================================================================================================================================================================================================================+ + | model_id | String | Model ID | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_name | String | Model name | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_version | String | Model version | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_status | String | Model status | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_type | String | Model type. The value can be **TensorFlow**, **MXNet**, **Caffe**, **Spark_MLlib**, **Scikit_Learn**, **XGBoost**, **MindSpore**, **Image**, or **PyTorch**. | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_size | Long | Model size, in bytes | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | tenant | String | Tenant to which a model belongs | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project | String | Project to which a model belongs | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | owner | String | User to which a model belongs | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_at | Long | Time when a model is created, in milliseconds calculated from 1970.1.1 0:0:0 UTC | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Model description | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_type | String | Model source type. This parameter is valid only when a model is deployed through ExeML. The value is **auto**. You do not need to set this parameter for a model deployed through a training job. By default, this parameter is left blank. | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | Workspace ID | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_source | String | Model source. Options: | + | | | | + | | | - **algos**: built-in algorithm | + | | | - **custom**: custom model | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | tunable | Boolean | Whether a model can be tuned. Options: | + | | | | + | | | - **true**: yes | + | | | - **false**: no | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | market_flag | Boolean | Whether a model is subscribed from the marketplace. Options: | + | | | | + | | | - **true**: yes | + | | | - **false**: no | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | publishable_flag | Boolean | Whether a model can be published to the marketplace. Options: | + | | | | + | | | - **true**: yes | + | | | - **false**: no | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | install_type | String array | Model deployment type, determining which service a model can be deployed as. The example value is **real-time** (real-time service). | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | subscription_id | String | Model subscription ID. | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | extra | String | Extended field. | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | specification | Specification structure | Minimum deployment specifications. For details, see `Table 5 <#modelarts030077enustopic0130168816table1669514411217>`__. | + +-----------------------+-------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030077enustopic0130168816table1669514411217: + +.. table:: **Table 5** **Specification** parameters + + ========== ====== ============================= + Parameter Type Description + ========== ====== ============================= + min_cpu String Minimal CPU specifications + min_gpu String Minimal GPU specifications + min_memory String Minimum memory capacity + min_ascend String Minimal Ascend specifications + ========== ====== ============================= + +Samples +------- + +The following shows how to query models. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/models + +- Sample response + + .. code-block:: + + { + "total_count": 1, + "count": 1, + "models": [ + { + "model_name": "mnist", + "model_version": "1.0.0", + "model_id": "10eb0091-887f-4839-9929-cbc884f1e20e", + "model_type": "tensorflow", + "model_size": 5012312, + "tenant": "6d28e85aa78b4e1a9b4bd83501bcd4a1", + "project": "d04c10db1f264cfeb1966deff1a3527c", + "owner": "6d28e85aa78b4e1a9b4bd83501bcd4a1", + "create_at": 1533041553000, + "description": "mnist model", + "workspace_id": "0", + "specification":{} + } + ] + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/model_management/models/querying_the_details_about_a_model.rst b/api-ref/source/model_management/models/querying_the_details_about_a_model.rst new file mode 100644 index 0000000..73eaf3f --- /dev/null +++ b/api-ref/source/model_management/models/querying_the_details_about_a_model.rst @@ -0,0 +1,315 @@ +Querying the Details About a Model +================================== + +Function +-------- + +This API is used to query details about a model based on the model ID. + +URI +--- + +GET /v1/{project_id}/models/{model_id} + +`Table 1 <#modelarts030078enustopic0130168817table16518993181628>`__ describes the required parameters. + +.. _modelarts030078enustopic0130168817table16518993181628: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | Yes | String | Model ID | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030078enustopic0130168817table4203102214310>`__ describes the response parameters. + +.. _modelarts030078enustopic0130168817table4203102214310: + +.. table:: **Table 2** Parameters + + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=========================+===================================================================================================================================================================================+ + | model_id | String | Model ID | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_name | String | Model name | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_version | String | Model version | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_at | Long | Time when a model is created, in milliseconds calculated from 1970.1.1 0:0:0 UTC | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | tenant | String | Tenant to which a model belongs | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project | String | Project to which a model belongs | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | owner | String | User to which a model belongs | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_location | String | OBS path where the model is located or the SWR image location | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_job_id | String | ID of the source training job | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_job_version | String | Version of the source training job | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_type | String | Model source type. If a model is deployed through ExeML, the value is **auto**. If a model is deployed through a training job or an OBS model file, this parameter is left blank. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_type | String | Model type. The value can be **TensorFlow**, **MXNet**, **Spark_MLlib**, **Scikit_Learn**, **XGBoost**, **MindSpore**, **Image**, or **PyTorch**. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_size | Long | Model size, in bytes | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_status | String | Model status | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | runtime | String | Model runtime environment | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Model description | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | execution_code | String | OBS path for storing the execution code. The name of the execution code file is fixed to **customize_service.py**. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | schema_doc | String | Download address of the model schema file | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | image_address | String | image path generated after model packaging | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | input_params | **params** array | Collection of input parameters of a model. For details, see `Table 3 <#modelarts030078enustopic0130168817table194602271747>`__. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | output_params | **params** array | Collection of output parameters of a model. For details, see `Table 3 <#modelarts030078enustopic0130168817table194602271747>`__. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dependencies | **dependency** array | Package required for running the inference code and model. For details, see `Table 4 <#modelarts030078enustopic0130168817table133086211152>`__. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_metrics | String | Model precision | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | apis | String | All input and output **apis** parameter information of a model, which is obtained from the model preview | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_source | String | Model source. Options: | + | | | | + | | | - **algos**: built-in algorithm | + | | | - **custom**: custom model | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | tunable | Boolean | Whether a model can be tuned. Options: | + | | | | + | | | - **true**: yes | + | | | - **false**: no | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | market_flag | Boolean | Whether a model is subscribed from the marketplace. Options: | + | | | | + | | | - **true**: yes | + | | | - **false**: no | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | publishable_flag | Boolean | Whether a model can be published to the marketplace. Options: | + | | | | + | | | - **true**: yes | + | | | - **false**: no | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_docs | **GuideDoc** array | List of template documents. For details, see `Table 7 <#modelarts030078enustopic0130168817table97301318317>`__. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | health | Health structure | Model health check interface information. For details, see `Table 8 <#modelarts030078enustopic0130168817table6442179484>`__. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_algorithm | String | Model algorithm type. The value can be **predict_analysis**, **object_detection**, or **image_classification**. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_labels | String array | Model label array. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | labels_map | Map | Model label map. The key is fixed to **labels**, and the value is the model label array. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | ID of the workspace to which a service belongs. The default value is **0**, indicating the default workspace. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | install_type | String array | Supported service type for deployment. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | specification | Specification structure | Minimum model deployment specifications. For details, see `Table 9 <#modelarts030078enustopic0130168817table1669514411217>`__. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config | String | Model configurations. | + +-----------------------+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030078enustopic0130168817table194602271747: + +.. table:: **Table 3** **params** parameters + + +------------+--------+--------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +============+========+==========================================================================================================================+ + | url | String | API URL | + +------------+--------+--------------------------------------------------------------------------------------------------------------------------+ + | method | String | Request method, for example, **post** | + +------------+--------+--------------------------------------------------------------------------------------------------------------------------+ + | protocol | String | Request protocol, for example, **HTTP** | + +------------+--------+--------------------------------------------------------------------------------------------------------------------------+ + | param_name | String | Parameter name, which contains a maximum of 64 characters | + +------------+--------+--------------------------------------------------------------------------------------------------------------------------+ + | param_type | String | Parameter type. The value can be **int**, **string**, **float**, **timestamp**, **date**, or **file**. | + +------------+--------+--------------------------------------------------------------------------------------------------------------------------+ + | min | Number | This parameter is optional when **param_type** is set to **int** or **float**. By default, this parameter is left blank. | + +------------+--------+--------------------------------------------------------------------------------------------------------------------------+ + | max | Number | This parameter is optional when **param_type** is set to **int** or **float**. By default, this parameter is left blank. | + +------------+--------+--------------------------------------------------------------------------------------------------------------------------+ + | param_desc | String | Parameter description, which contains a maximum of 100 characters. By default, this parameter is left blank. | + +------------+--------+--------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030078enustopic0130168817table133086211152: + +.. table:: **Table 4** **dependency** parameters + + +-----------+-------------------+-------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+===================+=========================================================================================================================+ + | installer | String | Installer | + +-----------+-------------------+-------------------------------------------------------------------------------------------------------------------------+ + | packages | **package** array | Collection of dependency packages. For details, see `Table 5 <#modelarts030078enustopic0130168817table129439454518>`__. | + +-----------+-------------------+-------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030078enustopic0130168817table129439454518: + +.. table:: **Table 5** **package** parameters + + +-----------------+--------+------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=================+========+==============================================================================+ + | package_name | String | Name of a dependency package | + +-----------------+--------+------------------------------------------------------------------------------+ + | package_version | String | Version of a dependency package | + +-----------------+--------+------------------------------------------------------------------------------+ + | restraint | String | Version restriction. The value can be **EXACT**, **ATLEAST**, or **ATMOST**. | + +-----------------+--------+------------------------------------------------------------------------------+ + + + +.. _modelarts030078enustopic0130168817table21391499440: + +.. table:: **Table 6** **metric** parameters + + ========= ====== =========== + Parameter Type Description + ========= ====== =========== + f1 Double F1 score + recall Double Recall + precision Double Precision + accuracy Double Accuracy + ========= ====== =========== + + + +.. _modelarts030078enustopic0130168817table97301318317: + +.. table:: **Table 7** **GuideDoc** parameters + + ========= ====== ============================ + Parameter Type Description + ========= ====== ============================ + doc_name String Document name + doc_url String HTTP(S) link of the document + ========= ====== ============================ + + + +.. _modelarts030078enustopic0130168817table6442179484: + +.. table:: **Table 8** **Health** parameters + + +-----------------------+--------+------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+========+============================================================================================================+ + | url | String | URL of the health check interface | + +-----------------------+--------+------------------------------------------------------------------------------------------------------------+ + | protocol | String | Request protocol of the health check interface. Only HTTP is supported. | + +-----------------------+--------+------------------------------------------------------------------------------------------------------------+ + | initial_delay_seconds | String | After an instance is started, a health check starts after seconds configured in **initial_delay_seconds**. | + +-----------------------+--------+------------------------------------------------------------------------------------------------------------+ + | timeout_seconds | String | Health check timeout | + +-----------------------+--------+------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030078enustopic0130168817table1669514411217: + +.. table:: **Table 9** **Specification** parameters + + ========== ====== ======================= + Parameter Type Description + ========== ====== ======================= + min_cpu String Minimum CPU + min_gpu String Minimum GPU + min_memory String Minimum memory capacity + min_ascend String Minimum Ascend + ========== ====== ======================= + +Samples +------- + +The following shows how to query details about a model based on the model ID. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/models/{model_id} + +- Sample response + + .. code-block:: + + { + "model_id": "10eb0091-887f-4839-9929-cbc884f1e20e", + "model_name": "mnist", + "model_version": "1.0.0", + "runtime": "python2.7", + "tenant": "6d28e85aa78b4e1a9b4bd83501bcd4a1", + "project": "d04c10db1f264cfeb1966deff1a3527c", + "owner": "6d28e85aa78b4e1a9b4bd83501bcd4a1", + "source_location": "https://models.obs.xxxx.com/mnist", + "model_type": "TensorFlow", + "model_size": 5633481, + "model_status": "published", + "execution_code": "https://testmodel.obs.xxxx.com/customize_service.py", + "image_address": "100.125.5.235:20202/models/10eb0091-887f-4839-9929-cbc884f1e20e:1.0.0", + "input_params": [{ + "url": "/", + "method": "post", + "protocol": "http", + "param_name": "data", + "param_type": "object", + "param_desc": "{\"type\":\"object\",\"properties\":{\"req_data\":{\"items\":[{\"type\":\"object\",\"properties\":{}}],\"type\":\"array\"}}}" }], + "output_params": [{ + "url": "/", + "method": "post", + "protocol": "http", + "param_name": "data", + "param_type": "object", + "param_desc": "{\"type\":\"object\",\"properties\":{\"resp_data\":{\"type\":\"array\",\"items\":[{\"type\":\"object\",\"properties\":{}}]}}}" }], + "dependencies": [{ + "installer": "pip", + "packages": [{ + "package_name": "pkg1", + "package_version": "1.0.1", + "restraint": "ATLEAST" + }] + }], + "model_metrics":"{\"f1\":0.52381,\"recall\":0.666667,\"precision\":0.466667,\"accuracy\":0.625}", + "apis": "[{\"protocol\":\"http\",\"method\":\"post\",\"url\":\"/\",\"input_params\":{\"type\":\"object\",\"properties\":{\"data\":{\"type\":\"object\",\"properties\":{\"req_data\":{\"items\":[{\"type\":\"object\",\"properties\":{}}],\"type\":\"array\"}}}}},\"output_params\":{\"type\":\"object\",\"properties\":{\"data\":{\"type\":\"object\",\"properties\":{\"resp_data\":{\"type\":\"array\",\"items\":[{\"type\":\"object\",\"properties\":{}}]}}}}}}]", + "model_labels":[], + "labels_map":{"labels":[]}, + "workspace_id": "0", + "install_type": ["realtime", "batch"], + "specification":{}, + "config":"{\"model_algorithm\": \"image_classification\", \"model_source\": \"auto\", \"tunable\": false, \"downloadable_flag\": true, \"algorithm\": \"resnet_v2_50,mobilenet_v1\", \"metrics\": {\"f1\": 0.912078373015873, \"recall\": 0.9125, \"precision\": 0.9340277777777778, \"accuracy\": 0.263250724969475}, \"model_type\": \"TensorFlow\", \"runtime\": \"tf1.13-python3.6-cpu\", \"apis\": [{\"protocol\": \"https\", \"url\": \"/\", \"method\": \"post\", \"request\": {\"data\": {\"type\": \"object\", \"properties\": {\"images\": {\"type\": \"file\"}}}, \"Content-type\": \"multipart/form-data\"}, \"response\": {\"data\": {\"type\": \"object\", \"required\": [\"predicted_label\", \"scores\"], \"properties\": {\"predicted_label\": {\"type\": \"string\"}, \"scores\": {\"type\": \"array\", \"items\": {\"type\": \"array\", \"minItems\": 2, \"maxItems\": 2, \"items\": [{\"type\": \"string\"}, {\"type\": \"number\"}]}}}}, \"Content-type\": \"multipart/form-data\"}}], \"dependencies\": [{\"installer\": \"pip\", \"packages\": [{\"package_name\": \"numpy\", \"package_version\": \"1.17.0\", \"restraint\": \"EXACT\"}, {\"package_name\": \"h5py\", \"package_version\": \"2.8.0\", \"restraint\": \"EXACT\"}, {\"package_name\": \"Pillow\", \"package_version\": \"5.2.0\", \"restraint\": \"EXACT\"}, {\"package_name\": \"scipy\", \"package_version\": \"1.2.1\", \"restraint\": \"EXACT\"}, {\"package_name\": \"resampy\", \"package_version\": \"0.2.1\", \"restraint\": \"EXACT\"}, {\"package_name\": \"scikit-learn\", \"package_version\": \"0.19.1\", \"restraint\": \"EXACT\"}]}]}" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/service_management/deleting_a_service.rst b/api-ref/source/service_management/deleting_a_service.rst new file mode 100644 index 0000000..57cca4d --- /dev/null +++ b/api-ref/source/service_management/deleting_a_service.rst @@ -0,0 +1,62 @@ +Deleting a Service +================== + +Function +-------- + +This API is used to delete a model service. You can delete your own services only. + +URI +--- + +.. code-block:: + + DELETE /v1/{project_id}/services/{service_id} + +`Table 1 <#modelarts030089enustopic0130234312table10624434011>`__ describes the required parameters. + +.. _modelarts030089enustopic0130234312table10624434011: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_id | Yes | String | Service ID. If you want to delete multiple services in batches, use commas (,) to separate multiple **service_id** values. | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +None + +Samples +------- + +The following shows how to delete the model service whose ID is **xxxxxx**. + +- Sample request + + .. code-block:: + + DELETE https://endpoint/v1/{project_id}/services/xxxxxx + +- Sample response + + .. code-block:: + + {} + +Status Code +----------- + +For details about the status code, see `Table 1 <../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/service_management/deploying_a_model_as_a_service.rst b/api-ref/source/service_management/deploying_a_model_as_a_service.rst new file mode 100644 index 0000000..07d4a4d --- /dev/null +++ b/api-ref/source/service_management/deploying_a_model_as_a_service.rst @@ -0,0 +1,321 @@ +Deploying a Model as a Service +============================== + +Function +-------- + +This API is used to deploy a model as a service. + +URI +--- + +POST /v1/{project_id}/services + +`Table 1 <#modelarts030082enustopic0129882788table16518993181628>`__ describes the required parameters. + +.. _modelarts030082enustopic0129882788table16518993181628: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030082enustopic0129882788table37462542238>`__ describes the request parameters. + +.. _modelarts030082enustopic0129882788table37462542238: + +.. table:: **Table 2** Parameters + + +-------------------+-----------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===================+=================+==================================================+==================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | service_name | Yes | String | Service name. Enter 1 to 64 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. | + +-------------------+-----------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Service description, which contains a maximum of 100 characters. By default, this parameter is left blank. | + +-------------------+-----------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | infer_type | Yes | String | Inference mode. The value can be **real-time** or **batch**. | + | | | | | + | | | | - **real-time**: real-time service, which can be stopped as scheduled. | + | | | | - **batch**: batch service, which can be configured as tasks to run in batches. When the tasks are completed, the service stops automatically. | + +-------------------+-----------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | ID of the workspace to which a service belongs. The default value is **0**, indicating the default workspace. | + +-------------------+-----------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | vpc_id | No | String | ID of the VPC to which a real-time service instance is deployed. By default, this parameter is left blank. | + | | | | | + | | | | - In this case, ModelArts allocates a dedicated VPC to each user so that users are isolated from each other. If you need to access other service components in a VPC of a service instance, set this parameter to the ID of the corresponding VPC. | + | | | | - Once a VPC is configured, it cannot be modified. If both **vpc_id** and **cluster_id** are configured, only the dedicated resource pool takes effect. | + +-------------------+-----------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | subnet_network_id | No | String | ID of a subnet. By default, this parameter is left blank. | + | | | | | + | | | | This parameter is mandatory when **vpc_id** is configured. Enter the network ID displayed in the subnet details on the VPC console. A subnet provides dedicated network resources that are isolated from other networks. | + +-------------------+-----------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | security_group_id | No | String | Security group. By default, this parameter is left blank. This parameter is mandatory when **vpc_id** is configured. | + | | | | | + | | | | A security group is a virtual firewall that provides secure network access control policies for service instances. A security group must contain at least one inbound rule to permit the requests whose protocol is TCP, source address is **0.0.0.0/0**, and port number is **8080**. | + +-------------------+-----------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | cluster_id | No | String | ID of a dedicated resource pool. This parameter is left blank by default, indicating that no dedicated resource pool is used. When using a dedicated resource pool to deploy services, ensure that the resource pool is running properly. After this parameter is set, the network configuration of the cluster is used, and the **vpc_id** parameter does not take effect. If this parameter is configured together with **cluster_id** in **real-time config**, **cluster_id** in **real-time config** is used preferentially. | + +-------------------+-----------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config | Yes | **config** array corresponding to **infer_type** | Model running configuration. If **infer_type** is **batch**, you can configure only one model. If **infer_type** is **real-time**, you can configure multiple models and assign weights based on service requirements. However, the versions of these models cannot be the same. | + +-------------------+-----------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | schedule | No | **schedule** array | Service scheduling configuration, which can be configured only for real-time services. By default, this parameter is not used. Services run for a long time. For details, see `Table 5 <#modelarts030082enustopic0129882788table1892915349285>`__. | + +-------------------+-----------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030082enustopic0129882788table6841887256: + +.. table:: **Table 3** **config** parameters of **real-time** + + +-----------------+-----------------+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===========================+========================================================================================================================================================================+ + | model_id | Yes | String | Model ID | + +-----------------+-----------------+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | weight | Yes | Integer | Traffic weight allocated to a model. This parameter is mandatory only when **infer_type** is set to **real-time**. The sum of the weights must be 100. | + +-----------------+-----------------+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | specification | Yes | String | Resource specifications. Select specifications based on service requirements. | + +-----------------+-----------------+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | custom_spec | No | **custom_spec** structure | Custom specifications. Set this parameter when you use a dedicated resource pool. For details, see `Table 6 <#modelarts030082enustopic0129882788table134334512416>`__. | + +-----------------+-----------------+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_count | Yes | Integer | Number of instances deployed in a model. The value must be greater than 0. | + +-----------------+-----------------+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | envs | No | Map | (Optional) Environment variable key-value pair required for running a model. By default, this parameter is left blank. | + | | | | | + | | | | To ensure data security, do not enter sensitive information, such as plaintext passwords, in environment variables. | + +-----------------+-----------------+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | cluster_id | No | string | ID of a dedicated resource pool. By default, this parameter is left blank, indicating that no dedicated resource pool is used. | + +-----------------+-----------------+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030082enustopic0129882788table6420928063: + +.. table:: **Table 4** **config** parameters of **batch** + + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=====================+===========================================================================================================================================================================================================================================================================================================================================+ + | model_id | Yes | String | Model ID | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | specification | Yes | String | Resource flavor. Available options: **modelarts.vm.cpu.2u** and **modelarts.vm.gpu.p4** | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_count | Yes | Integer | Number of instances deployed in a model. | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | envs | No | Map | (Optional) Environment variable key-value pair required for running a model. By default, this parameter is left blank. | + | | | | | + | | | | To ensure data security, do not enter sensitive information, such as plaintext passwords, in environment variables. | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | src_type | No | String | Data source type. This parameter can be set to **ManifestFile**. By default, this parameter is left blank, indicating that only files in the **src_path** directory are read. If this parameter is set to **ManifestFile**, **src_path** must be a specific Manifest file path. You can specify multiple data paths in the Manifest file. | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | src_path | Yes | String | OBS path of the input data of a batch job | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dest_path | Yes | String | OBS path of the output data of a batch job | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | req_uri | Yes | String | Inference API called in a batch task, which is a REST API in the model image. Select an API URI from the model **config.json** file for inference. If a ModelArts built-in inference image is used, the value of this parameter is **/**. | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | mapping_type | Yes | String | Mapping type of the input data. The value can be **file** or **csv**. | + | | | | | + | | | | - If you select **file**, each inference request corresponds to a file in the input data path. When this mode is used, **req_uri** of this model can have only one input parameter and the type of this parameter is **file**. | + | | | | - If you select **csv**, each inference request corresponds to a row of data in the CSV file. When this mode is used, the files in the input data path can only be in CSV format and **mapping_rule** needs to be configured to map the index of each parameter in the inference request body to the CSV file. | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | mapping_rule | No | Map | Mapping between input parameters and CSV data. This parameter is mandatory only when **mapping_type** is set to **csv**. | + | | | | | + | | | | Mapping rule: The mapping rule comes from the input parameter (**input_params**) in the model configuration file **config.json**. When **type** is set to **string**, **number**, **integer**, or **boolean**, you need to configure the index parameter. For details, see . | + | | | | | + | | | | The index must be a positive integer starting from 0. If the value of index does not comply with the rule, this parameter is ignored in the request. After the mapping rule is configured, the corresponding CSV data must be separated by commas (,). | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030082enustopic0129882788table1892915349285: + +.. table:: **Table 5** **schedule** parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=============================================================================================================================================+ + | type | Yes | String | Scheduling type. Only the value **stop** is supported. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | time_unit | Yes | String | Scheduling time unit. Options: | + | | | | | + | | | | - **DAYS** | + | | | | - **HOURS** | + | | | | - **MINUTES** | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | Yes | Integer | Value that maps to the time unit. For example, if the task stops after two hours, set **time_unit** to **HOURS** and **duration** to **2**. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030082enustopic0129882788table134334512416: + +.. table:: **Table 6** **custom_spec** parameters + + +-------------+-----------+---------+------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+=========+================================================================================================+ + | cpu | Yes | Float | Number of required CPUs | + +-------------+-----------+---------+------------------------------------------------------------------------------------------------+ + | memory | Yes | Integer | Required memory capacity, in MB | + +-------------+-----------+---------+------------------------------------------------------------------------------------------------+ + | gpu_p4 | No | Float | Number of GPUs, which can be decimals. This parameter is optional. By default, it is not used. | + +-------------+-----------+---------+------------------------------------------------------------------------------------------------+ + | ascend_a310 | No | Integer | Number of NPUs, which can be decimals. This parameter is optional. By default, it is not used. | + +-------------+-----------+---------+------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 7 <#modelarts030082enustopic0129882788table95112832610>`__ describes the response parameters. + +.. _modelarts030082enustopic0129882788table95112832610: + +.. table:: **Table 7** Parameters + + +--------------+------------------+----------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============+==================+======================================================================+ + | service_id | String | Service ID | + +--------------+------------------+----------------------------------------------------------------------+ + | resource_ids | Array of strings | Resource ID array for the resource IDs generated by the target model | + +--------------+------------------+----------------------------------------------------------------------+ + +Samples +------- + +The following shows how to deploy different types of services. + +- Sample request: Creating a real-time service + + .. code-block:: + + POST https://endpoint/v1/{project_id}/services + { + "service_name": "mnist", + "description": "mnist service", + "infer_type": "real-time", + "config": [ + { + "model_id": "xxxmodel-idxxx", + "weight": "100", + "specification": "modelarts.vm.cpu.2u", + "instance_count": 1 + } + ] + } + +- Sample request: Creating a real-time service and configuring multi-version traffic distribution + + .. code-block:: + + { + "service_name": "mnist", + "description": "mnist service", + "infer_type": "real-time", + "config": [ + { + "model_id": "xxxmodel-idxxx", + "weight": "70", + "specification": "modelarts.vm.cpu.2u", + "instance_count": 1, + "envs": + { + "model_name": "mxnet-model-1", + "load_epoch": "0" + } + }, + { + "model_id": "xxxxxx", + "weight": "30", + "specification": "modelarts.vm.cpu.2u", + "instance_count": 1 + } + ] + } + +- Sample request: Creating a real-time service in a dedicated resource pool with custom specifications + + .. code-block:: + + { + "service_name": "realtime-demo", + "description": "", + "infer_type": "real-time", + "cluster_id": "8abf68a969c3cb3a0169c4acb24b0000", + "config": [{ + "model_id": "eb6a4a8c-5713-4a27-b8ed-c7e694499af5", + "weight": "100", + "cluster_id": "8abf68a969c3cb3a0169c4acb24b0000", + "specification": "custom", + "custom_spec": { + "cpu": 1.5, + "memory": 7500, + "gpu_p4": 0, + "ascend_a310": 0 + }, + "instance_count": 1 + }] + } + +- Sample request: Creating a real-time service and setting it to automatically stop + + .. code-block:: + + { + "service_name": "service-demo", + "description": "demo", + "infer_type": "real-time", + "config": [{ + "model_id": "xxxmodel-idxxx", + "weight": "100", + "specification": "modelarts.vm.cpu.2u", + "instance_count": 1 + }], + "schedule": [{ + "type": "stop", + "time_unit": "HOURS", + "duration": 1 + }] + } + +- Sample request: Creating a batch service and setting **mapping_type** to **file** + + .. code-block:: + + { + "service_name": "batchservicetest", + "description": "", + "infer_type": "batch", + "cluster_id": "8abf68a969c3cb3a0169c4acb24b****", + "config": [{ + "model_id": "598b913a-af3e-41ba-a1b5-bf065320f1e2", + "specification": "modelarts.vm.cpu.2u", + "instance_count": 1, + "src_path": "https://infers-data.obs.xxxx.com/xgboosterdata/", + "dest_path": "https://infers-data.obs.dxxxx.com/output/", + "req_uri": "/", + "mapping_type": "file" + }] + } + +- Sample response + + .. code-block:: + + { + "service_id": "10eb0091-887f-4839-9929-cbc884f1e20e", + "resource_ids": [ "INF-f878991839647358@1598319442708" ] + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/service_management/index.rst b/api-ref/source/service_management/index.rst new file mode 100644 index 0000000..20548f6 --- /dev/null +++ b/api-ref/source/service_management/index.rst @@ -0,0 +1,16 @@ +================== +Service Management +================== + +.. toctree:: + :maxdepth: 1 + + deploying_a_model_as_a_service + querying_a_service_list + querying_the_details_about_a_service + updating_service_configurations + querying_service_monitoring_information + querying_service_update_logs + querying_service_event_logs + deleting_a_service + querying_supported_service_deployment_specifications diff --git a/api-ref/source/service_management/querying_a_service_list.rst b/api-ref/source/service_management/querying_a_service_list.rst new file mode 100644 index 0000000..fcf2d29 --- /dev/null +++ b/api-ref/source/service_management/querying_a_service_list.rst @@ -0,0 +1,252 @@ +Querying a Service List +======================= + +Function +-------- + +This API is used to obtain model services. + +URI +--- + +GET /v1/{project_id}/services + +`Table 1 <#modelarts030083enustopic0129882800table16518993181628>`__ describes the required parameters. + +.. _modelarts030083enustopic0129882800table16518993181628: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030083enustopic0129882800table69015539276: + +.. table:: **Table 2** Parameters + + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+=========+=============================================================================================================================================================================================================================+ + | service_id | No | String | Service ID | + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_name | No | String | Service name | + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | No | String | Model ID | + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | cluster_id | No | String | Dedicated resource pool ID, which is left blank by default | + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | Workspace ID. Default value: **0** | + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | infer_type | No | String | Inference mode. The value can be **real-time** or **batch**. By default, this parameter is left blank. | + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | No | String | Service status. By default, the service status is not filtered. You can query information by service status. The possible values are **running**, **deploying**, **concerning**, **failed**, **stopped**, and **finished**. | + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. Default value: **0** | + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | limit | No | Integer | Maximum number of records returned on each page. The default value is **1000**. The recommended value ranges from 10 to 50. | + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Sorting mode. The value can be **publish_at** or **service_name**. Default value: **publish_at** | + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting order. The value can be **asc** or **desc**, indicating ascending or descending order. Default value: **desc** | + +--------------+-----------+---------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 3 <#modelarts030083enustopic0129882800table6357123816292>`__ describes the response parameters. + +.. _modelarts030083enustopic0129882800table6357123816292: + +.. table:: **Table 3** Parameters + + +-------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+===================+============================================================================================================================================+ + | total_count | Integer | Total number of services that meet the search criteria when no paging is implemented | + +-------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + | count | Integer | Number of services in the query result. If **offset** and **limit** are not set, the values of **count** and **total_count** are the same. | + +-------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + | services | **service** array | Collection of the queried services. For details, see `Table 4 <#modelarts030083enustopic0129882800table799523318302>`__. | + +-------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030083enustopic0129882800table799523318302: + +.. table:: **Table 4** **service** parameters + + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============================+=======================+===================================================================================================================================================================================================================================+ + | service_id | String | Service ID | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_name | String | Service name | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Service description | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | tenant | String | Tenant to which a service belongs | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project | String | Project to which a service belongs | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | owner | String | User to which a service belongs | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | publish_at | Long | Latest service release time, in milliseconds calculated from 1970.1.1 0:0:0 UTC | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | infer_type | String | Inference mode. The value can be **real-time** or **batch**. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | Workspace ID. Default value: **0** | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Service status. The value can be **running**, **deploying**, **concerning**, **failed**, **stopped**, or **finished**. | + | | | | + | | | - **running**: The service is running properly. | + | | | - **deploying**: The service is being deployed or scheduling resources are being deployed. | + | | | - **concerning**: The backend instances are abnormal. For example, if there are multiple instances and some instances are abnormal, the normal instances will consume resources. In this case, the service status is concerning. | + | | | - **failed**: The service fails to be deployed. For details about the failure cause, see the event and log tab pages. | + | | | - **stopped**: The service has been stopped. | + | | | - **finished**: This state is displayed only for the batch service, indicating that the service running is complete. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | start_time | Number | Batch service start time, in milliseconds calculated from 1970.1.1 0:0:0 UTC. This parameter is returned only when the service is a batch service. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | finished_time | Number | Batch service end time, in milliseconds calculated from 1970.1.1 0:0:0 UTC. This parameter is returned only when the service is a batch service. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | progress | integer | Deployment progress. This parameter is returned when the status is **deploying**. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | invocation_times | Long | Total number of service calls | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | failed_times | Long | Number of failed service calls | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_shared | Boolean | Whether a service is subscribed | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | shared_count | Number | Number of subscribed services | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | schedule | **schedule** array | Service scheduling. For details, see `Table 5 <#modelarts030083enustopic0129882800table1892915349285>`__. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | due_time | number | Time when a real-time service automatically stops, in milliseconds calculated from 1970.1.1 0:0:0 UTC. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | operation_time | number | Operation time of a request | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_opened_sample_collection | String | Whether to enable data collection. The default value is **false**. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | transition_at | number | Time when the service status changes | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_free | Boolean | Whether a service uses the free-of-charge flavor | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | additional_properties | Map | Additional service attribute. If this parameter is not set, no value is returned. | + +-----------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030083enustopic0129882800table1892915349285: + +.. table:: **Table 5** **schedule** parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=============================================================================================================================================+ + | type | Yes | String | Scheduling type. Only the value **stop** is supported. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | time_unit | Yes | String | Scheduling time unit. Options: | + | | | | | + | | | | - **DAYS** | + | | | | - **HOURS** | + | | | | - **MINUTES** | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | Yes | Integer | Value that maps to the time unit. For example, if the task stops after two hours, set **time_unit** to **HOURS** and **duration** to **2**. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to query model services. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/services + +- Sample response + + .. code-block:: + + { + "count": 2, + "total_count": 2, + "services": [ + { + "service_id": "8da30673-908d-45a7-90a4-65f98e69fc34", + "service_name": "service-demo", + "tenant": "xxx", + "project": "xxx", + "owner": "xxx", + "publish_at": 1584622900171, + "infer_type": "real-time", + "status": "stopped", + "progress": 100, + "invocation_times": 0, + "failed_times": 0, + "is_shared": false, + "shared_count": 0, + "workspace_id": "0", + "schedule": [ + { + "type": "stop", + "duration": 1, + "time_unit": "HOURS" + } + ], + "due_time": 1584626633902, + "operation_time": 1586250354961, + "is_opened_sample_collection": false, + "additional_properties": {}, + "is_free": false, + "transition_at": 1584623163721 + }, + { + "service_id": "912f1a4a-5962-455c-b11c-5fdf06045cb3", + "service_name": "service-demo2", + "tenant": "xxx", + "project": "xxx", + "owner": "xxx", + "publish_at": 1584618274410, + "infer_type": "real-time", + "status": "stopped", + "progress": 100, + "invocation_times": 0, + "failed_times": 0, + "is_shared": false, + "shared_count": 0, + "workspace_id": "0", + "schedule": [ + { + "type": "stop", + "duration": 1, + "time_unit": "HOURS" + } + ], + "due_time": 1584622027673, + "operation_time": 1586250354961, + "is_opened_sample_collection": false, + "additional_properties": {}, + "is_free": false, + "transition_at": 1584618498528 + } + ] + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/service_management/querying_service_event_logs.rst b/api-ref/source/service_management/querying_service_event_logs.rst new file mode 100644 index 0000000..3a2cde9 --- /dev/null +++ b/api-ref/source/service_management/querying_service_event_logs.rst @@ -0,0 +1,176 @@ +Querying Service Event Logs +=========================== + +Function +-------- + +This API is used to query service event logs, including service operation records, key actions during deployment, and deployment failure causes. + +URI +--- + +GET /v1/{project_id}/services/{service_id}/events + +`Table 1 <#modelarts030155enustopic0192973542table10624434011>`__ describes the required parameters. + +.. _modelarts030155enustopic0192973542table10624434011: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_id | Yes | String | Service ID | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030155enustopic0192973542table118011654615: + +.. table:: **Table 2** Parameters + + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+======================================================================================================================+ + | event_type | No | String | Type of the event to be filtered. By default, the event type is not filtered. Options: | + | | | | | + | | | | - **normal**: normal events | + | | | | - **abnormal**: abnormal events | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------+ + | start_time | No | Number | Start time of the event to be filtered. The value is milliseconds between the current time and '1970.1.1 0:0:0 UTC'. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------+ + | end_time | No | Number | End time of the event to be filtered. The value is milliseconds between the current time and '1970.1.1 0:0:0 UTC'. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------+ + | offset | No | Integer | Start page of the paging list. Default value: **0** | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------+ + | limit | No | Integer | Maximum number of records returned on each page. Default value: **1000** | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Specified sorting field. The default value is **occur_time**. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting mode. The default value is **desc**. Options: | + | | | | | + | | | | - **asc**: ascending order | + | | | | - **desc**: descending order | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 3 <#modelarts030155enustopic0192973542table413209485>`__ describes the response parameters. + +.. _modelarts030155enustopic0192973542table413209485: + +.. table:: **Table 3** Parameters + + +--------------+-----------------+--------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============+=================+==================================================================================================+ + | service_id | String | Service ID | + +--------------+-----------------+--------------------------------------------------------------------------------------------------+ + | service_name | String | Service name | + +--------------+-----------------+--------------------------------------------------------------------------------------------------+ + | events | **event** array | Event logs. For details, see `Table 4 <#modelarts030155enustopic0192973542table974014115493>`__. | + +--------------+-----------------+--------------------------------------------------------------------------------------------------+ + | total_count | Integer | Total number of events that meet the search criteria when no paging is implemented | + +--------------+-----------------+--------------------------------------------------------------------------------------------------+ + | count | Integer | Number of events in the query result | + +--------------+-----------------+--------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030155enustopic0192973542table974014115493: + +.. table:: **Table 4** **event** structure + + +------------+--------+------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +============+========+========================================================================================================================+ + | occur_time | Number | Time when an event occurs. The value is milliseconds between the current time and '1970.1.1 0:0:0 UTC'. | + +------------+--------+------------------------------------------------------------------------------------------------------------------------+ + | event_type | String | Event type. Possible values are **normal** and **abnormal**, indicating whether the event is normal or abnormal. | + +------------+--------+------------------------------------------------------------------------------------------------------------------------+ + | event_info | String | Event information,' including service operation records, key actions during deployment, and deployment failure causes. | + +------------+--------+------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following example queries event information of the service whose ID is **35de3ca9-1bca-4ae7-9cb0-914f30fa7d3e**. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/services/{service_id}/events + +- Sample response + + .. code-block:: + + { + "service_id": "35de3ca9-1bca-4ae7-9cb0-914f30fa7d3e", + "service_name": "zcjtest-07085", + "count": 9, + "total_count": 9, + "events": [ + { + "occur_time": 1562597251764, + "event_type": "normal", + "event_info": "start to deploy service" + }, + { + "occur_time": 1562597251788, + "event_type": "normal", + "event_info": "building image for model [zcjtestTF 3.0.0]" + }, + { + "occur_time": 1562597251805, + "event_type": "normal", + "event_info": "model (zcjtestTF 3.0.0) build image success" + }, + { + "occur_time": 1562597255744, + "event_type": "normal", + "event_info": "preparing environment" + }, + { + "occur_time": 1562597275915, + "event_type": "normal", + "event_info": "[zcjtestTF 3.0.0] prepare environment success" + }, + { + "occur_time": 1562597275921, + "event_type": "normal", + "event_info": "[zcjtestTF 3.0.0] schedule resource success" + }, + { + "occur_time": 1562597275928, + "event_type": "normal", + "event_info": "[zcjtestTF 3.0.0] pulling model image" + }, + { + "occur_time": 1562597332570, + "event_type": "normal", + "event_info": "[zcjtestTF 3.0.0] pull image success" + }, + { + "occur_time": 1562597332582, + "event_type": "normal", + "event_info": "[zcjtestTF 3.0.0] starting model" + } + ] + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/service_management/querying_service_monitoring_information.rst b/api-ref/source/service_management/querying_service_monitoring_information.rst new file mode 100644 index 0000000..9ea4543 --- /dev/null +++ b/api-ref/source/service_management/querying_service_monitoring_information.rst @@ -0,0 +1,125 @@ +Querying Service Monitoring Information +======================================= + +Function +-------- + +This API is used to query service monitoring information. + +URI +--- + +GET /v1/{project_id}/services/{service_id}/monitor + +`Table 1 <#modelarts030087enustopic0130048742table10624434011>`__ describes the required parameters. + +.. _modelarts030087enustopic0130048742table10624434011: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_id | Yes | String | Service ID | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030087enustopic0130048742table118011654615: + +.. table:: **Table 2** Parameters + + +-----------+-----------+--------+------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+==================================================================+ + | node_id | No | String | ID of the node to be queried. By default, all nodes are queried. | + +-----------+-----------+--------+------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 3 <#modelarts030087enustopic0130048742table413209485>`__ describes the response parameters. + +.. _modelarts030087enustopic0130048742table413209485: + +.. table:: **Table 3** Parameters + + +--------------+----------------------------------------------------------------+--------------------+ + | Parameter | Type | Description | + +==============+================================================================+====================+ + | service_id | String | Service ID | + +--------------+----------------------------------------------------------------+--------------------+ + | service_name | String | Service name | + +--------------+----------------------------------------------------------------+--------------------+ + | monitors | **monitor** array corresponding to **infer_type** of a service | Monitoring details | + +--------------+----------------------------------------------------------------+--------------------+ + + + +.. _modelarts030087enustopic0130048742table974014115493: + +.. table:: **Table 4** **monitor** parameters of **real-time** + + ================ ======= ===================================== + Parameter Type Description + ================ ======= ===================================== + model_id String Model ID + model_name String Model name + model_version String Model version + invocation_times Long Total number of model instance calls + failed_times Long Number of failed model instance calls + cpu_core_usage Float Number of used CPUs + cpu_core_total Float Total number of CPUs + cpu_memory_usage Integer Used memory, in MB + cpu_memory_total Integer Total memory, in MB + gpu_usage Float Number used GPUs + gpu_total Float Total number of GPUs + ================ ======= ===================================== + +Samples +------- + +The following shows how to query the monitoring information about a real-time service. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/services/{service_id}/monitor + +- Sample response + + .. code-block:: + + { + "service_id": "xxx", + "service_name": "mnist", + "monitors": + [{ + "model_id": "xxxx", + "model_name": "minst", + "model_version": "1.0.0", + "invocation_times": 50, + "failed_times": 1, + "cpu_core_usage": "2.4", + "cpu_core_total": "4", + "cpu_memory_usage": "2011", + "cpu_memory_total": "8192", + "gpu_usage": "0.6", + "gpu_total": "1" + } ] + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/service_management/querying_service_update_logs.rst b/api-ref/source/service_management/querying_service_update_logs.rst new file mode 100644 index 0000000..657e3a9 --- /dev/null +++ b/api-ref/source/service_management/querying_service_update_logs.rst @@ -0,0 +1,188 @@ +Querying Service Update Logs +============================ + +Function +-------- + +This API is used to query the update logs of a real-time service. + +URI +--- + +GET /v1/{project_id}/services/{service_id}/logs + +`Table 1 <#modelarts030088enustopic0130234308table10624434011>`__ describes the required parameters. + +.. _modelarts030088enustopic0130234308table10624434011: + +.. table:: **Table 1** Parameters + + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_id | Yes | String | Service ID | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | No | Number | Update time for filtering. This parameter can be used to obtain the update logs of a real-time service. By default, the filtering by update time is disabled. | + +-------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030088enustopic0130234308table1869020408516>`__ describes the response parameters. + + + +.. _modelarts030088enustopic0130234308table1869020408516: + +.. table:: **Table 2** Parameters + + +--------------+---------------+------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============+===============+============================================================================================================+ + | service_id | String | Service ID | + +--------------+---------------+------------------------------------------------------------------------------------------------------------+ + | service_name | String | Service name | + +--------------+---------------+------------------------------------------------------------------------------------------------------------+ + | logs | **log** array | Service update logs. For details, see `Table 3 <#modelarts030088enustopic0130234308table0745828125216>`__. | + +--------------+---------------+------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030088enustopic0130234308table0745828125216: + +.. table:: **Table 3** **log** parameters + + +---------------+------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===============+==================+==================================================================================================================================================================================+ + | update_time | Number | Time when a service is updated, in milliseconds calculated from 1970.1.1 0:0:0 UTC | + +---------------+------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | result | String | Update result. The value can be **SUCCESS**, **FAIL**, or **RUNNING**. | + +---------------+------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config | **config** array | Updated service configurations. For details, see `Table 4 <#modelarts030088enustopic0130234308table1355535185314>`__. | + +---------------+------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | success_num | Number | Number of nodes that are successfully operated. This parameter is returned when **infer_type** is set to **edge**. | + +---------------+------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | failed_num | Number | Number of nodes that fail to be operated. This parameter is returned when **infer_type** is set to **edge**. | + +---------------+------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | result_detail | **result** array | Operation result details. This parameter is returned when **infer_type** is set to **edge**. For details, see `Table 5 <#modelarts030088enustopic0130234308table44853072416>`__. | + +---------------+------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | cluster_id | String | ID of a dedicated resource pool | + +---------------+------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | extend_config | List | Personalized configuration | + +---------------+------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030088enustopic0130234308table1355535185314: + +.. table:: **Table 4** **config** parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=====================================================================================================================+ + | model_id | String | Model ID | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | model_name | String | Model name | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | model_version | String | Model version | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | weight | Integer | Traffic weight allocated to a model. This parameter is returned when **infer_type** is set to **real-time**. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | specification | String | Resource flavor. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | custom_spec | Float | Custom specifications. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | instance_count | Integer | Number of instances deployed in a model. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | envs | Map | Environment variable key-value pair required for running a model | + | | | | + | | | To ensure data security, do not enter sensitive information, such as plaintext passwords, in environment variables. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | cluster_id | String | ID of a dedicated resource pool | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030088enustopic0130234308table44853072416: + +.. table:: **Table 5** **result** parameters + + +-----------+---------+----------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+=========+====================================================================================================+ + | node_id | String | Node ID | + +-----------+---------+----------------------------------------------------------------------------------------------------+ + | node_name | String | Node name | + +-----------+---------+----------------------------------------------------------------------------------------------------+ + | operation | String | Operation type. The value can be **deploy** or **delete**. | + +-----------+---------+----------------------------------------------------------------------------------------------------+ + | result | Boolean | Operation result. **true** indicates operation success, and **false** indicates operation failure. | + +-----------+---------+----------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030088enustopic0130234308table134334512416: + +.. table:: **Table 6** **custom_spec** parameters + + =========== ======= ====================== + Parameter Type Description + =========== ======= ====================== + cpu Float Number of CPUs + memory Integer Memory capacity in MB + gpu_p4 Float Number of GPUs + ascend_a310 Integer Number of Ascend chips + =========== ======= ====================== + +Samples +------- + +The following shows how to query the update logs of the real-time service whose ID is **xxxxxx** and name is **mnist**. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/services/xxxxxx/logs + +- Sample response + + .. code-block:: + + { + "service_id": "e2122bbd-f7c8-4bf8-bacc-59616276194b", + "service_name": "service-demo", + "logs": [{ + "config": [{ + "model_id": "f565ac47-6239-4e8c-b2dc-0665dc52e302", + "model_name": "model-demo", + "model_version": "0.0.1", + "specification": "modelarts.vm.cpu.2u", + "custom_spec": {}, + "weight": 100, + "instance_count": 1, + "scaling": false, + "envs": {}, + "cluster_id": "2c9080f86d37da64016d381fe5940002" + }], + "extend_config": [], + "update_time": 1586250930708, + "result": "RUNNING", + "cluster_id": "2c9080f86d37da64016d381fe5940002" + }] + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/service_management/querying_supported_service_deployment_specifications.rst b/api-ref/source/service_management/querying_supported_service_deployment_specifications.rst new file mode 100644 index 0000000..973fdd4 --- /dev/null +++ b/api-ref/source/service_management/querying_supported_service_deployment_specifications.rst @@ -0,0 +1,116 @@ +Querying Supported Service Deployment Specifications +==================================================== + +Function +-------- + +This API is used to query supported service deployment specifications. + +URI + +GET /v1/{project_id}/services/specifications + + + +.. _modelarts030200enustopic0210524455table217714595104: + +.. table:: **Table 1** Parameters + + +---------------------+-----------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=====================+===========+=========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +---------------------+-----------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_personal_cluster | No | Boolean | Whether to query the service deployment specifications supported by dedicated resource pool. The default value is **false**. | + +---------------------+-----------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | infer_type | No | String | Inference mode. The default value is **real-time**. The value can be **real-time** or **batch**. | + +---------------------+-----------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + + + +.. _modelarts030200enustopic0210524455table1912592318122: + +.. table:: **Table 2** Parameters + + +----------------+-------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+=========================+=====================================================================================================================================+ + | specifications | **specification** array | Supported service deployment specifications. For details, see `Table 3 <#modelarts030200enustopic0210524455table16128205111319>`__. | + +----------------+-------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030200enustopic0210524455table16128205111319: + +.. table:: **Table 3** **specification** parameters + + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==================================================================================================================================================================================+ + | specification | String | Unique specifications ID | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | billing_spec | String | Unique ID of the billing specifications | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec_status | String | Specifications status | + | | | | + | | | - **normal**: The specifications are normal. | + | | | - **sellout**: The specifications cannot be used to deploy services because they are sold out. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_open | Boolean | Whether to enable the specifications. The default value is **true**. If this parameter is set to **false**, you need to submit a service ticket to apply for the specifications. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | source_type | String | Type of the model to which the specifications apply. | + | | | | + | | | - Empty: indicates a model generated by the user. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_free | Boolean | Whether the flavor is free of charge. The value **true** indicates that the flavor is free of charge. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | over_quota | Boolean | Whether the quota exceeds the upper limit. The value **true** indicates that the quota exceeds the upper limit. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | extend_params | Integer | Billing item | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | display_en | String | Specifications description in English | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | display_cn | String | Specifications description in Chinese | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/services/specifications + +- Sample response + + .. code-block:: + + { + "specifications": [ + { + "specification": "modelarts.vm.gpu.p4", + "billing_spec": "modelarts.vm.gpu.p4", + "is_open": true, + "spec_status": "normal", + "is_free": false, + "over_quota": false, + "extend_params": 1 + }, + ] + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/service_management/querying_the_details_about_a_service.rst b/api-ref/source/service_management/querying_the_details_about_a_service.rst new file mode 100644 index 0000000..08edac8 --- /dev/null +++ b/api-ref/source/service_management/querying_the_details_about_a_service.rst @@ -0,0 +1,341 @@ +Querying the Details About a Service +==================================== + +Function +-------- + +This API is used to query the details about a model service based on the service ID. + +URI +--- + +GET /v1/{project_id}/services/{service_id} + +`Table 1 <#modelarts030084enustopic0130035938table16518993181628>`__ describes the required parameters. + +.. _modelarts030084enustopic0130035938table16518993181628: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_id | Yes | String | Service ID | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030084enustopic0130035938table41514501418>`__ describes the response parameters. + +.. _modelarts030084enustopic0130035938table41514501418: + +.. table:: **Table 2** Parameters + + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+==================================================+==================================================================================================================================================================================+ + | service_id | String | Service ID | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_name | String | Service name | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Service description | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | tenant | String | Tenant to which a service belongs | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | project | String | Project to which a service belongs | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | owner | String | User to which a service belongs | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | publish_at | Number | Latest service release time, in milliseconds calculated from 1970.1.1 0:0:0 UTC | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | infer_type | String | Inference type, which can be **real-time**, **edge**, | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | String | Workspace ID | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | cluster_id | String | ID of the dedicated resource pool used by the real-time or batch service. This parameter is available only when a dedicated resource pool is used. | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | vpc_id | String | ID of the VPC to which the real-time service instance belongs. This parameter is available when the network configuration is customized. | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | subnet_network_id | String | ID of the subnet to which the real-time service instance belongs. This parameter is available when the network configuration is customized. | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | security_group_id | String | Security group to which the real-time service instance belongs. This parameter is available when the network configuration is customized. | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Service status, which can be **running**, **deploying**, **concerning**, **failed**, **stopped**, or **finished** | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | progress | Integer | Deployment progress. This parameter is available when the status is **deploying**. | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_msg | String | Error message. When **status** is **failed**, an error message carrying the failure cause is returned. | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config | **config** array corresponding to **infer_type** | Service configuration (If a service is shared, only **model_id**, **model_name**, and **model_version** are returned.) | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | access_address | String | Access address of an inference request. This parameter is available when **infer_type** is set to **real-time**. | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | bind_access_address | String | Request address of a custom domain name. This parameter is available after a domain name is bound. | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | invocation_times | Number | Total number of service calls | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | failed_times | Number | Number of failed service calls | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_shared | Boolean | Whether a service is subscribed | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | shared_count | Number | Number of subscribed services | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | schedule | **schedule** array | Service scheduling configuration. If this parameter is not set, no value will be returned. For details, see `Table 6 <#modelarts030084enustopic0130035938table1892915349285>`__. | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Number | Time when the configuration used by a service is updated, in milliseconds calculated from 1970.1.1 0:0:0 UTC | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | debug_url | String | Online debugging address of a real-time service. This parameter is available only when the model supports online debugging and there is only one instance. | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | due_time | number | Time when a real-time service automatically stops, in milliseconds calculated from 1970.1.1 0:0:0 UTC | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | operation_time | number | Operation time of a request | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | transition_at | number | Time when the service status changes | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | is_free | Boolean | Whether a free-of-charge flavor is used | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | additional_properties | Map | Additional service attribute | + +-----------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030084enustopic0130035938table313755517348: + +.. table:: **Table 3** **config** parameters of **real-time** + + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+===========================================================================================================================================+ + | model_id | String | Model ID | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | model_name | String | Model name | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | model_version | String | Model version | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | source_type | String | Model source. This parameter is returned when a model is created through ExeML. The value is **auto**. | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Model status. Options: | + | | | | + | | | - **ready**: ready (All instances have been started.) | + | | | - **concerning**: partially ready (Some instances are started and some are not.) | + | | | - **notReady**: not ready (All instances are not started.) | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | weight | Integer | Traffic weight allocated to a model | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | specification | String | Resource flavor. Options: **modelarts.vm.cpu.2u**, **modelarts.vm.gpu.p4**, and **modelarts.vm.ai1.a310** | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | custom_spec | **custom_spec** structure | Custom | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | envs | Map | (Optional) Environment variable key-value pair required for running a model | + | | | | + | | | To ensure data security, do not enter sensitive information, such as plaintext passwords, in environment variables. | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_count | Integer | Number of instances deployed in a model | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | scaling | Boolean | Whether auto scaling is enabled | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | cluster_id | String | ID of a dedicated resource pool used by a service instance. This parameter is returned only when a dedicated resource pool is configured. | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | support_debug | Boolean | Whether a model supports online debugging | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | additional_properties | Map | Additional model deployment attribute | + +-----------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030084enustopic0130035938table14519552151511: + +.. table:: **Table 4** **config** parameters of **batch** + + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+===========================+=============================================================================================================================+ + | model_id | String | Model ID | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | model_name | String | Model name | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | model_version | String | Model version | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | specification | String | Resource flavor. Options: **modelarts.vm.cpu.2u**, **modelarts.vm.gpu.p4**, and **modelarts.vm.ai1.a310** | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | custom_spec | **custom_spec** structure | Custom | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | envs | Map | (Optional) Environment variable key-value pair required for running a model | + | | | | + | | | To ensure data security, do not enter sensitive information, such as plaintext passwords, in environment variables. | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | instance_count | Integer | Number of instances deployed in a model | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | src_type | String | Data source type. This parameter is returned only when **ManifestFile** is specified. | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | src_path | String | OBS path of the input data of a batch job | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | dest_path | String | OBS path of the output data of a batch job | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | req_uri | String | Inference path of a batch job | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | mapping_type | String | Mapping type of the input data. The value can be **file** or **csv**. | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | mapping_rule | Map | Mapping between input parameters and CSV data. This parameter is mandatory only when **mapping_type** is set to **csv**. | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | start_time | Number | Task start time, in milliseconds calculated from 1970.1.1 0:0:0 UTC. This parameter is not returned until the task starts. | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | finished_time | Number | Task finished time, in milliseconds calculated from 1970.1.1 0:0:0 UTC. This parameter is not returned until the task ends. | + +-----------------------+---------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030084enustopic0130035938table59054517233: + +.. table:: **Table 5** **node** parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================+ + | id | String | Node ID | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | name | String | Node name | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | instance_status | String | Status of a model instance on a node. The value can be **running**, **stopped**, **notReady**, or **failed**. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | predict_url | String | Inference URL of a node | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | node_label | String | Node label | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | description | String | Description | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | host_name | String | Host name of a node | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | os_name | String | OS name | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | os_type | String | OS type | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | os_version | String | OS version | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | arch | String | Node architecture | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | cpu | Integer | Number of CPUs | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | memory | Integer | Memory size, in MB | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | gpu_num | Integer | Number of GPUs | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | enable_gpu | String | Whether to enable the GPU | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | host_ips | String array | Host IP of a node | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | deployment_num | Integer | Number of application instances deployed on a node | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | state | String | Host status. Options: | + | | | | + | | | - **RUNNING**: running | + | | | - **FAIL**: faulty | + | | | - **UNCONNECTED**: disconnected | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | created_at | String | Creation time, in the format of *YYYY-MM-DDThh:mm:ss* (UTC) | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | updated_at | String | Update time, in the format of *YYYY-MM-DDThh:mm:ss* (UTC) | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030084enustopic0130035938table1892915349285: + +.. table:: **Table 6** **schedule** parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=============================================================================================================================================+ + | type | String | Scheduling type. Only the value **stop** is supported. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | time_unit | String | Scheduling time unit. Options: | + | | | | + | | | - DAYS | + | | | - HOURS | + | | | - MINUTES | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | Integer | Value that maps to the time unit. For example, if the task stops after two hours, set **time_unit** to **HOURS** and **duration** to **2**. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030084enustopic0130035938table134334512416: + +.. table:: **Table 7** **custom_spec** parameters + + =========== ======= ====================== + Parameter Type Description + =========== ======= ====================== + cpu Float Number of CPUs + memory Integer Memory capacity in MB + gpu_p4 Float Number of GPUs + ascend_a310 Integer Number of Ascend chips + =========== ======= ====================== + +Samples +------- + +The following shows how to query the details about a real-time service based on the service ID. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/services/{service_id} + +- Sample response + + .. code-block:: + + { + "service_id": "f76f20ba-78f5-44e8-893a-37c8c600c02f", + "service_name": "service-demo", + "tenant": "xxxxx", + "project": "xxxxx", + "owner": "xxxxx", + "publish_at": 1585809231902, + "update_time": 1585809358259, + "infer_type": "real-time", + "status": "running", + "progress": 100, + "access_address": "https://xxxxx.apigw.xxxxx/v1/infers/088458d9-5755-4110-97d8-1d21065ea10b/f76f20ba-78f5-44e8-893a-37c8c600c02f", + "cluster_id": "088458d9-5755-4110-97d8-1d21065ea10b", + "workspace_id": "0", + "additional_properties": {}, + "is_shared": false, + "invocation_times": 0, + "failed_times": 0, + "shared_count": 0, + "operation_time": 1586249085447, + "config": [{ + "model_id": "044ebf3d-8bf4-48df-bf40-bad0e664c1e2", + "model_name": "jar-model", + "model_version": "1.0.1", + "specification": "custom", + "custom_spec": {}, + "status": "notReady", + "weight": 100, + "instance_count": 1, + "scaling": false, + "envs": {}, + "additional_properties": {}, + "support_debug": false + }], + "transition_at": 1585809231902, + "is_free": false + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/service_management/updating_service_configurations.rst b/api-ref/source/service_management/updating_service_configurations.rst new file mode 100644 index 0000000..2b91720 --- /dev/null +++ b/api-ref/source/service_management/updating_service_configurations.rst @@ -0,0 +1,169 @@ +Updating Service Configurations +=============================== + +Function +-------- + +This API is used to update configurations of a model service. It can also be used to start or stop a service. + +URI +--- + +PUT /v1/{project_id}/services/{service_id} + +`Table 1 <#modelarts030086enustopic0130045990table10624434011>`__ describes the required parameters. + +.. _modelarts030086enustopic0130045990table10624434011: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+==================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_id | Yes | String | Service ID | + +------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030086enustopic0130045990table188019141442>`__ describes the request parameters. + +.. _modelarts030086enustopic0130045990table188019141442: + +.. table:: **Table 2** Parameters + + +-----------------------+-----------+--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=======================+===========+==================================================+==============================================================================================================================================================================================================================================================+ + | description | No | String | Service description, which contains a maximum of 100 characters. If this parameter is not set, the service description is not updated. | + +-----------------------+-----------+--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | No | String | Service status. The value can be **running** or **stopped**. If this parameter is not set, the service status is not changed. **status** and **config** cannot be modified at the same time. If both parameters exist, modify only the **status** parameter. | + +-----------------------+-----------+--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config | No | **config** array corresponding to **infer_type** | Service configuration. If this parameter is not set, the service is not updated. The model service is modified and the **update_time** parameter is returned only for requests with **config** updated. | + +-----------------------+-----------+--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | schedule | No | **schedule** array | Service scheduling configuration, which can be configured only for real-time services. By default, this parameter is not used. Services run for a long time. For details, see `Table 5 <#modelarts030086enustopic0130045990table1892915349285>`__. | + +-----------------------+-----------+--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | additional_properties | No | Map | Additional service attribute, which facilitates service management | + +-----------------------+-----------+--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030086enustopic0130045990table6841887256: + +.. table:: **Table 3** **config** parameters of **real-time** + + +-----------------+-----------------+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+===========================+=================================================================================================================================================================================================================================+ + | model_id | Yes | String | Model ID | + +-----------------+-----------------+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | weight | Yes | Integer | Traffic weight allocated to a model. This parameter is mandatory only when **infer_type** is set to **real-time**. The sum of the weights must be 100. | + +-----------------+-----------------+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | specification | Yes | String | Resource specifications. Select specifications based on service requirements. | + +-----------------+-----------------+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | custom_spec | No | **custom_spec** structure | Custom specifications. Set this parameter when you use a dedicated resource pool. For details, see `Table 6 <../service_management/deploying_a_model_as_a_service.html#modelarts030082enustopic0129882788table134334512416>`__. | + +-----------------+-----------------+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_count | Yes | Integer | Number of instances deployed in a model. The value must be greater than 0. | + +-----------------+-----------------+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | envs | No | Map | (Optional) Environment variable key-value pair required for running a model. By default, this parameter is left blank. | + | | | | | + | | | | To ensure data security, do not enter sensitive information, such as plaintext passwords, in environment variables. | + +-----------------+-----------------+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | cluster_id | No | string | ID of a dedicated resource pool. By default, this parameter is left blank, indicating that no dedicated resource pool is used. | + +-----------------+-----------------+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030086enustopic0130045990table6420928063: + +.. table:: **Table 4** **config** parameters of **batch** + + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=====================+===========================================================================================================================================================================================================================================================================================================================================+ + | model_id | Yes | String | Model ID | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | specification | Yes | String | Resource flavor. Available options: **modelarts.vm.cpu.2u** and **modelarts.vm.gpu.p4** | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | instance_count | Yes | Integer | Number of instances deployed in a model. | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | envs | No | Map | (Optional) Environment variable key-value pair required for running a model. By default, this parameter is left blank. | + | | | | | + | | | | To ensure data security, do not enter sensitive information, such as plaintext passwords, in environment variables. | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | src_type | No | String | Data source type. This parameter can be set to **ManifestFile**. By default, this parameter is left blank, indicating that only files in the **src_path** directory are read. If this parameter is set to **ManifestFile**, **src_path** must be a specific Manifest file path. You can specify multiple data paths in the Manifest file. | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | src_path | Yes | String | OBS path of the input data of a batch job | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dest_path | Yes | String | OBS path of the output data of a batch job | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | req_uri | Yes | String | Inference API called in a batch task, which is a REST API in the model image. Select an API URI from the model **config.json** file for inference. If a ModelArts built-in inference image is used, the value of this parameter is **/**. | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | mapping_type | Yes | String | Mapping type of the input data. The value can be **file** or **csv**. | + | | | | | + | | | | - If you select **file**, each inference request corresponds to a file in the input data path. When this mode is used, **req_uri** of this model can have only one input parameter and the type of this parameter is **file**. | + | | | | - If you select **csv**, each inference request corresponds to a row of data in the CSV file. When this mode is used, the files in the input data path can only be in CSV format and **mapping_rule** needs to be configured to map the index of each parameter in the inference request body to the CSV file. | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | mapping_rule | No | Map | Mapping between input parameters and CSV data. This parameter is mandatory only when **mapping_type** is set to **csv**. | + | | | | | + | | | | Mapping rule: The mapping rule comes from the input parameter (**input_params**) in the model configuration file **config.json**. When **type** is set to **string**, **number**, **integer**, or **boolean**, you need to configure the index parameter. For details, see . | + | | | | | + | | | | The index must be a positive integer starting from 0. If the value of index does not comply with the rule, this parameter is ignored in the request. After the mapping rule is configured, the corresponding CSV data must be separated by commas (,). | + +-----------------+-----------------+---------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030086enustopic0130045990table1892915349285: + +.. table:: **Table 5** **schedule** parameters + + +-----------+-----------+---------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+=========+=============================================================================================================================================+ + | type | Yes | String | Scheduling type. Only the value **stop** is supported. | + +-----------+-----------+---------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | time_unit | Yes | String | Scheduling time unit. Possible values are **DAYS**, **HOURS**, and **MINUTES**. | + +-----------+-----------+---------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | Yes | Integer | Value that maps to the time unit. For example, if the task stops after two hours, set **time_unit** to **HOURS** and **duration** to **2**. | + +-----------+-----------+---------+---------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +None + +Samples +------- + +The following shows how to update a real-time service. + +- Sample request + + .. code-block:: + + PUT https://endpoint/v1/{project_id}/services/{service_id} + { + "description": "", + "status": "running", + "config": [{ + "model_id": "xxxx", + "weight": "100", + "specification": "modelarts.vm.cpu.2u", + "instance_count": 1 + }] + } + +- Sample response + + .. code-block:: + + {} + +Status Code +----------- + +For details about the status code, see `Table 1 <../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/index.rst b/api-ref/source/training_management/index.rst new file mode 100644 index 0000000..602c5dc --- /dev/null +++ b/api-ref/source/training_management/index.rst @@ -0,0 +1,12 @@ +=================== +Training Management +=================== + +.. toctree:: + :maxdepth: 1 + + training_jobs/index + training_job_parameter_configuration/index + visualization_jobs/index + resource_and_engine_specifications/index + job_statuses diff --git a/api-ref/source/training_management/job_statuses.rst b/api-ref/source/training_management/job_statuses.rst new file mode 100644 index 0000000..8224923 --- /dev/null +++ b/api-ref/source/training_management/job_statuses.rst @@ -0,0 +1,60 @@ +Job Statuses +============ + +`Table 1 <#modelarts030074enustopic0131326476enustopic0105159288table21749790153351>`__ describes the job statuses. + + + +.. _modelarts030074enustopic0131326476enustopic0105159288table21749790153351: + +.. table:: **Table 1** Job statuses + + +--------------+-----------------------------------------------------------------+ + | Status Value | Description | + +==============+=================================================================+ + | 0 | JOBSTAT_UNKNOWN: Unknown status. | + +--------------+-----------------------------------------------------------------+ + | 1 | JOBSTAT_INIT: The job is being initialized. | + +--------------+-----------------------------------------------------------------+ + | 2 | JOBSTAT_IMAGE_CREATING: The job image is being created. | + +--------------+-----------------------------------------------------------------+ + | 3 | JOBSTAT_IMAGE_FAILED: Failed to create the job image. | + +--------------+-----------------------------------------------------------------+ + | 4 | JOBSTAT_SUBMIT_TRYING: The job is being submitted. | + +--------------+-----------------------------------------------------------------+ + | 5 | JOBSTAT_SUBMIT_FAILED: Failed to submit the job. | + +--------------+-----------------------------------------------------------------+ + | 6 | JOBSTAT_DELETE_FAILED: Failed to delete the job. | + +--------------+-----------------------------------------------------------------+ + | 7 | JOBSTAT_WAITING: The job is queuing. | + +--------------+-----------------------------------------------------------------+ + | 8 | JOBSTAT_RUNNING: The job is running. | + +--------------+-----------------------------------------------------------------+ + | 9 | JOBSTAT_KILLING: The job is being canceled. | + +--------------+-----------------------------------------------------------------+ + | 10 | JOBSTAT_COMPLETED: The job has been completed. | + +--------------+-----------------------------------------------------------------+ + | 11 | JOBSTAT_FAILED: Failed to run the job. | + +--------------+-----------------------------------------------------------------+ + | 12 | JOBSTAT_KILLED: Job canceled successfully. | + +--------------+-----------------------------------------------------------------+ + | 13 | JOBSTAT_CANCELED: Job canceled. | + +--------------+-----------------------------------------------------------------+ + | 14 | JOBSTAT_LOST: Job lost. | + +--------------+-----------------------------------------------------------------+ + | 15 | JOBSTAT_SCALING: The job is being scaled. | + +--------------+-----------------------------------------------------------------+ + | 16 | JOBSTAT_SUBMIT_MODEL_FAILED: Failed to submit the model. | + +--------------+-----------------------------------------------------------------+ + | 17 | JOBSTAT_DEPLOY_SERVICE_FAILED: Failed to deploy the service. | + +--------------+-----------------------------------------------------------------+ + | 18 | JOBSTAT_CHECK_INIT: The job review is being initialized. | + +--------------+-----------------------------------------------------------------+ + | 19 | JOBSTAT_CHECK_RUNNING: The job is being reviewed. | + +--------------+-----------------------------------------------------------------+ + | 20 | JOBSTAT_CHECK_RUNNING_COMPLETED: The approval job is completed. | + +--------------+-----------------------------------------------------------------+ + | 21 | JOBSTAT_CHECK_FAILED: Failed to review the job. | + +--------------+-----------------------------------------------------------------+ + + diff --git a/api-ref/source/training_management/resource_and_engine_specifications/index.rst b/api-ref/source/training_management/resource_and_engine_specifications/index.rst new file mode 100644 index 0000000..41c6a19 --- /dev/null +++ b/api-ref/source/training_management/resource_and_engine_specifications/index.rst @@ -0,0 +1,9 @@ +================================== +Resource and Engine Specifications +================================== + +.. toctree:: + :maxdepth: 1 + + querying_job_resource_specifications + querying_job_engine_specifications diff --git a/api-ref/source/training_management/resource_and_engine_specifications/querying_job_engine_specifications.rst b/api-ref/source/training_management/resource_and_engine_specifications/querying_job_engine_specifications.rst new file mode 100644 index 0000000..dc2fb13 --- /dev/null +++ b/api-ref/source/training_management/resource_and_engine_specifications/querying_job_engine_specifications.rst @@ -0,0 +1,138 @@ +Querying Job Engine Specifications +================================== + +Function +-------- + +This API is used to query the engine type and version of a specified job. + +You must specify the engine specifications when creating a training job or an inference job. + +URI +--- + +GET /v1/{project_id}/job/ai-engines + +`Table 1 <#modelarts030073enustopic0131307648table6017292495443>`__ describes the required parameters. + +.. _modelarts030073enustopic0131307648table6017292495443: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030073enustopic0131307648table2918868102420: + +.. table:: **Table 2** Parameters + + +-----------+-----------+--------+--------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+========================================================+ + | job_type | No | String | Job type. The value can be **train** or **inference**. | + +-----------+-----------+--------+--------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 3 <#modelarts030073enustopic0131307648table41713500151328>`__ describes the response parameters. + +.. _modelarts030073enustopic0131307648table41713500151328: + +.. table:: **Table 3** Parameters + + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | engines | **engines** array | List of engine specifications attributes. For details, see `Table 4 <#modelarts030073enustopic0131307648table21589744151355>`__. | + +-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030073enustopic0131307648table21589744151355: + +.. table:: **Table 4** **engines** parameters + + +-----------------------+-----------------------+---------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===================================================+ + | engine_type | Integer | Engine type of a training job | + | | | | + | | | - 1: TensorFlow | + | | | - 5: Spark_MLlib | + | | | - 6: Scikit Learn | + | | | - 9: XGBoost-Sklearn | + | | | - 10: PyTorch | + | | | - 13: Ascend-Powered-Engine | + | | | - 17: MindSpore-GPU | + +-----------------------+-----------------------+---------------------------------------------------+ + | engine_id | Long | ID of the engine selected for a training job | + +-----------------------+-----------------------+---------------------------------------------------+ + | engine_name | String | Name of the engine selected for a training job | + +-----------------------+-----------------------+---------------------------------------------------+ + | engine_version | String | Version of the engine selected for a training job | + +-----------------------+-----------------------+---------------------------------------------------+ + +Samples +------- + +The following shows how to query the engine specifications of a training job. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/job/ai-engines?job_type=train + +- Successful sample response + + .. code-block:: + + { + "is_success": true, + "engines": [ + { + "engine_type": 1, + "engine_name": "TensorFlow", + "engine_id": 1, + "engine_version": "TF-1.4.0-python2.7" + } + ] + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/resource_and_engine_specifications/querying_job_resource_specifications.rst b/api-ref/source/training_management/resource_and_engine_specifications/querying_job_resource_specifications.rst new file mode 100644 index 0000000..4e6e163 --- /dev/null +++ b/api-ref/source/training_management/resource_and_engine_specifications/querying_job_resource_specifications.rst @@ -0,0 +1,172 @@ +Querying Job Resource Specifications +==================================== + +Function +-------- + +This API is used to query the resource specifications of a specified job. + +You must specify the resource specifications when creating a training job or an inference job. + +URI +--- + +GET /v1/{project_id}/job/resource-specs + +`Table 1 <#modelarts030072enustopic0131307647table5822680595335>`__ describes the required parameters. + +.. _modelarts030072enustopic0131307647table5822680595335: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030072enustopic0131307647table2918868102420: + +.. table:: **Table 2** Parameters + + +--------------+-----------+---------+--------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+=========+========================================================+ + | job_type | No | String | Job type. The value can be **train** or **inference**. | + +--------------+-----------+---------+--------------------------------------------------------+ + | engine_id | No | Long | Engine ID of a job. Default value: **0** | + +--------------+-----------+---------+--------------------------------------------------------+ + | project_type | No | Integer | Project type. Default value: **0** | + +--------------+-----------+---------+--------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 3 <#modelarts030072enustopic0131307647table1817887315129>`__ describes the response parameters. + +.. _modelarts030072enustopic0131307647table1817887315129: + +.. table:: **Table 3** Parameters + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+====================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | spec_total_count | Integer | Total number of job resource specifications | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | specs | **specs** array | List of resource specifications attributes. For details, see `Table 4 <#modelarts030072enustopic0131307647table20408880151239>`__. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030072enustopic0131307647table20408880151239: + +.. table:: **Table 4** **specs** parameters + + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+=========+====================================================================================================================+ + | spec_id | Long | ID of the resource specifications | + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + | core | String | Number of cores of the resource specifications | + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + | cpu | String | CPU memory of the resource specifications | + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + | gpu_num | Integer | Number of GPUs of the resource specifications | + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + | gpu_type | String | GPU type of the resource specifications | + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + | spec_code | String | Type of the resource specifications | + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + | max_num | Integer | Maximum number of nodes that can be selected | + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + | unit_num | Integer | Number of pricing units | + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + | storage | String | SSD size of a resource flavor | + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + | interface_type | Integer | Interface type | + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + | no_resource | Boolean | Whether the resources of the selected specifications are sufficient. True indicates that no resource is available. | + +----------------+---------+--------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to query the resource specifications of a training job. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/job/resource-specs?job_type=train + +- Successful sample response + + .. code-block:: + + { + "specs": [ + + { + "spec_id": 2, + "core": "2", + "cpu": "8", + "gpu_num": 0, + "gpu_type": "", + "spec_code": "modelarts.vm.cpu.2u", + "unit_num": 1, + "max_num": 2, + "storage": "", + "interface_type": 1, + "no_resource": false + }, + { + "spec_id": 4, + "core": "8", + "cpu": "64", + "gpu_num": 1, + "gpu_type": "v100", + "spec_code":"modelarts.vm.gpu.v100", + "unit_num": 1, + "max_num": 4, + "storage": "", + "interface_type": 1, + "no_resource": false + } + ], + "is_success": true, + "spec_total_count": 2 + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/training_job_parameter_configuration/creating_a_training_job_configuration.rst b/api-ref/source/training_management/training_job_parameter_configuration/creating_a_training_job_configuration.rst new file mode 100644 index 0000000..3c04dfe --- /dev/null +++ b/api-ref/source/training_management/training_job_parameter_configuration/creating_a_training_job_configuration.rst @@ -0,0 +1,186 @@ +Creating a Training Job Configuration +===================================== + +Function +-------- + +This API is used to create a training job configuration. + +URI +--- + +POST /v1/{project_id}/training-job-configs + +`Table 1 <#modelarts030058enustopic0131292962table20736351173356>`__ describes the required parameters. + +.. _modelarts030058enustopic0131292962table20736351173356: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030058enustopic0131292962table25599433145051>`__ describes the request parameters. + +.. _modelarts030058enustopic0131292962table25599433145051: + +.. table:: **Table 2** Parameters + + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+=================+=================+========================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | config_name | Yes | String | Name of a training job configuration. The value is a string of 1 to 64 characters consisting of only digits, letters, underscores (_), and hyphens (-). | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config_desc | No | String | Description of a training job configuration. The value is a string of 0 to 256 characters. By default, this parameter is left blank. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_server_num | Yes | Integer | Number of workers in a training job. Obtain the maximum value from `Querying Job Resource Specifications <../../training_management/resource_and_engine_specifications/querying_job_resource_specifications.html#modelarts030072>`__. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | app_url | Yes | String | Code directory of a training job, for example, **/usr/app/**. This parameter must be used together with **boot_file_url**. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | boot_file_url | Yes | String | Boot file of a training job, which needs to be stored in the code directory, for example, **/usr/app/boot.py**. This parameter must be used together with **app_url**. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | Yes | Long | Model ID of a training job. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parameter | No | Array | Running parameters of a training job. It is a collection of label-value pairs. For details, see the sample request. This parameter is a container environment variable when a training job uses a custom image. For details, see `Table 4 <#modelarts030058enustopic0131292962table1267642234716>`__. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec_id | Yes | Long | ID of the resource specifications selected for a training job. Obtain the ID by calling the API described in `Querying Job Resource Specifications <../../training_management/resource_and_engine_specifications/querying_job_resource_specifications.html#modelarts030072>`__. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | Yes | String | OBS URL of the dataset required by a training job, for example, **/usr/data/**. | + | | | | | + | | | | This parameter cannot be used together with **data_source** or **dataset_id** and **dataset_version_id**. However, one of the parameters must exist. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | Yes | String | Dataset ID of a training job. This parameter must be used together with **dataset_version_id**, but cannot be used together with **data_url** or **data_source**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_id | Yes | String | Dataset version ID of a training job. This parameter must be used together with **dataset_id**, but cannot be used together with **data_url** or **data_source**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | Yes | JSON Array | Dataset of a training job. This parameter cannot be used together with **data_url** or **dataset_id** and **dataset_version_id**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_id | Yes | Long | ID of the engine selected for a training job. The default value is **1**. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. Obtain the ID by calling the API described in `Querying Job Engine Specifications <../../training_management/resource_and_engine_specifications/querying_job_engine_specifications.html#modelarts030073>`__. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | No | String | OBS URL of the output file of a training job. By default, this parameter is left blank. Example value: **/usr/train/** | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_url | No | String | OBS URL of the logs of a training job. By default, this parameter is left blank. Example value: **/usr/train/** | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_image_url | No | String | SWR URL of a custom image used by a training job. Example value: **100.125.5.235:20202/jobmng/custom-cpu-base:1.0** | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_command | No | String | Boot command used to start the container of a custom image of a training job. The format is **bash /home/work/run_train.sh python /home/work/user-job-dir/app/train.py {python_file_parameter}**. The **run_train.sh** script needs to be invoked to initialize variables, such as the AK/SK. The **run_train.sh** script is followed by **python** to ensure that the Python files can be executed in the initialized variable environment. **run_train.sh** is used to start Python. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030058enustopic0131292962table11121353175910: + +.. table:: **Table 3** **data_source** parameters + + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+===========+========+================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID of a training job. This parameter must be used together with **dataset_version_id**, but cannot be used together with **data_url**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version | Yes | String | Dataset version ID of a training job. This parameter must be used together with **dataset_id**, but cannot be used together with **data_url**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | Yes | String | Dataset type. The value can be **obs** or **dataset**. obs and dataset cannot be used at the same time. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | Yes | String | OBS bucket path. This parameter cannot be used together with **dataset_id** or **dataset_version**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030058enustopic0131292962table1267642234716: + +.. table:: **Table 4** **parameter** parameters + + ========= ========= ====== ================ + Parameter Mandatory Type Description + ========= ========= ====== ================ + label No String Parameter name. + value No String Parameter value. + ========= ========= ====== ================ + +Response Body +------------- + +`Table 5 <#modelarts030058enustopic0131292962table66235177145332>`__ describes the response parameters. + +.. _modelarts030058enustopic0131292962table66235177145332: + +.. table:: **Table 5** Parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +#. The following shows how to create a training job configuration whose name is **testConfig** and description is **This is config**. + + - Sample request + + .. code-block:: + + POST https://endpoint/v1/{project_id}/training-job-configs + { + "config_name": "testConfig", + "config_desc": "This is config", + "worker_server_num": 1, + "app_url": "/usr/app/", + "boot_file_url": "/usr/app/boot.py", + "parameter": [ + { + "label": "learning_rate", + "value": "0.01" + }, + { + "label": "batch_size", + "value": "32" + } + ], + "spec_id": 1, + "dataset_id": "38277e62-9e59-48f4-8d89-c8cf41622c24", + "dataset_version_id": "2ff0d6ba-c480-45ae-be41-09a8369bfc90", + "engine_id": 1, + "train_url": "/usr/train/", + "log_url": "/usr/log/" + } + +- Successful sample response + + .. code-block:: + + { + "is_success": true + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_job_parameter_configuration/deleting_a_training_job_configuration.rst b/api-ref/source/training_management/training_job_parameter_configuration/deleting_a_training_job_configuration.rst new file mode 100644 index 0000000..2510316 --- /dev/null +++ b/api-ref/source/training_management/training_job_parameter_configuration/deleting_a_training_job_configuration.rst @@ -0,0 +1,90 @@ +Deleting a Training Job Configuration +===================================== + +Function +-------- + +This API is used to delete a training job configuration. + +URI +--- + +DELETE /v1/{project_id}/training-job-configs/{config_name} + +`Table 1 <#modelarts030061enustopic0131292965table486226859532>`__ describes the required parameters. + +.. _modelarts030061enustopic0131292965table486226859532: + +.. table:: **Table 1** Parameter description + + +-------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +-------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config_name | Yes | String | Name of a training job configuration | + +-------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030061enustopic0131292965table5371703815645>`__ describes the response parameters. + + + +.. _modelarts030061enustopic0131292965table5371703815645: + +.. table:: **Table 2** Parameter description + + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to delete the job configuration named **test-trainconfig**. + +- Sample request + + .. code-block:: + + DELETE https://endpoint/v1/{project_id}/training-job-configs/test-trainconfig + +- Successful sample response + + .. code-block:: + + { + "is_success": true + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/training_job_parameter_configuration/index.rst b/api-ref/source/training_management/training_job_parameter_configuration/index.rst new file mode 100644 index 0000000..664ad59 --- /dev/null +++ b/api-ref/source/training_management/training_job_parameter_configuration/index.rst @@ -0,0 +1,12 @@ +==================================== +Training Job Parameter Configuration +==================================== + +.. toctree:: + :maxdepth: 1 + + creating_a_training_job_configuration + querying_a_list_of_training_job_configurations + modifying_a_training_job_configuration + deleting_a_training_job_configuration + querying_the_details_about_a_training_job_configuration diff --git a/api-ref/source/training_management/training_job_parameter_configuration/modifying_a_training_job_configuration.rst b/api-ref/source/training_management/training_job_parameter_configuration/modifying_a_training_job_configuration.rst new file mode 100644 index 0000000..b3bca42 --- /dev/null +++ b/api-ref/source/training_management/training_job_parameter_configuration/modifying_a_training_job_configuration.rst @@ -0,0 +1,184 @@ +Modifying a Training Job Configuration +====================================== + +Function +-------- + +This API is used to modify a training job configuration. + +URI +--- + +PUT /v1/{project_id}/training-job-configs/{config_name} + +`Table 1 <#modelarts030060enustopic0131292964table5935107791848>`__ describes the required parameters. + +.. _modelarts030060enustopic0131292964table5935107791848: + +.. table:: **Table 1** Parameters + + +-------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +-------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config_name | Yes | String | Name of a training job configuration | + +-------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030060enustopic0131292964table5503766015447>`__ describes the request parameters. + +.. _modelarts030060enustopic0131292964table5503766015447: + +.. table:: **Table 2** Parameters + + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+=================+=================+========================================================================================================================================================================================================================================================================================+ + | config_desc | No | String | Description of a training job configuration. The value is a string of 0 to 256 characters. By default, this parameter is left blank. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_server_num | Yes | Integer | Number of workers in a training job. Obtain the maximum value from `Querying Job Resource Specifications <../../training_management/resource_and_engine_specifications/querying_job_resource_specifications.html#modelarts030072>`__. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | app_url | Yes | String | Code directory of a training job, for example, **/usr/app/**. This parameter must be used together with **boot_file_url**. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | boot_file_url | Yes | String | Boot file of a training job, which needs to be stored in the code directory, for example, **/usr/app/boot.py**. This parameter must be used together with **app_url**. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | Yes | Long | Model ID of a training job. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parameter | No | Array | Running parameters of a training job. It is a collection of label-value pairs. This parameter is a container environment variable when a training job uses a custom image. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec_id | Yes | Long | ID of the resource specifications selected for a training job. Obtain the ID by calling the API described in `Querying Job Resource Specifications <../../training_management/resource_and_engine_specifications/querying_job_resource_specifications.html#modelarts030072>`__. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | Yes | String | OBS URL of the dataset required by a training job, for example, **/usr/data/**. | + | | | | | + | | | | This parameter cannot be used together with **data_source** or **dataset_id** and **dataset_version_id**. However, one of the parameters must exist. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | Yes | String | Dataset ID of a training job. This parameter must be used together with **dataset_version_id**, but cannot be used together with **data_url** or **data_source**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_id | Yes | String | Dataset version ID of a training job. This parameter must be used together with **dataset_id**, but cannot be used together with **data_url** or **data_source**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | Yes | JSON Array | Dataset of a training job. This parameter cannot be used together with **data_url** or **dataset_id** and **dataset_version_id**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_id | Yes | Long | ID of the engine selected for a training job. The default value is **1**. Obtain the ID by calling the API described in `Querying Job Engine Specifications <../../training_management/resource_and_engine_specifications/querying_job_engine_specifications.html#modelarts030073>`__. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | No | String | OBS URL of the output file of a training job. By default, this parameter is left blank. Example value: **/usr/train/** | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_url | No | String | OBS URL of the logs of a training job. By default, this parameter is left blank. Example value: **/usr/train/** | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_image_url | No | String | SWR URL of a custom image used by a training job. Example value: **100.125.5.235:20202/jobmng/custom-cpu-base:1.0** | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_command | No | String | Boot command used to start the container of a custom image of a training job. The format is **bash /home/work/run_train.sh python /home/work/user-job-dir/app/train.py {python_file_parameter}**. | + +--------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030060enustopic0131292964table250595919011: + +.. table:: **Table 3** **data_source** parameters + + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+===========+========+================================================================================================================================================+ + | dataset_id | No | String | Dataset ID of a training job. This parameter must be used together with **dataset_version_id**, but cannot be used together with **data_url**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version | No | String | Dataset version ID of a training job. This parameter must be used together with **dataset_id**, but cannot be used together with **data_url**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | No | String | Dataset type. The value can be **obs** or **dataset**. obs and dataset cannot be used at the same time. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | No | String | OBS bucket path. This parameter cannot be used together with **dataset_id** or **dataset_version**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030060enustopic0131292964table1267642234716: + +.. table:: **Table 4** **parameter** parameters + + ========= ========= ====== ================ + Parameter Mandatory Type Description + ========= ========= ====== ================ + label No String Parameter name. + value No String Parameter value. + ========= ========= ====== ================ + +Response Body +------------- + +`Table 5 <#modelarts030060enustopic0131292964table5371703815645>`__ describes the response parameters. + +.. _modelarts030060enustopic0131292964table5371703815645: + +.. table:: **Table 5** Parameters + + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +#. The following shows how to modify the job parameter configuration named **config**. + + - Sample request + + .. code-block:: + + PUT https://endpoint/v1/{project_id}/training-job-configs/config + + { + "config_desc": "This is config", + "worker_server_num": 1, + "app_url": "/usr/app/", + "boot_file_url": "/usr/app/boot.py", + "parameter": [ + { + "label": "learning_rate", + "value": 0.01 + }, + { + "key": "batch_size", + "value": 32 + } + ], + "spec_id": 1, + "dataset_id": "38277e62-9e59-48f4-8d89-c8cf41622c24", + "dataset_version_id": "2ff0d6ba-c480-45ae-be41-09a8369bfc90", + "engine_id": 1, + "train_url": "/usr/train/", + "log_url": "/usr/log/" + } + + - Successful sample response + + .. code-block:: + + { + "is_success": true + } + + - Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/training_job_parameter_configuration/querying_a_list_of_training_job_configurations.rst b/api-ref/source/training_management/training_job_parameter_configuration/querying_a_list_of_training_job_configurations.rst new file mode 100644 index 0000000..3a3f203 --- /dev/null +++ b/api-ref/source/training_management/training_job_parameter_configuration/querying_a_list_of_training_job_configurations.rst @@ -0,0 +1,156 @@ +Querying a List of Training Job Configurations +============================================== + +Function +-------- + +This API is used to query the created training job configurations that meet the search criteria. + +URI +--- + +GET /v1/{project_id}/training-job-configs + +`Table 1 <#modelarts030059enustopic0131292963table3329924091755>`__ describes the required parameters. + +.. _modelarts030059enustopic0131292963table3329924091755: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030059enustopic0131292963table19858192884410>`__ describes the request parameters. + + + +.. _modelarts030059enustopic0131292963table19858192884410: + +.. table:: **Table 2** Parameters + + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==================================================================================================================================================================================================+ + | per_page | No | Integer | Number of job parameters displayed on each page. The value range is [1, 1000]. Default value: **10** | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | page | No | Integer | Index of the page to be queried. Default value: **1** | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sortBy | No | String | Sorting mode of the query. The value can be **config_name**, **config_desc**, or **create_time**. The default value is **config_name**. **create_time** is not supported for **sample** sorting. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting order. Options: | + | | | | | + | | | | - **asc**: ascending order | + | | | | - **desc**: descending order. The default value is **desc**. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_content | No | String | Search content, for example, a parameter name. By default, this parameter is left blank. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config_type | No | String | Configuration type to be queried. Options: | + | | | | | + | | | | - **custom**: Query the custom configurations. | + | | | | - **sample**: Query the sample configurations. The default value is **custom**. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030059enustopic0131292963table1356779515036>`__ describes the response parameters. + +.. _modelarts030059enustopic0131292963table1356779515036: + +.. table:: **Table 3** Parameters + + +--------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +====================+============+==========================================================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +--------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. This parameter is not included when the API call succeeds. | + +--------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. This parameter is not included when the API call succeeds. | + +--------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config_total_count | Integer | Total number of the queried training job configurations | + +--------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | configs | JSON Array | **configs** parameters | + +--------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030059enustopic0131292963table4848297015115: + +.. table:: **Table 4** **configs** parameters + + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +================+=========+===================================================================================================================================================================================================+ + | config_name | String | Name of a training job configuration | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config_desc | String | Description of a training job configuration | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a training job is created | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_type | Integer | Engine type of a training job | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_name | String | Name of the engine selected for a training job | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_id | Long | ID of the engine selected for a training job | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_version | String | Version of the engine selected for a training job | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_image_url | String | SWR URL of a custom image used by a training job. Example value: **100.125.5.235:20202/jobmng/custom-cpu-base:1.0** | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_command | String | Boot command used to start the container of a custom image of a training job. The format is **bash /home/work/run_train.sh python /home/work/user-job-dir/app/train.py {python_file_parameter}**. | + +----------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/training-job-configs?per_page=10&page=1&sortBy=create_time&order=asc&search_content=configname + +- Successful sample response + + .. code-block:: + + { + "is_success": true, + "config_total_count": 3, + "configs": [ + { + "config_name": "testConfig", + "config_desc": "This is config", + "create_time": 1524189990635, + "engine_type": 1, + "engine_name": "TensorFlow", + "engine_id": 1, + "engine_version": "TF-1.4.0-python2.7", + "user_image_url": "100.125.5.235:20202/jobmng/custom-cpu-base:1.0", + "user_command": "bash -x /home/work/run_train.sh python /home/work/user-job-dir/app/mnist/mnist_softmax.py --data_url /home/work/user-job-dir/app/mnist_data" + } + ] + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_job_parameter_configuration/querying_the_details_about_a_training_job_configuration.rst b/api-ref/source/training_management/training_job_parameter_configuration/querying_the_details_about_a_training_job_configuration.rst new file mode 100644 index 0000000..413d650 --- /dev/null +++ b/api-ref/source/training_management/training_job_parameter_configuration/querying_the_details_about_a_training_job_configuration.rst @@ -0,0 +1,320 @@ +Querying the Details About a Training Job Configuration +======================================================= + +Function +-------- + +This API is used to query the details about a specified training job configuration. + +URI +--- + +GET /v1/{project_id}/training-job-configs/{config_name} + +`Table 1 <#modelarts030062enustopic0131292966table20736351173356>`__ describes the required parameters. + +.. _modelarts030062enustopic0131292966table20736351173356: + +.. table:: **Table 1** Parameters + + +-------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +-------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config_name | Yes | String | Name of a training job configuration | + +-------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030062enustopic0131292966table19858192884410>`__ describes the request parameters. + + + +.. _modelarts030062enustopic0131292966table19858192884410: + +.. table:: **Table 2** Parameters + + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==================================================================================+ + | config_type | No | String | Configuration type to be queried. Options: | + | | | | | + | | | | - **custom**: Query the custom configurations. | + | | | | - **sample**: Query the sample configurations. The default value is **custom**. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030062enustopic0131292966table40332958145532>`__ describes the response parameters. + +.. _modelarts030062enustopic0131292966table40332958145532: + +.. table:: **Table 3** Parameters + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==================================================================================================================================================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config_name | String | Name of a training job configuration | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | config_desc | String | Description of a training job configuration | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_server_num | Integer | Number of workers in a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | app_url | String | Code directory of a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | boot_file_url | String | Boot file of a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | Long | Model ID of a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parameter | JSON Array | Running parameters of a training job. It is a collection of label-value pairs. This parameter is a container environment variable when a training job uses a custom image. For details, see `Table 8 <#modelarts030062enustopic0131292966table1267642234716>`__. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec_id | Long | ID of the resource specifications selected for a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | String | Dataset of a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | String | Dataset ID of a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_id | String | Dataset version ID of a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | JSON Array | Datasets of a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_type | Integer | Engine type of a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_name | String | Name of the engine selected for a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_id | Long | ID of the engine selected for a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_version | String | Version of the engine selected for a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | String | OBS URL of the output file of a training job. By default, this parameter is left blank. Example value: **/usr/train/** | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_url | String | OBS URL of the logs of a training job. By default, this parameter is left blank. Example value: **/usr/train/** | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_image_url | String | SWR URL of a custom image used by a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_command | String | Boot command used to start the container of a custom image of a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec_code | String | Resource specifications selected for a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | gpu_type | String | GPU type of the resource specifications | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a training job parameter configuration is created | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | cpu | String | CPU memory of the resource specifications | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | gpu_num | Integer | Number of GPUs of the resource specifications | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | core | String | Number of cores of the resource specifications | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_name | String | Dataset of a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_name | String | Dataset of a training job | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_id | String | ID of a resource pool | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_name | String | Name of a resource pool | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | volumes | JSON Array | Storage volume that can be used by a training job. For details, see `Table 5 <#modelarts030062enustopic0131292966table6403153714711>`__. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | nas_mount_path | String | Local mount path of SFS Turbo (NAS). Example value: **/home/work/nas** | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | nas_share_addr | String | Shared path of SFS Turbo (NAS). Example value: **192.168.8.150:/** | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | nas_type | String | Only NFS is supported. Example value: **nfs** | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030062enustopic0131292966table250595919011: + +.. table:: **Table 4** **data_source** parameters + + +-----------------------+-----------------------+--------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================+ + | dataset_id | String | Dataset ID of a training job | + +-----------------------+-----------------------+--------------------------------------------------------+ + | dataset_version | String | Dataset version ID of a training job | + +-----------------------+-----------------------+--------------------------------------------------------+ + | type | String | Dataset type. Options: | + | | | | + | | | - **obs**: Data from OBS is used. | + | | | | + | | | - **dataset**: Data from a specified dataset is used. | + +-----------------------+-----------------------+--------------------------------------------------------+ + | data_url | String | OBS bucket path | + +-----------------------+-----------------------+--------------------------------------------------------+ + + + +.. _modelarts030062enustopic0131292966table6403153714711: + +.. table:: **Table 5** **volumes** parameters + + +-----------+------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+======+======================================================================================================================================================================================================================================================================+ + | nfs | JSON | Storage volume of the shared file system type. Only the training jobs running in the resource pool with the shared file system network connected support such storage volume. For details, see `Table 6 <#modelarts030062enustopic0131292966table19871043113315>`__. | + +-----------+------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | host_path | JSON | Storage volume of the host file system type. Only training jobs running in the dedicated resource pool support such storage volume. For details, see `Table 7 <#modelarts030062enustopic0131292966table4873028185611>`__. | + +-----------+------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030062enustopic0131292966table19871043113315: + +.. table:: **Table 6** **nfs** parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=====================================================================+ + | id | String | ID of an SFS Turbo file system | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | src_path | String | Address of an SFS Turbo file system | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | dest_path | String | Local path of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | read_only | Boolean | Whether **dest_path** is read-only. The default value is **false**. | + | | | | + | | | - **true**: read-only permission | + | | | - **false**: read/write permission. This is the default value. | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + + + +.. _modelarts030062enustopic0131292966table4873028185611: + +.. table:: **Table 7** **host_path** parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=====================================================================+ + | src_path | String | Local path of a host | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | dest_path | String | Local path of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | read_only | Boolean | Whether **dest_path** is read-only. The default value is **false**. | + | | | | + | | | - **true**: read-only permission | + | | | - **false**: read/write permission. This is the default value. | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + + + +.. _modelarts030062enustopic0131292966table1267642234716: + +.. table:: **Table 8** **parameter** parameters + + ========= ====== =============== + Parameter Type Description + ========= ====== =============== + label String Parameter name + value String Parameter value + ========= ====== =============== + +Samples +------- + +The following shows how to query the details about the job configuration named **config123**. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/training-job-configs/config123 + +- Successful sample response + + .. code-block:: + + { + "spec_code": "modelarts.vm.gpu.v100", + "user_image_url": "100.125.5.235:20202/jobmng/custom-cpu-base:1.0", + "user_command": "bash -x /home/work/run_train.sh python /home/work/user-job-dir/app/mnist/mnist_softmax.py --data_url /home/work/user-job-dir/app/mnist_data", + + "dataset_version_id": "2ff0d6ba-c480-45ae-be41-09a8369bfc90", + "engine_name": "TensorFlow", + "is_success": true, + "nas_mount_path": "/home/work/nas", + "worker_server_num": 1, + "nas_share_addr": "192.168.8.150:/", + "train_url": "/test/minst/train_out/out1/", + "nas_type": "nfs", + "spec_id": 4, + "parameter": [ + { + "label": "learning_rate", + "value": 0.01 + } + ], + "log_url": "/usr/log/", + "config_name": "config123", + "app_url": "/usr/app/", + "create_time": 1559045426000, + "dataset_id": "38277e62-9e59-48f4-8d89-c8cf41622c24", + "volumes": [ + { + "nfs": { + "id": "43b37236-9afa-4855-8174-32254b9562e7", + "src_path": "192.168.8.150:/", + "dest_path": "/home/work/nas", + "read_only": false + } + }, + { + "host_path": { + "src_path": "/root/work", + "dest_path": "/home/mind", + "read_only": false + } + } + ], + "cpu": "64", + "model_id": 4, + "boot_file_url": "/usr/app/boot.py", + "dataset_name": "dataset-test", + "pool_id": "pool9928813f", + "config_desc": "This is a config desc test", + "gpu_num": 1, + "data_source": [ + { + "type": "obs", + "data_url": "/test/minst/data/" + } + ], + "pool_name": "p100", + "dataset_version_name": "dataset-version-test", + "core": "8", + "engine_type": 1, + "engine_id": 3, + "engine_version": "TF-1.8.0-python2.7", + "data_url": "/test/minst/data/" + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/training_jobs/creating_a_training_job.rst b/api-ref/source/training_management/training_jobs/creating_a_training_job.rst new file mode 100644 index 0000000..d5e0c10 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/creating_a_training_job.rst @@ -0,0 +1,365 @@ +Creating a Training Job +======================= + +Function +-------- + +This API is used to create a training job. + +Calling this API is an asynchronous operation. The job status can be obtained by calling the APIs described in `Querying a Training Job List <../../training_management/training_jobs/querying_a_training_job_list.html#modelarts030046>`__ and `Querying the Details About a Training Job Version <../../training_management/training_jobs/querying_the_details_about_a_training_job_version.html#modelarts030047>`__. + +URI +--- + +POST /v1/{project_id}/training-jobs + +`Table 1 <#modelarts030045enustopic0131062889table143351836151117>`__ describes the required parameters. + +.. _modelarts030045enustopic0131062889table143351836151117: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030045enustopic0131062889table6270801111211>`__ describes the request parameters. + +.. _modelarts030045enustopic0131062889table6270801111211: + +.. table:: **Table 2** Parameters + + +--------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+======================================================================================================================================+ + | job_name | Yes | String | Training job name. The value is a string of 1 to 64 characters consisting of only digits, letters, underscores (_), and hyphens (-). | + +--------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------+ + | job_desc | No | String | Description of a training job. The value is a string of 0 to 256 characters. By default, this parameter is left blank. | + +--------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------+ + | config | Yes | JSON | Parameters for creating a training job | + +--------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | Workspace where a job resides. Default value: **0** | + +--------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030045enustopic0131062889table24411850104213: + +.. table:: **Table 3** **config** parameters + + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+=================+=================+=====================================================================================================================================================================================================================================================================================================================================================================================================+ + | worker_server_num | Yes | Integer | Number of workers in a training job. Obtain the maximum value from the **max_num** value returned by the API in `Querying Job Resource Specifications <../../training_management/resource_and_engine_specifications/querying_job_resource_specifications.html#modelarts030072>`__. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | app_url | Yes | String | Code directory of a training job, for example, **/usr/app/**. This parameter must be used together with **boot_file_url**. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | boot_file_url | Yes | String | Boot file of a training job, which needs to be stored in the code directory. Example value: **/usr/app/boot.py** This parameter must be used together with **app_url**. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parameter | No | Array | Running parameters of a training job. It is a collection of label-value pairs. Values can be customized. **label** is a parameter name and **value** is the parameter value. For details, see the sample request. This parameter is a container environment variable when a training job uses a custom image. For details, see `Table 8 <#modelarts030045enustopic0131062889table1267642234716>`__. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | Yes | String | OBS URL of the dataset required by a training job. By default, this parameter is left blank. For example, **/usr/data/**. This parameter cannot be used together with **data_source** or **dataset_id** and **dataset_version_id**. However, one of the parameters must exist. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | Yes | String | Dataset ID of a training job. This parameter must be used together with **dataset_version_id**, but cannot be used together with **data_url** or **data_source**. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_id | Yes | String | Dataset version ID of a training job. This parameter must be used together with **dataset_id**, but cannot be used together with **data_url** or **data_source**. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | Yes | Array | Dataset of a training job. This parameter cannot be used together with **data_url** or **dataset_id** and **dataset_version_id**. For details, see `Table 4 <#modelarts030045enustopic0131062889table250595919011>`__. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec_id | Yes | Long | ID of the resource specifications selected for a training job. Obtain the ID by calling the API described in `Querying Job Resource Specifications <../../training_management/resource_and_engine_specifications/querying_job_resource_specifications.html#modelarts030072>`__. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_id | Yes | Long | ID of the engine selected for a training job. The default value is **1**. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. Obtain the ID by calling the API described in `Querying Job Engine Specifications <../../training_management/resource_and_engine_specifications/querying_job_engine_specifications.html#modelarts030073>`__. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | No | String | OBS URL of the output file of a training job. By default, this parameter is left blank. Example value: **/usr/train/** | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_url | No | String | OBS URL of the logs of a training job. By default, this parameter is left blank. Example value: **/usr/log/** | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_image_url | No | String | SWR URL of a custom image used by a training job. Example value: **100.125.5.235:20202/jobmng/custom-cpu-base:1.0** | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_command | No | String | Boot command used to start the container of a custom image of a training job. The format is **bash /home/work/run_train.sh python /home/work/user-job-dir/app/train.py {python_file_parameter}**. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_version | No | Boolean | Whether a version is created when a training job is created | + | | | | | + | | | | - **true**: Default value. A version is created when a training job is created. | + | | | | - **false**: A version is not created when a training job is created. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | volumes | No | JSON Array | Storage volume that can be used by a training job. For details, see `Table 5 <#modelarts030045enustopic0131062889table6403153714711>`__. | + +--------------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030045enustopic0131062889table250595919011: + +.. table:: **Table 4** **data_source** parameters + + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+===========+========+================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID of a training job. This parameter must be used together with **dataset_version_id**, but cannot be used together with **data_url**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version | Yes | String | Dataset version ID of a training job. This parameter must be used together with **dataset_id**, but cannot be used together with **data_url**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | Yes | String | Dataset type. The value can be **obs** or **dataset**. **obs** and **dataset** cannot be used at the same time. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | Yes | String | OBS bucket path. This parameter cannot be used together with **dataset_id** or **dataset_version**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030045enustopic0131062889table6403153714711: + +.. table:: **Table 5** **volumes** parameters + + +-----------+-----------+------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+======+======================================================================================================================================================================================================================================================================+ + | nfs | No | JSON | Storage volume of the shared file system type. Only the training jobs running in the resource pool with the shared file system network connected support such storage volume. For details, see `Table 6 <#modelarts030045enustopic0131062889table19871043113315>`__. | + +-----------+-----------+------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | host_path | No | JSON | Storage volume of the host file system type. Only training jobs running in the dedicated resource pool support such storage volume. For details, see `Table 7 <#modelarts030045enustopic0131062889table4873028185611>`__. | + +-----------+-----------+------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030045enustopic0131062889table19871043113315: + +.. table:: **Table 6** **nfs** parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=====================================================================+ + | id | Yes | String | ID of an SFS Turbo file system | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | src_path | Yes | String | Address of an SFS Turbo file system | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | dest_path | Yes | String | Local path of a training job | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | read_only | No | Boolean | Whether **dest_path** is read-only. The default value is **false**. | + | | | | | + | | | | - **true**: read-only permission | + | | | | - **false**: read/write permission. This is the default value. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + + + +.. _modelarts030045enustopic0131062889table4873028185611: + +.. table:: **Table 7** **host_path** parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=====================================================================+ + | src_path | Yes | String | Local path of a host | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | dest_path | Yes | String | Local path of a training job | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | read_only | No | Boolean | Whether **dest_path** is read-only. The default value is **false**. | + | | | | | + | | | | - **true**: read-only permission | + | | | | - **false**: read/write permission. This is the default value. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + + + +.. _modelarts030045enustopic0131062889table1267642234716: + +.. table:: **Table 8** **parameter** parameters + + ========= ========= ====== =============== + Parameter Mandatory Type Description + ========= ========= ====== =============== + label No String Parameter name + value No String Parameter value + ========= ========= ====== =============== + +Response Body +------------- + +`Table 9 <#modelarts030045enustopic0131062889table84321612917>`__ describes the response parameters. + + + +.. _modelarts030045enustopic0131062889table84321612917: + +.. table:: **Table 9** Parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===================================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Long | ID of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_name | String | Name of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Int | Status of a training job. For details about the job statuses, see `Job Statuses <../../training_management/job_statuses.html#modelarts030074>`__. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Timestamp when a training job is created | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Long | Version ID of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource_id | String | Charged resource ID of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Version name of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +#. The following shows how to create training job **TestModelArtsJob** with **This is a ModelArts job** as its description. + + - Sample request + + .. code-block:: + + POST https://endpoint/v1/{project_id}/training-jobs + { + "job_name": "TestModelArtsJob", + "job_desc": "This is a ModelArts job", + "workspace_id": "af261af2218841ec960b01ab3cf1a5fa", + "config": { + "worker_server_num": 1, + "app_url": "/usr/app/", + "boot_file_url": "/usr/app/boot.py", + "parameter": [ + { + "label": "learning_rate", + "value": "0.01" + }, + { + "label": "batch_size", + "value": "32" + } + ], + "dataset_id": "38277e62-9e59-48f4-8d89-c8cf41622c24", + "dataset_version_id": "2ff0d6ba-c480-45ae-be41-09a8369bfc90", + "spec_id": 1, + "engine_id": 1, + "train_url": "/usr/train/", + "log_url": "/usr/log/" + } + } + +#. The following shows how to create training job **TestModelArtsJob2** with a custom image. + +- Sample request + + .. code-block:: + + POST https://endpoint/v1/{project_id}/training-jobs + { + "job_name": "TestModelArtsJob2", + "job_desc": "This is a ModelArts job", + "workspace_id": "af261af2218841ec960b01ab3cf1a5fa", + "config": { + "worker_server_num": 1, + "data_url": "/usr/data/", + "app_url": "/usr/app/", + "parameter": [ + { + "label": "CUSTOM_PARAM1", + "value": "1" + } + ], + "spec_id": 1, + "user_command": "bash -x /home/work/run_train.sh python /home/work/user-job-dir/app/mnist/mnist_softmax.py --data_url /home/work/user-job-dir/app/mnist_data", + "user_image_url": "100.125.5.235:20202/jobmng/custom-cpu-base:1.0", + "train_url": "/usr/train/", + "log_url": "/usr/log/" + } + } + +3. The following shows how to create training job **TestModelArtsJob3** using a storage volume. + +- Sample request + + .. code-block:: + + POST https://endpoint/v1/{project_id}/training-jobs + { + "job_name": "TestModelArtsJob3", + "job_desc": "This is a ModelArts job", + "workspace_id": "af261af2218841ec960b01ab3cf1a5fa", + "config": { + "worker_server_num": 1, + "app_url": "/usr/app/", + "boot_file_url": "/usr/app/boot.py", + "parameter": [ + { + "label": "learning_rate", + "value": "0.01" + }, + { + "label": "batch_size", + "value": "32" + } + ], + "dataset_id": "38277e62-9e59-48f4-8d89-c8cf41622c24", + "dataset_version_id": "2ff0d6ba-c480-45ae-be41-09a8369bfc90", + "spec_id": 1, + "engine_id": 1, + "train_url": "/usr/train/", + "log_url": "/usr/log/", + "volumes": [ + { + "nfs": { + "id": "43b37236-9afa-4855-8174-32254b9562e7", + "src_path": "192.168.8.150:/", + "dest_path": "/home/work/nas", + "read_only": false + } + }, + { + "host_path": { + "src_path": "/root/work", + "dest_path": "/home/mind", + "read_only": false + } + } + ] + } + } + +- Successful sample response + + .. code-block:: + + { + "is_success": true, + "job_id": "10", + "job_name": "TestModelArtsJob", + "status": "1", + "create_time": "1524189990635", + "version_id": "10", + "version_name": "V0001", + "resource_id": "jobafd08896" + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Job name:TestModelArtsJob is existed", + "error_code": "ModelArts.0103" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/creating_a_version_of_a_training_job.rst b/api-ref/source/training_management/training_jobs/creating_a_version_of_a_training_job.rst new file mode 100644 index 0000000..2768aab --- /dev/null +++ b/api-ref/source/training_management/training_jobs/creating_a_version_of_a_training_job.rst @@ -0,0 +1,218 @@ +Creating a Version of a Training Job +==================================== + +Function +-------- + +This API is used to create a version of a training job. + +Calling this API is an asynchronous operation. The job status can be obtained by calling the APIs described in `Querying a Training Job List <../../training_management/training_jobs/querying_a_training_job_list.html#modelarts030046>`__ and `Querying the Details About a Training Job Version <../../training_management/training_jobs/querying_the_details_about_a_training_job_version.html#modelarts030047>`__. + +URI +--- + +POST /v1/{project_id}/training-jobs/{job_id}/versions + +`Table 1 <#modelarts030050enustopic0131276316table126693715562>`__ describes the required parameters. + +.. _modelarts030050enustopic0131276316table126693715562: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | Long | ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030050enustopic0131276316table6270801111211>`__ describes the request parameters. + +.. _modelarts030050enustopic0131276316table6270801111211: + +.. table:: **Table 2** Request parameters + + +-----------+-----------+--------+------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+========================================================================================================================+ + | job_desc | No | String | Description of a training job. The value is a string of 0 to 256 characters. By default, this parameter is left blank. | + +-----------+-----------+--------+------------------------------------------------------------------------------------------------------------------------+ + | config | Yes | JSON | Parameters for creating a training job | + +-----------+-----------+--------+------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030050enustopic0131276316table24411850104213: + +.. table:: **Table 3** **config** parameters + + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +====================+===========+===============+================================================================================================================================================================================================================================================================================================================================================================================================+ + | worker_server_num | Yes | Integer | Number of workers in a training job. Obtain the maximum value from `Querying Job Resource Specifications <../../training_management/resource_and_engine_specifications/querying_job_resource_specifications.html#modelarts030072>`__. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | app_url | Yes | String | Code directory of a training job, for example, **/usr/app/**. This parameter must be used together with **boot_file_url**. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | boot_file_url | Yes | String | Boot file of a training job, which needs to be stored in the code directory. Example value: **/usr/app/boot.py** This parameter must be used together with **app_url**. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parameter | No | Array | Running parameters of a training job. It is a collection of label-value pairs. For details, see the sample request. This parameter is a container environment variable when a training job uses a custom image. For details, see `Table 5 <#modelarts030050enustopic0131276316table1267642234716>`__. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | Yes | String | OBS URL of the dataset required by a training job. By default, this parameter is left blank. For example, **/usr/data/**. This parameter cannot be used together with **data_source** or **dataset_id** and **dataset_version_id**. However, one of the parameters must exist. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | Yes | String | Dataset ID of a training job. This parameter must be used together with **dataset_version_id**, but cannot be used together with **data_url** or **data_source**. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_id | Yes | String | Dataset version ID of a training job. This parameter must be used together with **dataset_id**, but cannot be used together with **data_url** or **data_source**. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | No | JSON Array | Dataset of a training job. This parameter cannot be used with **data_url**, **dataset_id**, or **dataset_version_id**. For details, see `Table 4 <#modelarts030050enustopic0131276316table8406183645819>`__. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec_id | Yes | Long | ID of the resource specifications selected for a training job. Obtain the ID by calling the API described in `Querying Job Resource Specifications <../../training_management/resource_and_engine_specifications/querying_job_resource_specifications.html#modelarts030072>`__. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_id | Yes | Long | ID of the engine selected for a training job. The default value is **1**. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. Obtain the ID by calling the API described in `Querying Job Engine Specifications <../../training_management/resource_and_engine_specifications/querying_job_engine_specifications.html#modelarts030073>`__. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | Yes | Long | ID of the built-in model of a training job. After setting **model_id**, you do not need to set **app_url** or **boot_file_url**, and **engine_id**. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | Yes | String | OBS URL of the output file of a training job. By default, this parameter is left blank. Example value: **/bucket/trainUrl/** | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_url | No | String | OBS URL of the logs of a training job. By default, this parameter is left blank. Example value: **/usr/train/** | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pre_version_id | Yes | Long | ID of the previous version of a training job. You can obtain the value of **version_id** by calling the API described in `Querying a List of Training Job Versions <../../training_management/training_jobs/querying_a_list_of_training_job_versions.html#modelarts030049>`__. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_image_url | No | String | SWR URL of a custom image used by a training job. Example value: **100.125.5.235:20202/jobmng/custom-cpu-base:1.0** | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_command | No | String | Boot command used to start the container of a custom image of a training job. The format is **bash /home/work/run_train.sh python /home/work/user-job-dir/app/train.py {python_file_parameter}**. | + +--------------------+-----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030050enustopic0131276316table8406183645819: + +.. table:: **Table 4** **data_source** parameters + + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+===========+========+================================================================================================================================================+ + | dataset_id | Yes | String | Dataset ID of a training job. This parameter must be used together with **dataset_version_id**, but cannot be used together with **data_url**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version | Yes | String | Dataset version ID of a training job. This parameter must be used together with **dataset_id**, but cannot be used together with **data_url**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | type | Yes | String | Dataset type. The value can be **obs** or **dataset**. **obs** and **dataset** cannot be used at the same time. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | Yes | String | OBS bucket path. This parameter cannot be used together with **dataset_id** or **dataset_version**. | + +-----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030050enustopic0131276316table1267642234716: + +.. table:: **Table 5** **parameter** parameters + + ========= ========= ====== =============== + Parameter Mandatory Type Description + ========= ========= ====== =============== + label No String Parameter name + value No String Parameter value + ========= ========= ====== =============== + +Response Body +------------- + +`Table 6 <#modelarts030050enustopic0131276316table1221422915578>`__ describes the response parameters. + +.. _modelarts030050enustopic0131276316table1221422915578: + +.. table:: **Table 6** Parameters + + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Long | ID of a training job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_name | String | Name of a training job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Int | Status of a training job. For details about the job statuses, see `Job Statuses <../../training_management/job_statuses.html#modelarts030074>`__. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Timestamp when a training job is created | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Long | Version ID of a training job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Version name of a training job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +#. The following shows how to create a job whose **job_id** is **10** and **pre_version_id** is **20**. + + - Sample request + + .. code-block:: + + POST https://endpoint/v1/{project_id}/training-jobs/10/versions/ + { + "job_desc": "This is a ModelArts job", + "config": { + "worker_server_num": 1, + "app_url": "/usr/app/", + "boot_file_url": "/usr/app/boot.py", + "parameter": [ + { + "label": "learning_rate", + "value": "0.01" + }, + { + "label": "batch_size", + "value": "32" + } + ], + "dataset_id": "38277e62-9e59-48f4-8d89-c8cf41622c24", + "dataset_version_id": "2ff0d6ba-c480-45ae-be41-09a8369bfc90", + "spec_id": 1, + "engine_id": 1, + "train_url": "/usr/train/", + "log_url": "/usr/log/", + "pre_version_id": 20 + } + } + +- Successful sample response + + .. code-block:: + + { + "is_success": true, + "job_id": 10, + "job_name": "TestModelArtsJob", + "status": 1, + "create_time": 1524189990635, + "version_id": 10, + "version_name":""V0001" + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/deleting_a_training_job.rst b/api-ref/source/training_management/training_jobs/deleting_a_training_job.rst new file mode 100644 index 0000000..70fba05 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/deleting_a_training_job.rst @@ -0,0 +1,92 @@ +Deleting a Training Job +======================= + +Function +-------- + +This API is used to delete a training job. + +Calling this API is an asynchronous operation. The job status can be obtained by calling the APIs described in `Querying a Training Job List <../../training_management/training_jobs/querying_a_training_job_list.html#modelarts030046>`__ and `Querying the Details About a Training Job Version <../../training_management/training_jobs/querying_the_details_about_a_training_job_version.html#modelarts030047>`__. + +URI +--- + +DELETE /v1/{project_id}/training-jobs/{job_id} + +`Table 1 <#modelarts030053enustopic0131151012table126693715562>`__ describes the required parameters. + +.. _modelarts030053enustopic0131151012table126693715562: + +.. table:: **Table 1** Parameter description + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | Long | ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030053enustopic0131151012table1221422915578>`__ describes the response parameters. + +.. _modelarts030053enustopic0131151012table1221422915578: + +.. table:: **Table 2** Parameter description + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to delete the job whose **job_id** is **10**. + +- Sample request + + .. code-block:: + + DELETE https://endpoint/v1/{project_id}/training-jobs/10 + +- Successful sample response + + .. code-block:: + + { + "is_success": true + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/deleting_a_version_of_a_training_job.rst b/api-ref/source/training_management/training_jobs/deleting_a_version_of_a_training_job.rst new file mode 100644 index 0000000..ce666ed --- /dev/null +++ b/api-ref/source/training_management/training_jobs/deleting_a_version_of_a_training_job.rst @@ -0,0 +1,90 @@ +Deleting a Version of a Training Job +==================================== + +Function +-------- + +This API is used to delete a version of a training job. + +Calling this API is an asynchronous operation. The job status can be obtained by calling the APIs described in `Querying a Training Job List <../../training_management/training_jobs/querying_a_training_job_list.html#modelarts030046>`__ and `Querying the Details About a Training Job Version <../../training_management/training_jobs/querying_the_details_about_a_training_job_version.html#modelarts030047>`__. + +URI +--- + +DELETE /v1/{project_id}/training-jobs/{job_id}/versions/{version_id} + +`Table 1 <#modelarts030048enustopic0131151009table126693715562>`__ describes the required parameters. + +.. _modelarts030048enustopic0131151009table126693715562: + +.. table:: **Table 1** Parameter description + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | Long | ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | Long | Version ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030048enustopic0131151009table1221422915578>`__ describes the response parameters. + +.. _modelarts030048enustopic0131151009table1221422915578: + +.. table:: **Table 2** Parameter description + + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +- Sample request + + .. code-block:: + + DELETE https://endpoint/v1/{project_id}/training-jobs/10/versions/10 + +- Successful sample response + + .. code-block:: + + { + "is_success": true + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/index.rst b/api-ref/source/training_management/training_jobs/index.rst new file mode 100644 index 0000000..e3a0a6d --- /dev/null +++ b/api-ref/source/training_management/training_jobs/index.rst @@ -0,0 +1,22 @@ +============= +Training Jobs +============= + +.. toctree:: + :maxdepth: 1 + + creating_a_training_job + querying_a_training_job_list + querying_the_details_about_a_training_job_version + deleting_a_version_of_a_training_job + querying_a_list_of_training_job_versions + creating_a_version_of_a_training_job + stopping_a_training_job + modifying_the_description_of_a_training_job + deleting_a_training_job + obtaining_the_name_of_a_training_job_log_file + querying_a_built-in_algorithm + querying_training_job_logs + querying_monitoring_information_about_a_single_container_of_a_job + querying_monitoring_information_about_resource_pool_nodes + querying_the_statuses_and_gpu_quantity_of_all_job_versions diff --git a/api-ref/source/training_management/training_jobs/modifying_the_description_of_a_training_job.rst b/api-ref/source/training_management/training_jobs/modifying_the_description_of_a_training_job.rst new file mode 100644 index 0000000..677d4b1 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/modifying_the_description_of_a_training_job.rst @@ -0,0 +1,101 @@ +Modifying the Description of a Training Job +=========================================== + +Function +-------- + +This API is used to modify the description of a training job. + +URI +--- + +PUT /v1/{project_id}/training-jobs/{job_id} + +`Table 1 <#modelarts030052enustopic0131151011table27718806153710>`__ describes the required parameters. + +.. _modelarts030052enustopic0131151011table27718806153710: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | Long | ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030052enustopic0131151011table54779414153816>`__ describes the request parameters. + +.. _modelarts030052enustopic0131151011table54779414153816: + +.. table:: **Table 2** Parameters + + +-----------+-----------+--------+------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+==============================================================================+ + | job_desc | Yes | String | Description of a training job. The value is a string of 0 to 256 characters. | + +-----------+-----------+--------+------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030052enustopic0131151011table10292351155335>`__ describes the response parameters. + +.. _modelarts030052enustopic0131151011table10292351155335: + +.. table:: **Table 3** Parameters + + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================================================+ + | is_success | Boolean | Whether the request is successful. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to modify the description of the job whose **job_id** is **10**. + +- Sample request + + .. code-block:: + + PUT https://endpoint/v1/{project_id}/training-jobs/10 + { + "job_desc": "This is a ModelArts job" + } + +- Successful sample response + + .. code-block:: + + { + "is_success": true + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/obtaining_the_name_of_a_training_job_log_file.rst b/api-ref/source/training_management/training_jobs/obtaining_the_name_of_a_training_job_log_file.rst new file mode 100644 index 0000000..86577e1 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/obtaining_the_name_of_a_training_job_log_file.rst @@ -0,0 +1,95 @@ +Obtaining the Name of a Training Job Log File +============================================= + +Function +-------- + +This API is used to obtain the name of a training job log file. + +URI +--- + +GET /v1/{project_id}/training-jobs/{job_id}/versions/{version_id}/log/file-names + +`Table 1 <#modelarts030054enustopic0131304290table4669394316232>`__ describes the required parameters. + +.. _modelarts030054enustopic0131304290table4669394316232: + +.. table:: **Table 1** Parameter description + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | Long | ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | Long | Version ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030054enustopic0131304290table3969737616316>`__ describes the response parameters. + +.. _modelarts030054enustopic0131304290table3969737616316: + +.. table:: **Table 2** Parameter description + + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_file_list | String | Log file name of a training job. A single-node job has only one log file, and a distributed job has multiple log files. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to obtain the log files of the job whose **job_id** is **10** and **version_id** is **10**. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/training-jobs/10/versions/10/log/file-names + +- Successful sample response + + .. code-block:: + + { + "is_success": true, + "log_file_list": [ + "teseJob.0" + ] + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/querying_a_built-in_algorithm.rst b/api-ref/source/training_management/training_jobs/querying_a_built-in_algorithm.rst new file mode 100644 index 0000000..f8c7038 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/querying_a_built-in_algorithm.rst @@ -0,0 +1,202 @@ +Querying a Built-in Algorithm +============================= + +Function +-------- + +This API is used to query the details about a built-in model. + +URI +--- + +GET /v1/{project_id}/built-in-algorithms + +`Table 1 <#modelarts030056enustopic0131380352table37435132101942>`__ describes the required parameters. + +.. _modelarts030056enustopic0131380352table37435132101942: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030056enustopic0131380352table16279151181311>`__ describes the request parameters. + + + +.. _modelarts030056enustopic0131380352table16279151181311: + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=================================================================================================================================================================================================================+ + | per_page | No | Integer | Number of job parameters displayed on each page. The value range is [1, 100]. Default value: **10** | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | page | No | Integer | Index of the page to be queried. Default value: **1** | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sortBy | No | String | Sorting mode of the query. The value can be **engine**, **model_name**, **model_precision**, **model_usage**, **model_precision**, **model_size**, **create_time**, or **parameter**. Default value: **engine** | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting order. The options are as follows: | + | | | | | + | | | | - **asc**: ascending order | + | | | | - **desc**: descending order. The default value is **desc**. | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_content | No | String | Search content, for example, a parameter name. By default, this parameter is left blank. | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030056enustopic0131380352table10251721151647>`__ describes the response parameters. + +.. _modelarts030056enustopic0131380352table10251721151647: + +.. table:: **Table 3** Parameters + + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==========================================================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_total_count | Integer | Number of models | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | models | Array | Model parameter list. For details, see `Table 4 <#modelarts030056enustopic0131380352table29182771151827>`__. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030056enustopic0131380352table29182771151827: + +.. table:: **Table 4** **models** structure data + + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=================================================================================================================================================================+ + | model_id | Integer | Model ID | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_name | String | Model name | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_usage | Integer | Model usage. The options are as follows: | + | | | | + | | | - 1: image classification | + | | | - 2: object class and location | + | | | - 3: image semantic segmentation | + | | | - 4: natural language processing | + | | | - 5: image embedding | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_precision | String | Model precision | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_size | Long | Model size, in bytes | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_train_dataset | String | Model training dataset | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_dataset_format | String | Dataset format required by a model | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_description_url | String | URL of the model description | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parameter | String | Running parameters of a model. This parameter is a container environment variable when a training job uses a custom image. For details, see the sample request. | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a model is created | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_id | Long | Engine ID of a model | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_name | String | Engine name of a model | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_version | String | Engine version of a model | + +-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030056enustopic0131380352table15296852152820: + +.. table:: **Table 5** **parameter** parameters + + ========= ======= ================================ + Parameter Type Description + ========= ======= ================================ + label String Parameter name + value String Parameter value + required Boolean Whether a parameter is mandatory + ========= ======= ================================ + +Samples +------- + +The following shows how to query the algorithm whose name contains **configname**. + +- Sample request + + .. code-block:: + + GET https://endpoint//v1/{project_id}/built-in-algorithms?per_page=10&page=1&sortBy=engine&order=asc&search_content=model + +- Successful sample response + + .. code-block:: + + { + "models": [ + { + "model_id": 4, + "model_name": "ResNet_v2_50", + "model_usage": 1, + "model_precision": "75.55%(top1), 92.6%(top5)", + "model_size": 102503801, + "model_train_dataset": "ImageNet, 1,000 classes for image classification", + "model_dataset_format": "shape: [H>=32, W>=32, C>=1]; type: int8", + "model_description_url": "https://github.com/apache/incubator-mxnet/blob/master/example/image-classification/symbols/resnet.py", + "parameter": "[{\"label\":\"batch_size\",\"value\":\"4\",\"placeholder_cn\":\"Total number of training images updated each time\",\"placeholder_en\":\"\",\"required\":true},{\"label\":\"lr\",\"value\":\"0.0001\",\"placeholder_cn\":\"Learning rate\",\"placeholder_en\":\"\",\"required\":true},{\"label\":\"save_frequency\",\"value\":\"1\",\"placeholder_cn\":\"Interval for saving the model, indicating that the model is saved every N epochs\",\"placeholder_en\":\"\",\"required\":true},{\"label\":\"num_classes\",\"value\":\"\",\"placeholder_cn\":\"Total number of image classes in training\",\"placeholder_en\":\"\",\"required\":true},{\"label\":\"num_epoch\",\"value\":\"10\",\"placeholder_cn\":\"Number of training epochs\",\"placeholder_en\":\"\",\"required\":true}]", + "create_time": 1522218780025, + "engine_id": 501, + "engine_name": "MXNet", + "engine_version": "MXNet-1.2.1-python2.7" + }, + { + "model_id": 5, + "model_name": "Faster_RCNN_ResNet_v2_101", + "model_usage": 2, + "model_precision": "80.05%(mAP)", + "model_size": 190936449, + "model_train_dataset": "PASCAL VOC2007, 20 classes for object detection", + "model_dataset_format": "shape: [H, W, C==3]; type: int8", + "model_description_url": "https://github.com/apache/incubator-mxnet/tree/master/example/rcnn", + "parameter": "[{\"label\":\"lr\",\"value\":\"0.0001\",\"placeholder_cn\":\"Learning rate\",\"placeholder_en\":\"\",\"required\":true},{\"label\":\"eval_frequence\",\"value\":\"1\",\"placeholder_cn\":\"Frequency for validating the model. By default, validation is performed every epoch.\",\"placeholder_en\":\"\",\"required\":true},{\"label\":\"mom\",\"value\":\"0.9\",\"placeholder_cn\":\"Momentum of the training network\",\"placeholder_en\":\"\",\"required\":true},{\"label\":\"wd\",\"value\":\"0.0005\",\"placeholder_cn\":\"Weight decay coefficient\",\"placeholder_en\":\"\",\"required\":true},{\"label\":\"num_classes\",\"value\":\"\",\"placeholder_cn\":\"Total number of image classes in training. The value must plus 1 because there is a background class.\",\"placeholder_en\":\"\",\"required\":true}]", + "create_time": 1525313224596, + "engine_id": 501, + "engine_name": "MXNet", + "engine_version": "MXNet-1.2.1-python2.7" + } + ], + "model_total_count": 41, + "is_success": true + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/querying_a_list_of_training_job_versions.rst b/api-ref/source/training_management/training_jobs/querying_a_list_of_training_job_versions.rst new file mode 100644 index 0000000..697b198 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/querying_a_list_of_training_job_versions.rst @@ -0,0 +1,462 @@ +Querying a List of Training Job Versions +======================================== + +Function +-------- + +This API is used to query the version of a specified training job based on the job ID. + +URI +--- + +GET /v1/{project_id}/training-jobs/{job_id}/versions + +`Table 1 <#modelarts030049enustopic0131276315table126693715562>`__ describes the required parameters. + +.. _modelarts030049enustopic0131276315table126693715562: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | Long | ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030049enustopic0131276315table19858192884410>`__ describes the request parameters. + + + +.. _modelarts030049enustopic0131276315table19858192884410: + +.. table:: **Table 2** Parameters + + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+======================================================================================================+ + | per_page | No | Integer | Number of job parameters displayed on each page. The value range is [1, 1000]. Default value: **10** | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------+ + | page | No | Integer | Index of the page to be queried | + | | | | | + | | | | - If paging is required, set **page** to **1**. | + | | | | - The default value of **page** is **0**, indicating that paging is not supported. | + +-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030049enustopic0131276315table2700823414458>`__ describes the response parameters. + +.. _modelarts030049enustopic0131276315table2700823414458: + +.. table:: **Table 3** Parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | job_id | Long | ID of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | job_name | String | Name of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | job_desc | String | Description of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | version_count | Long | Number of versions of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | versions | JSON Array | Version parameters of a training job. For details, see the sample response. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030049enustopic0131276315table254511106543: + +.. table:: **Table 4** **versions** parameters + + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +======================+============+==========================================================================================================================================================================================================================+ + | version_id | Long | Version ID of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Version name of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pre_version_id | Long | ID of the previous version of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_type | Long | Engine type of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_name | String | Name of the engine selected for a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_id | Long | ID of the engine selected for a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_version | String | Version of the engine selected for a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Int | Status of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | app_url | String | Code directory of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | boot_file_url | String | Boot file of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a training job is created | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parameter | JSON Array | Running parameters of a training job. This parameter is a container environment variable when a training job uses a custom image. For details, see `Table 5 <#modelarts030049enustopic0131276315table15296852152820>`__. | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | Long | Training job running duration, in milliseconds | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec_id | Long | ID of the resource specifications selected for a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | core | String | Number of cores of the resource specifications | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | cpu | String | CPU memory of the resource specifications | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | gpu_num | Integer | Number of GPUs of the resource specifications | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | gpu_type | String | GPU type of the resource specifications | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_server_num | Integer | Number of workers in a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | String | Dataset of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | String | OBS path of the training job output file | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_url | String | OBS URL of the logs of a training job. By default, this parameter is left blank. Example value: **/usr/log/** | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_id | String | Dataset version ID of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | String | Dataset ID of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | JSON Array | Datasets of a training job. For details, see `Table 6 <#modelarts030049enustopic0131276315table250595919011>`__. | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | Long | Model ID of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_metric_list | String | Model metrics of a training job. For details, see `Table 7 <#modelarts030049enustopic0131276315table929111514598>`__. | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | system_metric_list | String | System monitoring metrics of a training job. For details, see `Table 8 <#modelarts030049enustopic0131276315table199981042536>`__. | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_image_url | String | SWR URL of a custom image used by a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_command | String | Boot command used to start the container of a custom image of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource_id | String | Charged resource ID of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_name | String | Dataset of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | start_time | Long | Training start time | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | volumes | JSON Array | Storage volume that can be used by a training job. For details, see `Table 13 <#modelarts030049enustopic0131276315table6403153714711>`__. | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_name | String | Dataset of a training job | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_name | String | Name of a resource pool | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_id | String | ID of a resource pool | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | nas_mount_path | String | Local mount path of SFS Turbo (NAS). Example value: **/home/work/nas** | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | nas_share_addr | String | Shared path of SFS Turbo (NAS). Example value: **192.168.8.150:/** | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | nas_type | String | Only NFS is supported. Example value: **nfs** | + +----------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030049enustopic0131276315table15296852152820: + +.. table:: **Table 5** **parameter** parameters + + ========= ====== =============== + Parameter Type Description + ========= ====== =============== + label String Parameter name + value String Parameter value + ========= ====== =============== + + + +.. _modelarts030049enustopic0131276315table250595919011: + +.. table:: **Table 6** **data_source** parameters + + +-----------------------+-----------------------+--------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================+ + | dataset_id | String | Dataset ID of a training job | + +-----------------------+-----------------------+--------------------------------------------------------+ + | dataset_version | String | Dataset version ID of a training job | + +-----------------------+-----------------------+--------------------------------------------------------+ + | type | String | Dataset type | + | | | | + | | | - **obs**: Data from OBS is used. | + | | | - **dataset**: Data from a specified dataset is used. | + +-----------------------+-----------------------+--------------------------------------------------------+ + | data_url | String | OBS bucket path | + +-----------------------+-----------------------+--------------------------------------------------------+ + + + +.. _modelarts030049enustopic0131276315table929111514598: + +.. table:: **Table 7** **model_metric_list** parameters + + +--------------+------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============+============+========================================================================================================================================+ + | metric | JSON Array | Validation metrics of a classification of a training job | + +--------------+------------+----------------------------------------------------------------------------------------------------------------------------------------+ + | total_metric | JSON | Overall validation parameters of a training job. For details, see `Table 11 <#modelarts030049enustopic0131276315table102963631010>`__. | + +--------------+------------+----------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030049enustopic0131276315table199981042536: + +.. table:: **Table 8** **system_metric_list** parameters + + ========= ===== ============================== + Parameter Type Description + ========= ===== ============================== + cpuUsage Array CPU usage of a training job + memUsage Array Memory usage of a training job + gpuUtil Array GPU usage of a training job + ========= ===== ============================== + + + +.. _modelarts030049enustopic0131276315table226072412518: + +.. table:: **Table 9** **metric** parameters + + +---------------+------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===============+======+=================================================================================================================================================+ + | metric_values | JSON | Validation metrics of a classification of a training job. For details, see `Table 10 <#modelarts030049enustopic0131276315table162521255132>`__. | + +---------------+------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | reserved_data | JSON | Reserved parameter | + +---------------+------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | metric_meta | JSON | Classification of a training job, including the classification ID and name | + +---------------+------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030049enustopic0131276315table162521255132: + +.. table:: **Table 10** **metric_values** parameters + + ========= ===== =============================================== + Parameter Type Description + ========= ===== =============================================== + recall Float Recall of a classification of a training job + precision Float Precision of a classification of a training job + accuracy Float Accuracy of a classification of a training job + ========= ===== =============================================== + + + +.. _modelarts030049enustopic0131276315table102963631010: + +.. table:: **Table 11** **total_metric** parameters + + +---------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=====================+============+=======================================================================================================================================+ + | total_metric_meta | JSON Array | Reserved parameter | + +---------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | total_reserved_data | JSON Array | Reserved parameter | + +---------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | total_metric_values | JSON Array | Overall validation metrics of a training job. For details, see `Table 12 <#modelarts030049enustopic0131276315table45171749171414>`__. | + +---------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030049enustopic0131276315table45171749171414: + +.. table:: **Table 12** **total_metric_values** parameters + + +-----------+-------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+=======+=============================================================================================================================================+ + | f1_score | Float | F1 score of a training job. This parameter is used only by some preset algorithms and is automatically generated. It is for reference only. | + +-----------+-------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | recall | Float | Total recall of a training job | + +-----------+-------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | precision | Float | Total precision of a training job | + +-----------+-------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | accuracy | Float | Total accuracy of a training job | + +-----------+-------+---------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030049enustopic0131276315table6403153714711: + +.. table:: **Table 13** **volumes** parameters + + +-----------+------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+======+=======================================================================================================================================================================================================================================================================+ + | nfs | JSON | Storage volume of the shared file system type. Only the training jobs running in the resource pool with the shared file system network connected support such storage volume. For details, see `Table 14 <#modelarts030049enustopic0131276315table19871043113315>`__. | + +-----------+------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | host_path | JSON | Storage volume of the host file system type. Only training jobs running in the dedicated resource pool support such storage volume. For details, see `Table 15 <#modelarts030049enustopic0131276315table4873028185611>`__. | + +-----------+------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030049enustopic0131276315table19871043113315: + +.. table:: **Table 14** **nfs** parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=====================================================================+ + | id | String | ID of an SFS Turbo file system | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | src_path | String | Address of an SFS Turbo file system | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | dest_path | String | Local path of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | read_only | Boolean | Whether **dest_path** is read-only. The default value is **false**. | + | | | | + | | | - **true**: read-only permission | + | | | - **false**: read/write permission. This is the default value. | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + + + +.. _modelarts030049enustopic0131276315table4873028185611: + +.. table:: **Table 15** **host_path** parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=====================================================================+ + | src_path | String | Local path of a host | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | dest_path | String | Local path of a training job | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + | read_only | Boolean | Whether **dest_path** is read-only. The default value is **false**. | + | | | | + | | | - **true**: read-only permission | + | | | - **false**: read/write permission. This is the default value. | + +-----------------------+-----------------------+---------------------------------------------------------------------+ + +Samples +------- + +The following shows how to query the job version details on the first page when **job_id** is set to **10** and five records are displayed on each page. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/training-jobs/10/versions?per_page=5&page=1 + +- Successful sample response + + .. code-block:: + + { + "is_success": true, + "job_id": 10, + "job_name": "testModelArtsJob", + "job_desc": "testModelArtsJob desc", + "version_count": 2, + "versions": [ + { + "version_id": 10, + "version_name": "V0004", + "pre_version_id": 5, + "engine_type": 1, + "engine_name": "TensorFlow", + "engine_id": 1, + "engine_version": "TF-1.4.0-python2.7", + "status": 10, + "app_url": "/usr/app/", + "boot_file_url": "/usr/app/boot.py", + "create_time": 1524189990635, + "parameter": [ + { + "label": "learning_rate", + "value": 0.01 + } + ], + "duration": 532003, + "spec_id": 1, + "core": 2, + "cpu": 8, + "gpu_num": 2, + "gpu_type": "P100", + "worker_server_num": 1, + "data_url": "/usr/data/", + "train_url": "/usr/train/", + "log_url": "/usr/log/", + "dataset_version_id": "2ff0d6ba-c480-45ae-be41-09a8369bfc90", + "dataset_id": "38277e62-9e59-48f4-8d89-c8cf41622c24", + "data_source": [ + { + "type": "obs", + "data_url": "/qianjiajun-test/minst/data/" + } + ], + "user_image_url": "100.125.5.235:20202/jobmng/custom-cpu-base:1.0", + "user_command": "bash -x /home/work/run_train.sh python /home/work/user-job-dir/app/mnist/mnist_softmax.py --data_url /home/work/user-job-dir/app/mnist_data", + "model_id": 1, + "model_metric_list": "{\"metric\":[{\"metric_values\":{\"recall\":0.005833,\"precision\":0.000178,\"accuracy\":0.000937},\"reserved_data\":{},\"metric_meta\":{\"class_name\":0,\"class_id\":0}}],\"total_metric\":{\"total_metric_meta\":{},\"total_reserved_data\":{},\"total_metric_values\":{\"recall\":0.005833,\"id\":0,\"precision\":0.000178,\"accuracy\":0.000937}}}", + "system_metric_list": "{\"cpuUsage\":[\"0\",\"3.10\",\"5.76\",\"0\",\"0\",\"0\",\"0\"],\"memUsage\":[\"0\",\"0.77\",\"2.09\",\"0\",\"0\",\"0\",\"0\"],\"gpuUtil\":[\"0\",\"0.25\",\"0.88\",\"0\",\"0\",\"0\",\"0\"],\"gpuMemUsage\":[\"0\",\"0.65\",\"6.01\",\"0\",\"0\",\"0\",\"0\"],\"diskReadRate\":[\"0\",\"91811.07\",\"38846.63\",\"0\",\"0\",\"0\",\"0\"],\"diskWriteRate\":[\"0\",\"2.23\",\"0.94\",\"0\",\"0\",\"0\",\"0\"],\"recvBytesRate\":[\"0\",\"5770405.50\",\"2980077.75\",\"0\",\"0\",\"0\",\"0\"],\"sendBytesRate\":[\"0\",\"12607.17\",\"10487410.00\",\"0\",\"0\",\"0\",\"0\"],\"interval\":1}", + "dataset_name": "dataset-test", + "dataset_version_name": "dataset-version-test", + + "start_time": 1563172362000, + "volumes": [ + { + "nfs": { + "id": "43b37236-9afa-4855-8174-32254b9562e7", + "src_path": "192.168.8.150:/", + "dest_path": "/home/work/nas", + "read_only": false + } + }, + { + "host_path": { + "src_path": "/root/work", + "dest_path": "/home/mind", + "read_only": false + } + } + ], + "pool_id": "pool9928813f", + "pool_name": "p100", + "nas_mount_path": "/home/work/nas", + "nas_share_addr": "192.168.8.150:/", + "nas_type": "nfs" + } + ] + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/querying_a_training_job_list.rst b/api-ref/source/training_management/training_jobs/querying_a_training_job_list.rst new file mode 100644 index 0000000..f6a4362 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/querying_a_training_job_list.rst @@ -0,0 +1,165 @@ +Querying a Training Job List +============================ + +Function +-------- + +This API is used to query the created training jobs that meet the search criteria. + +URI +--- + +GET /v1/{project_id}/training-jobs + +`Table 1 <#modelarts030046enustopic0131145861table16518993181628>`__ describes the required parameters. + +.. _modelarts030046enustopic0131145861table16518993181628: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030046enustopic0131145861table125324323545>`__ describes the request parameters. + + + +.. _modelarts030046enustopic0131145861table125324323545: + +.. table:: **Table 2** Parameters + + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==================================================================================================================================================================================================================================================================================+ + | status | No | String | Job status. By default, all job statuses are returned. For example, to query failed jobs, set the value of **status** to **3**, **5**, **6**, or **13**. For details about the job statuses, see `Job Statuses <../../training_management/job_statuses.html#modelarts030074>`__. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | per_page | No | Integer | Number of jobs displayed on each page. The value range is [1, 1000]. Default value: **10** | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | page | No | Integer | Index of the page to be queried. Default value: **1** The value range is [1, 65535]. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sortBy | No | String | Sorting mode of the query. The value can be **job_name**, **job_desc**, **status**, **duration**, **version_count**, or **create_time**. Default value: **job_name** | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting order. The options are as follows: | + | | | | | + | | | | - **asc**: ascending order. It is the default value. | + | | | | - **desc**: descending order | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_content | No | String | Search content, for example, a training job name. The value is a string of 0 to 64 characters. By default, this parameter is left blank. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | Workspace where a job resides. Default value: **0** | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030046enustopic0131145861table31621671103510>`__ describes the response parameters. + +.. _modelarts030046enustopic0131145861table31621671103510: + +.. table:: **Table 3** Parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=====================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | job_total_count | Integer | Total number of created jobs | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | job_count_limit | Integer | Number of training jobs that can be created | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | jobs | **jobs** array | Attributes of a training job. For details, see `Table 4 <#modelarts030046enustopic0131145861table3971109103614>`__. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | quotas | Integer | Maximum number of training jobs | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030046enustopic0131145861table3971109103614: + +.. table:: **Table 4** **jobs** parameters + + +---------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===============+========+===================================================================================================================================================+ + | job_id | Long | ID of a training job | + +---------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_name | String | Name of a training job | + +---------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Long | Version ID of a training job | + +---------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Int | Status of a training job. For details about the job statuses, see `Job Statuses <../../training_management/job_statuses.html#modelarts030074>`__. | + +---------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Timestamp when a training job is created | + +---------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | Long | Training job running duration, in milliseconds | + +---------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_desc | String | Description of a training job | + +---------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_count | Long | Number of versions of a training job | + +---------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to query training jobs whose status is **7** and whose name contains **job** on the first page. Each page displays 10 records sorted by **job_name** in ascending order. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/training-jobs?status=7&per_page=10&page=1&sortBy=job_name&order=asc&search_content=job + +- Successful sample response + + .. code-block:: + + { + "is_success": true, + "quotas": 5, + "job_total_count": 1, + "job_count_limit": 3, + "jobs": [ + { + "job_id": 10, + "job_name": "testModelArtsJob", + "version_id": 10, + "status": 10, + "create_time": 1524189990635, + "duration": 532003, + "job_desc": "This is ModelArts job", + "version_count": 5 + } + ] + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/querying_monitoring_information_about_a_single_container_of_a_job.rst b/api-ref/source/training_management/training_jobs/querying_monitoring_information_about_a_single_container_of_a_job.rst new file mode 100644 index 0000000..ff109c0 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/querying_monitoring_information_about_a_single_container_of_a_job.rst @@ -0,0 +1,142 @@ +Querying Monitoring Information About a Single Container of a Job +================================================================= + +Function +-------- + +This API is used to query monitoring information about a single container of a job. + +URI +--- + +GET /v1/{project_id}/training-jobs/{job_id}/versions/{version_id}/pod/{pod_name}/metric-statistic + +`Table 1 <#modelarts030150enustopic0188079018table4442765616454>`__ describes the required parameters. + +.. _modelarts030150enustopic0188079018table4442765616454: + +.. table:: **Table 1** Parameter description + + +------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=======================================================================================================================================================================================================================================================================+ + | project_id | Yes | String | Project ID | + +------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | Long | ID of a training job | + +------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | Long | Version ID of a training job | + +------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pod_name | Yes | String | Container name, which is the same as the job log name. For details about how to obtain the value, see `Obtaining the Name of a Training Job Log File <../../training_management/training_jobs/obtaining_the_name_of_a_training_job_log_file.html#modelarts030054>`__. | + +------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030150enustopic0188079018table87520312215>`__ describes the request parameters. + +.. _modelarts030150enustopic0188079018table87520312215: + +.. table:: **Table 2** Parameter description + + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+========================================================================================================================================================+ + | metrics | No | String | Metrics to be queried. Separate metrics by commas (,), for example, **CpuUsage,MemUsage**. If this parameter is left blank, all metrics are queried. | + | | | | | + | | | | Options: | + | | | | | + | | | | - CpuUsage | + | | | | - MemUsage | + | | | | - DiskReadRate | + | | | | - DiskWriteRate | + | | | | - RecvBytesRate | + | | | | - SendBytesRate | + | | | | - GpuUtil | + | | | | - GpuMemUsage | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | statistic_type | No | String | Metric statistics method, indicating whether to collect metric statistics based on a single GPU. This parameter applies only to GPU metric statistics. | + | | | | | + | | | | - **all**: Obtain the average value of the metric. | + | | | | - **each**: Obtain the metric monitoring information about each GPU. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030150enustopic0188079018table1414514116749>`__ describes the response parameters. + +.. _modelarts030150enustopic0188079018table1414514116749: + +.. table:: **Table 3** Parameter description + + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+==================================================================================================================+ + | error_message | String | Error message when the API call fails. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code when the API call fails. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------+ + | metrics | JSON Array | Metric monitoring details. For details, see `Table 4 <#modelarts030150enustopic0188079018table8361164171810>`__. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------+ + | interval | Integer | Query interval, in minutes. | + +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030150enustopic0188079018table8361164171810: + +.. table:: **Table 4** **metrics** data structure + + +-----------+------------+---------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+============+===========================================================================+ + | metric | String | Monitoring metrics | + +-----------+------------+---------------------------------------------------------------------------+ + | value | JSON Array | Sequence of the obtained metric value. The element is of the String type. | + +-----------+------------+---------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to query the logs contained in **log1.log** of the job whose **job_id** is **10** and **version_id** is **10**. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/training-jobs/10/versions/10/pod/pod1/metric-statistic?metrics=gpuUtil + +- Successful sample response + + .. code-block:: + + { + "metrics": + [ + { + "metric":"gpuUtil", + "value":["1","22","33"] + } + ], + "interval" : 1 + } + +- Failed sample response + + .. code-block:: + + { + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/querying_monitoring_information_about_resource_pool_nodes.rst b/api-ref/source/training_management/training_jobs/querying_monitoring_information_about_resource_pool_nodes.rst new file mode 100644 index 0000000..e65fb62 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/querying_monitoring_information_about_resource_pool_nodes.rst @@ -0,0 +1,140 @@ +Querying Monitoring Information About Resource Pool Nodes +========================================================= + +Function +-------- + +This API is used to query monitoring information about resource pool nodes. + +URI +--- + +GET /v1/{project_id}/pools/{pool_id}/nodes/{node_ip}/metric-statistic + +`Table 1 <#modelarts030151enustopic0188079989table4442765616454>`__ describes the required parameters. + +.. _modelarts030151enustopic0188079989table4442765616454: + +.. table:: **Table 1** Parameter description + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=======================================================================================================+ + | project_id | Yes | String | Project ID | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------+ + | pool_id | Yes | String | ID of a dedicated resource pool | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------+ + | node_ip | Yes | String | IP address of a resource pool node, which is obtained from the response of the pool details query API | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030151enustopic0188079989table87520312215>`__ describes the request parameters. + +.. _modelarts030151enustopic0188079989table87520312215: + +.. table:: **Table 2** Parameter description + + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+========================================================================================================================================================+ + | metrics | No | String | Metrics to be queried. Separate metrics by commas (,), for example, **CpuUsage,MemUsage**. If this parameter is left blank, all metrics are queried. | + | | | | | + | | | | Options: | + | | | | | + | | | | - **CpuUsage**: CPU usage | + | | | | - **MemUsage**: memory usage | + | | | | - **DiskReadRate**: disk read rate | + | | | | - **DiskWriteRate**: disk write rate | + | | | | - **RecvBytesRate**: network receiving rate | + | | | | - **SendBytesRate**: network sending rate | + | | | | - **GpuUtil**: GPU usage | + | | | | - **GpuMemUsage**: GPU memory usage | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | statistic_type | No | String | Metric statistics method, indicating whether to collect metric statistics based on a single GPU. This parameter applies only to GPU metric statistics. | + | | | | | + | | | | - **all**: Obtain the average value of the metric. | + | | | | - **each**: Obtain the metric monitoring information about each GPU. | + +-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030151enustopic0188079989table1414514116749>`__ describes the response parameters. + +.. _modelarts030151enustopic0188079989table1414514116749: + +.. table:: **Table 3** Parameter description + + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=========================================================================================================================================================================+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Indicates the error code when the API fails to be called. Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | metrics | Json Array | Metric monitoring details. For details, see `Table 4 <#modelarts030151enustopic0188079989table8361164171810>`__. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | interval | Integer | Query interval, in minutes. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030151enustopic0188079989table8361164171810: + +.. table:: **Table 4** metrics data structure + + +-----------+------------+---------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+============+===========================================================================+ + | metric | String | Monitoring metrics | + +-----------+------------+---------------------------------------------------------------------------+ + | value | Json Array | Sequence of the obtained metric value. The element is of the String type. | + +-----------+------------+---------------------------------------------------------------------------+ + +Samples +------- + +The following example queries monitoring information about node **192.168.1.1** in the dedicated resource pool **poolabcd**. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/pools/poolabcd/nodes/192.168.1.1/metric-statistic + +- Successful sample response + + .. code-block:: + + { + "metrics": + [ + { + "metric":"gpuUtil", + "value":["1","22","33"] + } + ], + "interval" : 1 + } + +- Failed sample response + + .. code-block:: + + { + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/querying_the_details_about_a_training_job_version.rst b/api-ref/source/training_management/training_jobs/querying_the_details_about_a_training_job_version.rst new file mode 100644 index 0000000..60293f9 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/querying_the_details_about_a_training_job_version.rst @@ -0,0 +1,500 @@ +Querying the Details About a Training Job Version +================================================= + +Function +-------- + +This API is used to query the details about a specified training job based on the job ID. + +URI +--- + +GET /v1/{project_id}/training-jobs/{job_id}/versions/{version_id} + +`Table 1 <#modelarts030047enustopic0131145862table21765985143543>`__ describes the required parameters. + +.. _modelarts030047enustopic0131145862table21765985143543: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | Long | ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | Long | Version ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030047enustopic0131145862table2700823414458>`__ describes the response parameters. + +.. _modelarts030047enustopic0131145862table2700823414458: + +.. table:: **Table 2** Parameters + + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=========================================================================================================================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Long | ID of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_name | String | Name of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_desc | String | Description of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Long | Version ID of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Version name of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pre_version_id | Long | Name of the previous version of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_type | Integer | Engine type of a training job. The mapping between **engine_type** and **engine_name** is as follows: **engine_type**: **13**, **engine_name**: **Ascend-Powered-Engine** | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_name | String | Name of the engine selected for a training job. Currently, the following engines are supported: | + | | | | + | | | - Ascend-Powered-Engine | + | | | - PyTorch | + | | | - Spark_MLlib | + | | | - Scikit_Learn | + | | | - TensorFlow | + | | | - XGBoost-Sklearn | + | | | - MindSpore-GPU | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_id | Long | ID of the engine selected for a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | engine_version | String | Version of the engine selected for a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Status of a training job. For details about the job statuses, see `Job Statuses <../../training_management/job_statuses.html#modelarts030074>`__. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | app_url | String | Code directory of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | boot_file_url | String | Boot file of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a training job is created | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | parameter | Array | Running parameters of a training job. This parameter is a container environment variable when a training job uses a custom image. For details, see `Table 3 <#modelarts030047enustopic0131145862table1267642234716>`__. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | Long | Training job running duration, in milliseconds | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec_id | Long | ID of the resource specifications selected for a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | core | String | Number of cores of the resource specifications | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | cpu | String | CPU memory of the resource specifications | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | gpu_num | Integer | Number of GPUs of the resource specifications | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | gpu_type | String | GPU type of the resource specifications | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | worker_server_num | Integer | Number of workers in a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_url | String | Dataset of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | String | OBS path of the training job output file | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_url | String | OBS URL of the logs of a training job. By default, this parameter is left blank. Example value: **/usr/train/** | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_id | String | Dataset version ID of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_id | String | Dataset ID of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | data_source | Array | Datasets of a training job. For details, see `Table 4 <#modelarts030047enustopic0131145862table250595919011>`__. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_id | Long | Model ID of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | model_metric_list | String | Model metrics of a training job. For details, see `Table 5 <#modelarts030047enustopic0131145862table254511106543>`__. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | system_metric_list | JSON | System monitoring metrics of a training job. For details, see `Table 6 <#modelarts030047enustopic0131145862table199981042536>`__. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_image_url | String | SWR URL of a custom image used by a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_command | String | Boot command used to start the container of a custom image of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource_id | String | Charged resource ID of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_name | String | Dataset of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | spec_code | String | Resource specifications selected for a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | start_time | Long | Training start time | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | volumes | Array | Storage volume that can be used by a training job. For details, see `Table 11 <#modelarts030047enustopic0131145862table6403153714711>`__. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | dataset_version_name | String | Dataset of a training job | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_name | String | Name of a resource pool | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_id | String | ID of a resource pool | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | nas_mount_path | String | Local mount path of SFS Turbo (NAS). Example value: **/home/work/nas** | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | nas_share_addr | String | Shared path of SFS Turbo (NAS). Example value: **192.168.8.150:/** | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | nas_type | String | Only NFS is supported. Example value: **nfs** | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030047enustopic0131145862table1267642234716: + +.. table:: **Table 3** **parameter** parameters + + ========= ====== =============== + Parameter Type Description + ========= ====== =============== + label String Parameter name + value String Parameter value + ========= ====== =============== + + + +.. _modelarts030047enustopic0131145862table250595919011: + +.. table:: **Table 4** **data_source** parameters + + +-----------------------+-----------------------+--------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================+ + | dataset_id | String | Dataset ID of a training job | + +-----------------------+-----------------------+--------------------------------------------------------+ + | dataset_version | String | Dataset version ID of a training job | + +-----------------------+-----------------------+--------------------------------------------------------+ + | type | String | Dataset type | + | | | | + | | | - **obs**: Data from OBS is used. | + | | | - **dataset**: Data from a specified dataset is used. | + +-----------------------+-----------------------+--------------------------------------------------------+ + | data_url | String | OBS bucket path | + +-----------------------+-----------------------+--------------------------------------------------------+ + + + +.. _modelarts030047enustopic0131145862table254511106543: + +.. table:: **Table 5** **model_metric_list** parameters + + +--------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============+============+================================================================================================================================================+ + | metric | JSON Array | Validation metrics of a classification of a training job. For details, see `Table 7 <#modelarts030047enustopic0131145862table226072412518>`__. | + +--------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | total_metric | JSON | Overall validation parameters of a training job. For details, see `Table 9 <#modelarts030047enustopic0131145862table102963631010>`__. | + +--------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030047enustopic0131145862table199981042536: + +.. table:: **Table 6** **system_metric_list** parameters + + ========= ===== ============================== + Parameter Type Description + ========= ===== ============================== + cpuUsage Array CPU usage of a training job + memUsage Array Memory usage of a training job + gpuUtil Array GPU usage of a training job + ========= ===== ============================== + + + +.. _modelarts030047enustopic0131145862table226072412518: + +.. table:: **Table 7** **metric** parameters + + +---------------+------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===============+======+================================================================================================================================================+ + | metric_values | JSON | Validation metrics of a classification of a training job. For details, see `Table 8 <#modelarts030047enustopic0131145862table162521255132>`__. | + +---------------+------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | reserved_data | JSON | Reserved parameter | + +---------------+------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | metric_meta | JSON | Classification of a training job, including the classification ID and name | + +---------------+------+------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030047enustopic0131145862table162521255132: + +.. table:: **Table 8** **metric_values** parameters + + ========= ===== =============================================== + Parameter Type Description + ========= ===== =============================================== + recall Float Recall of a classification of a training job + precision Float Precision of a classification of a training job + accuracy Float Accuracy of a classification of a training job + ========= ===== =============================================== + + + +.. _modelarts030047enustopic0131145862table102963631010: + +.. table:: **Table 9** **total_metric** parameters + + +---------------------+------+---------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=====================+======+=======================================================================================================================================+ + | total_metric_meta | JSON | Reserved parameter | + +---------------------+------+---------------------------------------------------------------------------------------------------------------------------------------+ + | total_reserved_data | JSON | Reserved parameter | + +---------------------+------+---------------------------------------------------------------------------------------------------------------------------------------+ + | total_metric_values | JSON | Overall validation metrics of a training job. For details, see `Table 10 <#modelarts030047enustopic0131145862table45171749171414>`__. | + +---------------------+------+---------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030047enustopic0131145862table45171749171414: + +.. table:: **Table 10** **total_metric_values** parameters + + ========= ===== ================================= + Parameter Type Description + ========= ===== ================================= + f1_score Float F1 score of a training job + recall Float Total recall of a training job + precision Float Total precision of a training job + accuracy Float Total accuracy of a training job + ========= ===== ================================= + + + +.. _modelarts030047enustopic0131145862table6403153714711: + +.. table:: **Table 11** **volumes** parameters + + +-----------+-----------+------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+======+==========================================================================================================================================================================================================================================================================================================================================+ + | nfs | No | JSON | Storage volume of the shared file system type. Only the training jobs running in the resource pool with the shared file system network connected support such storage volume. For details, see `Table 6 <../../training_management/training_jobs/creating_a_training_job.html#modelarts030045enustopic0131062889table19871043113315>`__. | + +-----------+-----------+------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | host_path | No | JSON | Storage volume of the host file system type. Only training jobs running in the dedicated resource pool support such storage volume. For details, see `Table 7 <../../training_management/training_jobs/creating_a_training_job.html#modelarts030045enustopic0131062889table4873028185611>`__. | + +-----------+-----------+------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030047enustopic0131145862table19871043113315: + +.. table:: **Table 12** **nfs** parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=====================================================================+ + | id | Yes | String | ID of an SFS Turbo file system | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | src_path | Yes | String | Address of an SFS Turbo file system | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | dest_path | Yes | String | Local path of a training job | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | read_only | No | Boolean | Whether **dest_path** is read-only. The default value is **false**. | + | | | | | + | | | | - **true**: read-only permission | + | | | | - **false**: read/write permission. This is the default value. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + + + +.. _modelarts030047enustopic0131145862table4873028185611: + +.. table:: **Table 13** **host_path** parameters + + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+=====================================================================+ + | src_path | Yes | String | Local path of a host | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | dest_path | Yes | String | Local path of a training job | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + | read_only | No | Boolean | Whether **dest_path** is read-only. The default value is **false**. | + | | | | | + | | | | - **true**: read-only permission | + | | | | - **false**: read/write permission. This is the default value. | + +-----------------+-----------------+-----------------+---------------------------------------------------------------------+ + +Samples +------- + +The following shows how to query the details about the job whose **job_id** is **10** and **version_id** is **10**. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/training-jobs/10/versions/10 + +- Successful sample response + + .. code-block:: + + { + "is_success": true, + "job_id": 10, + "job_name": "TestModelArtsJob", + "job_desc": "TestModelArtsJob desc", + "version_id": 10, + "version_name": "jobVersion", + "pre_version_id": 5, + "engine_type": , + "engine_name": "TensorFlow", + "engine_id": 1, + "engine_version": "TF-1.4.0-python2.7", + "status": 10, + "app_url": "/usr/app/", + "boot_file_url": "/usr/app/boot.py", + "create_time": 1524189990635, + "parameter": [ + { + "label": "learning_rate", + "value": 0.01 + } + ], + "duration": 532003, + "spec_id": 1, + "core": 2, + "cpu": 8, + "gpu_num": 2, + "gpu_type": "P100", + "worker_server_num": 1, + "data_url": "/usr/data/", + "train_url": "/usr/train/", + "log_url": "/usr/log/", + "dataset_version_id": "2ff0d6ba-c480-45ae-be41-09a8369bfc90", + "dataset_id": "38277e62-9e59-48f4-8d89-c8cf41622c24", + "data_source": [ + { + "type": "obs", + "data_url": "/qianjiajun-test/minst/data/" + } + ], + "user_image_url": "100.125.5.235:20202/jobmng/custom-cpu-base:1.0", + "user_command": "bash -x /home/work/run_train.sh python /home/work/user-job-dir/app/mnist/mnist_softmax.py --data_url /home/work/user-job-dir/app/mnist_data", + "model_id": 1, + "model_metric_list": "{\"metric\":[{\"metric_values\":{\"recall\":0.005833,\"precision\":0.000178,\"accuracy\":0.000937},\"reserved_data\":{},\"metric_meta\":{\"class_name\":0,\"class_id\":0}}],\"total_metric\":{\"total_metric_meta\":{},\"total_reserved_data\":{},\"total_metric_values\":{\"recall\":0.005833,\"id\":0,\"precision\":0.000178,\"accuracy\":0.000937}}}", + "system_metric_list": { + "cpuUsage": [ + "0", + "3.10", + "5.76", + "0", + "0", + "0", + "0" + ], + "memUsage": [ + "0", + "0.77", + "2.09", + "0", + "0", + "0", + "0" + ], + "gpuUtil": [ + "0", + "0.25", + "0.88", + "0", + "0", + "0", + "0" + ], + "gpuMemUsage": [ + "0", + "0.65", + "6.01", + "0", + "0", + "0", + "0" + ], + "diskReadRate": [ + "0", + "91811.07", + "38846.63", + "0", + "0", + "0", + "0" + ], + "diskWriteRate": [ + "0", + "2.23", + "0.94", + "0", + "0", + "0", + "0" + ], + "recvBytesRate": [ + "0", + "5770405.50", + "2980077.75", + "0", + "0", + "0", + "0" + ], + "sendBytesRate": [ + "0", + "12607.17", + "10487410.00", + "0", + "0", + "0", + "0" + ], + "interval": 1 + }, + "dataset_name": "dataset-test", + "dataset_version_name": "dataset-version-test", + "spec_code": , + "start_time": 1563172362000, + "volumes": [ + { + "nfs": { + "id": "43b37236-9afa-4855-8174-32254b9562e7", + "src_path": "192.168.8.150:/", + "dest_path": "/home/work/nas", + "read_only": false + } + }, + { + "host_path": { + "src_path": "/root/work", + "dest_path": "/home/mind", + "read_only": false + } + } + ], + "pool_id": "pool9928813f", + "pool_name": "p100", + "nas_mount_path": "/home/work/nas", + "nas_share_addr": "192.168.8.150:/", + "nas_type": "nfs" + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/querying_the_statuses_and_gpu_quantity_of_all_job_versions.rst b/api-ref/source/training_management/training_jobs/querying_the_statuses_and_gpu_quantity_of_all_job_versions.rst new file mode 100644 index 0000000..48aafc7 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/querying_the_statuses_and_gpu_quantity_of_all_job_versions.rst @@ -0,0 +1,173 @@ +Querying the Statuses and GPU Quantity of All Job Versions +========================================================== + +Function +-------- + +You can use this API to query the overview information about all job versions created by a user based on specified conditions, including the statuses and GPU quantity of all job versions. + +URI +--- + +GET /v1/{project_id}/training-jobs/versions + +Table 1 Parameter description describes the required parameters. + +.. _ENUSTOPIC0000001147936839enustopic0195926038table16518993181628: + +.. table:: **Table 1** Parameter description + + ========== ========= ====== =========== + Parameter Mandatory Type Description + ========== ========= ====== =========== + project_id Yes String Project ID. + ========== ========= ====== =========== + +Request Body +------------ + +`Table 2 <#enustopic0000001147936839enustopic0195926038table125324323545>`__ describes the request parameters. + + + +.. _ENUSTOPIC0000001147936839enustopic0195926038table125324323545: + +.. table:: **Table 2** Parameter description + + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==================================================================================================================================================================================================================================================================================+ + | offset | No | Integer | Offset. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | limit | No | Integer | Number of displayed records. The default value is **20**. The value **0** indicates that all records are displayed. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | No | String | Job status. By default, all job statuses are returned. For example, to query failed jobs, set the value of **status** to **3**, **5**, **6**, or **13**. For details about the job statuses, see `Job Statuses <../../training_management/job_statuses.html#modelarts030074>`__. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Sorting mode of the query. By default, the records are sorted by **create_time**. The records can be sorted by **job_desc**, **status**, **duration**, or **job_name**. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting order. Options: | + | | | | | + | | | | - **asc**: ascending order | + | | | | - **desc**: descending order. The default value is **desc**. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_id | No | String | ID of the resource pool to be queried. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | Workspace where a job resides. Default value: **0** | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#enustopic0000001147936839enustopic0195926038table31621671103510>`__ describes the response parameters. + +.. _ENUSTOPIC0000001147936839enustopic0195926038table31621671103510: + +.. table:: **Table 3** Parameter description + + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------+ + | total_count | Integer | Total number of created job versions. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------+ + | versions | JSON Array | Attributes of a training job. For details, see `Table 4 <#enustopic0000001147936839enustopic0195926038table3971109103614>`__. | + +-----------------------+-----------------------+-------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ENUSTOPIC0000001147936839enustopic0195926038table3971109103614: + +.. table:: **Table 4** **jobs** parameters + + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============+=========+===================================================================================================================================================+ + | version_id | Long | ID of a training job | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_name | String | Name of a training job | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Byte | Status of a training job. For details about the job statuses, see `Job Statuses <../../training_management/job_statuses.html#modelarts030074>`__. | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Timestamp when a training job is created | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | start_time | Long | Timestamp when a training job starts. | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | end_time | Long | Timestamp when a training job ends. | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | Long | Running duration of a training job. | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_desc | String | Description of a training job | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | pool_id | String | ID of the resource pool to which a training job belongs. | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor_code | String | Resource specifications selected for a training job | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | npu_num | integer | Number of NPUs used by a training job. | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | gpu_num | integer | Number of GPUs used by a training job. | + +--------------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +Query training jobs in batches. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/training-jobs/versions + +- Sample response of a successful query + + .. code-block:: + + { + versions:[ + { + "version_id": 1485, + "version_name": "trainjob-3f47", + "status": 12, + "create_time": 1557473030000, + "start_time": 1557473040000, + "end_time": 1557473093000, + "duration": 53000, + "version_desc": null, + "pool_id": "pool9928813f", + "flavor_code": "modelarts.p1.2xlarge", + "npu_num": 0, + "gpu_num": 1 + } + ], + "offset": 20, + "limit": 20, + "total_count": 1, + "is_success": true + } + +- Sample response of a failed query + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/querying_training_job_logs.rst b/api-ref/source/training_management/training_jobs/querying_training_job_logs.rst new file mode 100644 index 0000000..236cb04 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/querying_training_job_logs.rst @@ -0,0 +1,123 @@ +Querying Training Job Logs +========================== + +Function +-------- + +This API is used to query detailed information about training job logs by row. + +URI +--- + +GET /v1/{project_id}/training-jobs/{job_id}/versions/{version_id}/aom-log + +`Table 1 <#modelarts030149enustopic0188093645table4442765616454>`__ describes the required parameters. + +.. _modelarts030149enustopic0188093645table4442765616454: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | Long | ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | Long | Version ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030149enustopic0188093645table87520312215>`__ describes the request parameters. + +.. _modelarts030149enustopic0188093645table87520312215: + +.. table:: **Table 2** Parameters + + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+===========================================================================================================================================================================================================================================================+ + | base_line | No | String | Base line of the log, which is obtained from an API response. If the value is empty, the latest log is obtained. | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | lines | No | Integer | Length of the obtained log. The default value is 50 lines. The value range is [0, 500]. | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | log_file | Yes | String | Name of the log file to be viewed. For details about how to obtain the log file name, see `Obtaining the Name of a Training Job Log File <../../training_management/training_jobs/obtaining_the_name_of_a_training_job_log_file.html#modelarts030054>`__. | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Log query direction | + | | | | | + | | | | - desc: Querying next records | + | | | | - asc: Querying previous records | + +-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030149enustopic0188093645table1414514116749>`__ describes the response parameters. + +.. _modelarts030149enustopic0188093645table1414514116749: + +.. table:: **Table 3** Parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | content | String | Content of the requested log | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | lines | Integer | Lines of the obtained logs | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | start_line | String | Start position of the obtained log | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | end_line | String | End position of the obtained log | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to query the logs contained in **log1.log** of the job whose **job_id** is **10** and **version_id** is **10**. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/training-jobs/10/versions/10/aom-log?log_file=log1.log&base_line= 1551252759254000002&lines=50&order=desc + +- Successful sample response + + .. code-block:: + + { + "is_success": true, + "start_line":1551252759254000002, + "content": "Log string", + "end_line": "1551252759254000003", + "lines": "1" + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/training_jobs/stopping_a_training_job.rst b/api-ref/source/training_management/training_jobs/stopping_a_training_job.rst new file mode 100644 index 0000000..a7db5f4 --- /dev/null +++ b/api-ref/source/training_management/training_jobs/stopping_a_training_job.rst @@ -0,0 +1,94 @@ +Stopping a Training Job +======================= + +Function +-------- + +This API is used to stop a training job. + +Calling this API is an asynchronous operation. The job status can be obtained by calling the APIs described in `Querying a Training Job List <../../training_management/training_jobs/querying_a_training_job_list.html#modelarts030046>`__ and `Querying the Details About a Training Job Version <../../training_management/training_jobs/querying_the_details_about_a_training_job_version.html#modelarts030047>`__. + +URI +--- + +POST /v1/{project_id}/training-jobs/{job_id}/versions/{version_id}/stop + +`Table 1 <#modelarts030051enustopic0131151010table38721821155840>`__ describes the required parameters. + +.. _modelarts030051enustopic0131151010table38721821155840: + +.. table:: **Table 1** Parameter description + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | Long | ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version_id | Yes | Long | Version ID of a training job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030051enustopic0131151010table61691357155927>`__ describes the response parameters. + +.. _modelarts030051enustopic0131151010table61691357155927: + +.. table:: **Table 2** Parameter description + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to stop a version of the job whose **job_id** is **10** and **version_id** is **10**. + +- Sample request + + .. code-block:: + + POST https://endpoint/v1/{project_id}/training-jobs/10/versions/10/stop + +- Successful sample response + + .. code-block:: + + { + "is_success": true + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Error string", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Status Code <../../common_parameters/status_code.html#modelarts030094>`__. + + diff --git a/api-ref/source/training_management/visualization_jobs/creating_a_visualization_job.rst b/api-ref/source/training_management/visualization_jobs/creating_a_visualization_job.rst new file mode 100644 index 0000000..3a3c355 --- /dev/null +++ b/api-ref/source/training_management/visualization_jobs/creating_a_visualization_job.rst @@ -0,0 +1,167 @@ +Creating a Visualization Job +============================ + +Function +-------- + +This API is used to create a visualization job. + +Calling this API is an asynchronous operation. The job status can be obtained by calling the APIs described in `Querying a Visualization Job List <../../training_management/visualization_jobs/querying_a_visualization_job_list.html#modelarts030065>`__ and `Querying the Details About a Visualization Job <../../training_management/visualization_jobs/querying_the_details_about_a_visualization_job.html#modelarts030066>`__. + +URI +--- + +POST /v1/{project_id}/visualization-jobs + +`Table 1 <#modelarts030064enustopic0131202682table569625523811>`__ describes the required parameters. + +.. _modelarts030064enustopic0131202682table569625523811: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030064enustopic0131202682table196759327241>`__ describes the request parameters. + + + +.. _modelarts030064enustopic0131202682table196759327241: + +.. table:: **Table 2** Parameters + + +-----------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+================================================================================================================================================+ + | job_name | Yes | String | Name of a visualization job. The value is a string of 1 to 20 characters consisting of only digits, letters, underscores (_), and hyphens (-). | + +-----------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_desc | No | String | Description of a visualization job. The value is a string of 0 to 256 characters. By default, this parameter is left blank. | + +-----------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | Yes | String | OBS path | + +-----------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_type | No | String | Type of a visualization job. You can create visualization jobs of TensorBoard and MindInsight types. The default type is TensorBoard. | + +-----------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | flavor | No | JSON | Specifications when a visualization job is created. You do not need to set this parameter. | + +-----------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + | schedule | No | JSON | Automatic stop setting | + +-----------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030064enustopic0131202682table18319659123214: + +.. table:: **Table 3** **flavor** parameters + + +-----------+-----------+--------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+===============================================================================================================+ + | code | Yes | String | Resource specification code of a visualization job. You can obtain the code through the **flavor** parameter. | + +-----------+-----------+--------+---------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030064enustopic0131202682table3694202918279: + +.. table:: **Table 4** **schedule** parameters + + +-----------+-----------+--------+-----------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+=====================================================+ + | type | Yes | String | Set this parameter to **stop**. | + +-----------+-----------+--------+-----------------------------------------------------+ + | time_unit | Yes | String | Unit of auto stop duration. The value is **HOURS**. | + +-----------+-----------+--------+-----------------------------------------------------+ + | duration | Yes | Int | Auto stop duration. The value ranges from 0 to 24. | + +-----------+-----------+--------+-----------------------------------------------------+ + +Response Body +------------- + +`Table 5 <#modelarts030064enustopic0131202682table28681002612>`__ describes the response parameters. + + + +.. _modelarts030064enustopic0131202682table28681002612: + +.. table:: **Table 5** Parameters + + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================================================================================================+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Long | ID of a visualization job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_name | String | Name of a visualization job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Status of a visualization job. For details about the job statuses, see `Job Statuses <../../training_management/job_statuses.html#modelarts030074>`__. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a visualization job is created, in timestamp format | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_url | String | Endpoint of a visualization job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to create a visualization job whose name is **visualization-job**, description is **this is a visualization job**, and OBS path is **/obs/name/**. + +- Sample request + + .. code-block:: + + POST https://endpoint/v1/{project_id}/visualization-jobs + { + "job_name": "visualization-job", + "job_desc": "this is a visualization job", + "train_url": "/obs/name/", + "job_type": "mindinsight", + "schedule": [ + { + "type": "stop", + "time_unit": "HOURS", + "duration": 1 + } + ] + } + +- Successful sample response + + .. code-block:: + + { + "is_success": true, + "job_id": "10", + "job_name": "visualization-job", + "status": "1", + "create_time": "1524189990635" + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "error message", + "error_code": "ModelArts.0103" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/visualization_jobs/deleting_a_visualization_job.rst b/api-ref/source/training_management/visualization_jobs/deleting_a_visualization_job.rst new file mode 100644 index 0000000..01be62e --- /dev/null +++ b/api-ref/source/training_management/visualization_jobs/deleting_a_visualization_job.rst @@ -0,0 +1,90 @@ +Deleting a Visualization Job +============================ + +Function +-------- + +This API is used to delete a visualization job. Calling this API is an asynchronous operation. The job status can be obtained by calling the APIs described in `Querying a Visualization Job List <../../training_management/visualization_jobs/querying_a_visualization_job_list.html#modelarts030065>`__ and `Querying the Details About a Visualization Job <../../training_management/visualization_jobs/querying_the_details_about_a_visualization_job.html#modelarts030066>`__. + +URI +--- + +DELETE /v1/{project_id}/visualization-jobs/{job_id} + +`Table 1 <#modelarts030068enustopic0131202686table20736351173356>`__ describes the required parameters. + +.. _modelarts030068enustopic0131202686table20736351173356: + +.. table:: **Table 1** Parameter description + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | String | ID of a visualization job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030068enustopic0131202686table9370583111247>`__ describes the response parameters. + +.. _modelarts030068enustopic0131202686table9370583111247: + +.. table:: **Table 2** Parameter description + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to delete the visualization job whose ID is 10. + +- Sample request + + .. code-block:: + + DELETE https://endpoint/v1/{project_id}/visualization-jobs/10 + +- Successful sample response + + .. code-block:: + + { + "is_success": true + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "This job can't be delete. job status: 9", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/visualization_jobs/index.rst b/api-ref/source/training_management/visualization_jobs/index.rst new file mode 100644 index 0000000..71f8670 --- /dev/null +++ b/api-ref/source/training_management/visualization_jobs/index.rst @@ -0,0 +1,14 @@ +================== +Visualization Jobs +================== + +.. toctree:: + :maxdepth: 1 + + creating_a_visualization_job + querying_a_visualization_job_list + querying_the_details_about_a_visualization_job + modifying_the_description_of_a_visualization_job + deleting_a_visualization_job + stopping_a_visualization_job + restarting_a_visualization_job diff --git a/api-ref/source/training_management/visualization_jobs/modifying_the_description_of_a_visualization_job.rst b/api-ref/source/training_management/visualization_jobs/modifying_the_description_of_a_visualization_job.rst new file mode 100644 index 0000000..ddfc644 --- /dev/null +++ b/api-ref/source/training_management/visualization_jobs/modifying_the_description_of_a_visualization_job.rst @@ -0,0 +1,103 @@ +Modifying the Description of a Visualization Job +================================================ + +Function +-------- + +This API is used to modify the description of a visualization job. + +URI +--- + +PUT /v1/{project_id}/visualization-jobs/{job_id} + +`Table 1 <#modelarts030067enustopic0131202685table4247299117445>`__ describes the required parameters. + +.. _modelarts030067enustopic0131202685table4247299117445: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | String | ID of a visualization job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +`Table 2 <#modelarts030067enustopic0131202685table212731411827>`__ describes the request parameters. + +.. _modelarts030067enustopic0131202685table212731411827: + +.. table:: **Table 2** Parameters + + +-----------+-----------+--------+-----------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+===================================================================================+ + | job_desc | Yes | String | Description of a visualization job. The value is a string of 0 to 256 characters. | + +-----------+-----------+--------+-----------------------------------------------------------------------------------+ + +Response Body +------------- + +`Table 3 <#modelarts030067enustopic0131202685table33036183111023>`__ describes the response parameters. + +.. _modelarts030067enustopic0131202685table33036183111023: + +.. table:: **Table 3** Parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to modify the description of the visualization job whose ID is **10** to **This is a ModelArts job**. + +- Sample request + + .. code-block:: + + PUT https://endpoint/v1/{project_id}/visualization-jobs/10 + { + "job_desc": "This is a ModelArts job" + } + +- Successful sample response + + .. code-block:: + + { + "is_success": true + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "Illegal name: %%123", + "error_code": "ModelArts.0104" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/visualization_jobs/querying_a_visualization_job_list.rst b/api-ref/source/training_management/visualization_jobs/querying_a_visualization_job_list.rst new file mode 100644 index 0000000..2c883fe --- /dev/null +++ b/api-ref/source/training_management/visualization_jobs/querying_a_visualization_job_list.rst @@ -0,0 +1,175 @@ +Querying a Visualization Job List +================================= + +Function +-------- + +This API is used to query the visualization jobs that meet the search criteria. + +URI +--- + +GET /v1/{project_id}/visualization-jobs + +`Table 1 <#modelarts030065enustopic0131202683table569625523811>`__ describes the required parameters. + +.. _modelarts030065enustopic0131202683table569625523811: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030065enustopic0131202683table34584035: + +.. table:: **Table 2** Query parameters + + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=================+==================================================================================================================================================================================================================================================================================+ + | status | No | String | Job status. By default, all job statuses are returned. For example, to query failed jobs, set the value of **status** to **3**, **5**, **6**, or **13**. For details about the job statuses, see `Job Statuses <../../training_management/job_statuses.html#modelarts030074>`__. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | per_page | No | Integer | Number of jobs displayed on each page. The value range is [1, 1000]. Default value: **10** | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | page | No | Integer | Index of the page to be queried. Default value: **1** | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sortBy | No | String | Sorting mode of the query. The value can be **job_id**, **job_name**, **job_desc**, **create_time**, or **status**. Default value: **job_id** | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Sorting order. Options: | + | | | | | + | | | | - **asc**: ascending order. It is the default value. | + | | | | - **desc**: descending order | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | search_content | No | String | Search content, for example, a visualization job name. The value is a string of 0 to 64 characters. By default, this parameter is left blank. | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | No | String | Workspace where a job resides. Default value: **0** | + +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 3 <#modelarts030065enustopic0131202683table116520556267>`__ describes the response parameters. + +.. _modelarts030065enustopic0131202683table116520556267: + +.. table:: **Table 3** Parameters + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+=====================================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | job_total_count | Integer | Total number of the queried visualization jobs | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | job_count_limit | Integer | Number of visualization jobs that can be created | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | jobs | **jobs** array | Visualization job attributes. For details, see `Table 4 <#modelarts030065enustopic0131202683table5856678611720>`__. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + | quotas | Integer | Maximum number of training jobs | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+ + + + +.. _modelarts030065enustopic0131202683table5856678611720: + +.. table:: **Table 4** **jobs** parameters + + +-------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+=========+========================================================================================================================================================+ + | job_name | String | Name of a visualization job | + +-------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Integer | Status of a visualization job. For details about the job statuses, see `Job Statuses <../../training_management/job_statuses.html#modelarts030074>`__. | + +-------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a visualization job is created | + +-------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | Long | Visualization job running duration, in milliseconds | + +-------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_desc | String | Description of a visualization job | + +-------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_url | String | Endpoint of a visualization job | + +-------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | String | Path for storing visualization job logs | + +-------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Long | ID of a visualization job | + +-------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource_id | String | Charged resource ID of a visualization job | + +-------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to query the top 10 visualization jobs that are being deployed on the first page in ascending order. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/visualization-jobs ?status=7&per_page=10&page=1&sortBy=status&order=asc& search_content=job_name + +- Successful sample response + + .. code-block:: + + { + "quotas": 100, + "is_success": true, + "job_total_count": 1, + "job_count_limit": 999, + "jobs": [ + { + "job_id": 1, + "job_name": "visualization-job", + "status": 1, + "create_time": 15099239923, + "resource_id": "4787c885-e18d-4ef1-aa12-c4ed0c364b27", + "duration": 1502323, + "job_desc": "This is a visualization job", + "service_url": "https://XXX/modelarts/tensoarbod/xxxx/111", + "train_url": "/obs/name/" , + "schedule": [ + { + "type": "stop", + "timeUnit": "HOURS", + "duration": 1 + } + ], + "remaining_duration": null + } + ] + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "error message", + "error_code": "ModelArts.0103" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/visualization_jobs/querying_the_details_about_a_visualization_job.rst b/api-ref/source/training_management/visualization_jobs/querying_the_details_about_a_visualization_job.rst new file mode 100644 index 0000000..98345d2 --- /dev/null +++ b/api-ref/source/training_management/visualization_jobs/querying_the_details_about_a_visualization_job.rst @@ -0,0 +1,118 @@ +Querying the Details About a Visualization Job +============================================== + +Function +-------- + +This API is used to query the details about a specified visualization job based on the job name. + +URI +--- + +GET /v1/{project_id}/visualization-jobs/{job_id} + +`Table 1 <#modelarts030066enustopic0131202684table569625523811>`__ describes the required parameters. + +.. _modelarts030066enustopic0131202684table569625523811: + +.. table:: **Table 1** Parameters + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | String | ID of a visualization job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030066enustopic0131202684table6495326155010>`__ describes the response parameters. + + + +.. _modelarts030066enustopic0131202684table6495326155010: + +.. table:: **Table 2** Parameters + + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+========================================================================================================================================================+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_name | String | Name of a visualization job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | service_url | String | Endpoint of a visualization job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource_id | String | Charged resource ID of a visualization job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Long | ID of a visualization job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_desc | String | Description of a visualization job | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | duration | Long | Visualization job running duration, in milliseconds | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Long | Time when a visualization job is created, in timestamp format | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | train_url | String | OBS path of the visualization job output file | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | Int | Status of a visualization job. For details about the job statuses, see `Job Statuses <../../training_management/job_statuses.html#modelarts030074>`__. | + +-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to query the visualization job whose ID is 10. + +- Sample request + + .. code-block:: + + GET https://endpoint/v1/{project_id}/visualization-jobs/10 + +- Successful sample response + + .. code-block:: + + { + "duration": 33000, + "service_url": "https://XXX/modelarts2/tensorboard/04f679b17380d32a2f32c00335c4b5ba/197/", + "job_name": "apiTest-11", + "create_time": 1565149736000, + "train_url": "/wph-test/zl-test/Flowers-Set/ApiTest/", + "job_id": 197, + "job_desc": "ModelArts API Dialtest", + "resource_id": "e17dd874-b5e0-4e9b-aaf0-22b045ad8571", + "remaining_duration": null, + "is_success": true, + "status": 7 + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "The length of search content should be in [0,100]", + "error_code": "ModelArts.0104" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/visualization_jobs/restarting_a_visualization_job.rst b/api-ref/source/training_management/visualization_jobs/restarting_a_visualization_job.rst new file mode 100644 index 0000000..0f374f7 --- /dev/null +++ b/api-ref/source/training_management/visualization_jobs/restarting_a_visualization_job.rst @@ -0,0 +1,90 @@ +Restarting a Visualization Job +============================== + +Function +-------- + +This API is used to restart a visualization job. Calling this API is an asynchronous operation. The job status can be obtained by calling the APIs described in `Querying a Visualization Job List <../../training_management/visualization_jobs/querying_a_visualization_job_list.html#modelarts030065>`__ and `Querying the Details About a Visualization Job <../../training_management/visualization_jobs/querying_the_details_about_a_visualization_job.html#modelarts030066>`__. + +URI +--- + +POST /v1/{project_id}/visualization-jobs/{job_id}/restart + +`Table 1 <#modelarts030070enustopic0131202688table20736351173356>`__ describes the required parameters. + +.. _modelarts030070enustopic0131202688table20736351173356: + +.. table:: **Table 1** Parameter description + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | String | ID of a visualization job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030070enustopic0131202688table1616937211145>`__ describes the response parameters. + +.. _modelarts030070enustopic0131202688table1616937211145: + +.. table:: **Table 2** Parameter description + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to restart the visualization job whose ID is 10. + +- Sample request + + .. code-block:: + + POST https://endpoint/v1/{project_id}/visualization-jobs/10/restart + +- Successful sample response + + .. code-block:: + + { + "is_success": true + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "This job can't be resubmit. job status: 8", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/training_management/visualization_jobs/stopping_a_visualization_job.rst b/api-ref/source/training_management/visualization_jobs/stopping_a_visualization_job.rst new file mode 100644 index 0000000..5502adf --- /dev/null +++ b/api-ref/source/training_management/visualization_jobs/stopping_a_visualization_job.rst @@ -0,0 +1,90 @@ +Stopping a Visualization Job +============================ + +Function +-------- + +This API is used to stop a visualization job. Calling this API is an asynchronous operation. The job status can be obtained by calling the APIs described in `Querying a Visualization Job List <../../training_management/visualization_jobs/querying_a_visualization_job_list.html#modelarts030065>`__ and `Querying the Details About a Visualization Job <../../training_management/visualization_jobs/querying_the_details_about_a_visualization_job.html#modelarts030066>`__. + +URI +--- + +POST /v1/{project_id}/visualization-jobs/{job_id}/stop + +`Table 1 <#modelarts030069enustopic0131202687table20736351173356>`__ describes the required parameters. + +.. _modelarts030069enustopic0131202687table20736351173356: + +.. table:: **Table 1** Parameter description + + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=====================================================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID and Name <../../common_parameters/obtaining_a_project_id_and_name.html#modelarts030147>`__. | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | job_id | Yes | String | ID of a visualization job | + +------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Body +------------ + +None + +Response Body +------------- + +`Table 2 <#modelarts030069enustopic0131202687table47616479111324>`__ describes the response parameters. + +.. _modelarts030069enustopic0131202687table47616479111324: + +.. table:: **Table 2** Parameter description + + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=======================+=======================+===============================================================================================================+ + | is_success | Boolean | Whether the request is successful | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_code | String | Error code of a failed API call. For details, see `Error Codes <../../common_parameters/error_codes.html>`__. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + | error_message | String | Error message of a failed API call. | + | | | | + | | | This parameter is not included when the API call succeeds. | + +-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------+ + +Samples +------- + +The following shows how to stop the visualization job whose ID is 10. + +- Sample request + + .. code-block:: + + POST https://endpoint/v1/{project_id}/visualization-jobs/10/stop + +- Successful sample response + + .. code-block:: + + { + "is_success": true + } + +- Failed sample response + + .. code-block:: + + { + "is_success": false, + "error_message": "This job can't be stop. job status: 10", + "error_code": "ModelArts.0105" + } + +Status Code +----------- + +For details about the status code, see `Table 1 <../../common_parameters/status_code.html#modelarts030094enustopic0132773864table1450010510213>`__. + + diff --git a/api-ref/source/workspace_management/creating_a_workspace.rst b/api-ref/source/workspace_management/creating_a_workspace.rst new file mode 100644 index 0000000..c1389cb --- /dev/null +++ b/api-ref/source/workspace_management/creating_a_workspace.rst @@ -0,0 +1,197 @@ +Creating a Workspace +==================== + +Function +-------- + +This API is used to create a workspace. The name of the created workspace cannot be **default**, which is the name of the default workspace reserved by the system. + +URI +--- + +POST /v1/{project_id}/workspaces + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=========================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _CreateWorkspacerequestcreateWorkspaceReq: + +.. table:: **Table 2** Request body parameters + + +-----------------------+-----------------+-------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=======================+=================+=============================================================+=======================================================================================================================================================================================================================================================================================+ + | name | Yes | String | Workspace name, encoded using UTF-8. Enter 4 to 64 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. In addition, **default** is the name of the default workspace reserved by the system. You are not allowed to create a workspace named **default**. | + +-----------------------+-----------------+-------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Workspace description. By default, this parameter is left blank. Enter 0 to 256 characters. | + +-----------------------+-----------------+-------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | enterprise_project_id | No | String | Enterprise project ID. The method of obtaining an enterprise project ID is the same as that of obtaining a project ID. | + | | | | | + | | | | Default: **0** | + +-----------------------+-----------------+-------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | auth_type | No | String | Authorization type. Options: | + | | | | | + | | | | - **PUBLIC**: public access of tenants (default value) | + | | | | | + | | | | - **PRIVATE**: accessible only to the creator and primary account | + | | | | | + | | | | - **INTERNAL**: accessible to the creator, primary account, and specified IAM users. This parameter must be used together with **grants**. | + +-----------------------+-----------------+-------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | grants | No | Array of `grants <#createworkspacerequestgrants>`__ objects | List of authorized users, which is left blank by default. This parameter must be used together with **auth_type** and takes effect only when **auth_type** is set to **INTERNAL**. | + +-----------------------+-----------------+-------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateWorkspacerequestgrants: + +.. table:: **Table 3** grants + + +-----------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+===========================================================================================================================================================================================================================================================+ + | user_id | No | String | User ID. For details about how to obtain a user ID, see `Obtaining a User ID <../common_parameters/obtaining_a_username_and_id.html>`__. Either this parameter or **user_name** must be set. If both of them are set, **user_id** is used preferentially. | + +-----------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | user_name | No | String | IAM username. Either this parameter or **user_id** must be set. | + +-----------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _CreateWorkspaceresponseworkspaceProperties: + +.. table:: **Table 4** Response body parameters + + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=========================+==============================================================+=================================================================================================================================================================================================================+ + | id | String | Workspace ID, which is a 32-bit UUID generated by the system without hyphens (-). The ID of the default workspace is **0**. | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Workspace name | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Workspace description. Enter 0 to 256 characters. | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | owner | String | Creator name. Enter 0 to 64 characters. | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Number | Time when a workspace was created, in UTC format | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Number | Last modification time, in UTC format | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | auth_type | String | Authorization type. Options: | + | | | | + | | | - **PUBLIC**: public access of tenants (default value) | + | | | | + | | | - **PRIVATE**: accessible only to the creator and primary account | + | | | | + | | | - **INTERNAL**: accessible to the creator, primary account, and specified IAM users. This parameter must be used together with **grants**. | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | enterprise_project_id | String | Enterprise project ID | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | enterprise_project_name | String | Name of an enterprise project | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Workspace status. Options: | + | | | | + | | | - **CREATE_FAILED**: Creating the workspace failed. | + | | | | + | | | - **NORMAL**: The workspace is running properly. | + | | | | + | | | - **DELETING**: The workspace is being deleted. | + | | | | + | | | - **DELETE_FAILED**: Deleting the workspace failed. | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status_info | String | Status description. By default, this parameter is left blank. This parameter is used to show detailed information about a status. If a deletion failed, you can use this parameter to obtain the failure cause. | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | grants | Array of `grants <#createworkspaceresponsegrants>`__ objects | List of authorized users, which is left blank by default. This parameter must be used together with **auth_type** and takes effect only when **auth_type** is set to **INTERNAL**. | + +-------------------------+--------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _CreateWorkspaceresponsegrants: + +.. table:: **Table 5** grants + + +-----------+--------+---------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+===========================================================================================================================+ + | user_id | String | User ID. Either this parameter or **user_name** must be set. If both of them are set, **user_id** is used preferentially. | + +-----------+--------+---------------------------------------------------------------------------------------------------------------------------+ + | user_name | String | IAM username. Either this parameter or **user_id** must be set. | + +-----------+--------+---------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Creating a Workspace + +.. code-block:: + + POST https://{endpoint}/v1/{project_id}/workspaces + + { + "name" : "test-workspace", + "description" : "It is a test project", + "enterprise_project_id" : "***b0091-887f-4839-9929-cbc884f1e***", + "auth_type" : "internal", + "grants" : [ { + "user_name" : "test" + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "id" : "**d05d1a553b4e188ea878e7dcb85e**", + "name" : "test-workspace", + "description" : "It is a test project'", + "owner" : "testUser", + "create_time" : 1470000020000, + "update_time" : 1470000030000, + "enterprise_project_id" : "***b0091-887f-4839-9929-cbc884f1e***", + "enterprise_project_name" : "test-eps", + "auth_type" : "public", + "status" : "NORMAL", + "status_info" : "" + } + +Status Codes +------------ + + + +.. _CreateWorkspacestatuscode: + +=========== =================== +Status Code Description +=========== =================== +200 OK +400 BadRequest +403 Forbidden +500 InternalServerError +=========== =================== + +Error Codes +----------- + +See `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/workspace_management/deleting_a_workspace.rst b/api-ref/source/workspace_management/deleting_a_workspace.rst new file mode 100644 index 0000000..6fc6393 --- /dev/null +++ b/api-ref/source/workspace_management/deleting_a_workspace.rst @@ -0,0 +1,89 @@ +Deleting a Workspace +==================== + +Function +-------- + +This API is used to delete a workspace. + +URI +--- + +DELETE /v1/{project_id}/workspaces/{workspace_id} + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+=========================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | Yes | String | Workspace ID. | + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _DeleteWorkspaceresponseworkspaceIdResp: + +.. table:: **Table 2** Response body parameters + + +--------------+--------+-----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============+========+=============================================================================================================================+ + | workspace_id | String | Workspace ID, which is a 32-bit UUID generated by the system without hyphens (-). The ID of the default workspace is **0**. | + +--------------+--------+-----------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Deleting a Workspace + +.. code-block:: + + DELETE https://{endpoint}/v1/{project_id}/workspaces/{workspace_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "workspace_id" : "***05d1a553b4e188ea878e7dcb85***" + } + +Status Codes +------------ + + + +.. _DeleteWorkspacestatuscode: + +=========== =================== +Status Code Description +=========== =================== +200 OK +400 BadRequest +403 Forbidden +500 InternalServerError +=========== =================== + +Error Codes +----------- + +See `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/workspace_management/index.rst b/api-ref/source/workspace_management/index.rst new file mode 100644 index 0000000..38bb716 --- /dev/null +++ b/api-ref/source/workspace_management/index.rst @@ -0,0 +1,14 @@ +==================== +Workspace Management +==================== + +.. toctree:: + :maxdepth: 1 + + creating_a_workspace + querying_a_workspace_list + deleting_a_workspace + querying_details_about_a_workspace + modifying_a_workspace + querying_a_workspace_quota + modifying_a_workspace_quota diff --git a/api-ref/source/workspace_management/modifying_a_workspace.rst b/api-ref/source/workspace_management/modifying_a_workspace.rst new file mode 100644 index 0000000..cc5c423 --- /dev/null +++ b/api-ref/source/workspace_management/modifying_a_workspace.rst @@ -0,0 +1,136 @@ +Modifying a Workspace +===================== + +Function +-------- + +This API is used to modify a workspace. + +URI +--- + +PUT /v1/{project_id}/workspaces/{workspace_id} + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+=========================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | Yes | String | Workspace ID. | + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateWorkspacerequestupdateWorkspaceReq: + +.. table:: **Table 2** Request body parameters + + +-----------------+-----------------+-------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=================+=================+=============================================================+==========================================================================================================================================================================================================================================================================================================================+ + | name | No | String | Workspace name, encoded using UTF-8. | + | | | | | + | | | | Enter 4 to 64 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. In addition, **default** is the name of the default workspace reserved by the system. You are not allowed to change the name of an existing workspace to **default**. The name of the default workspace cannot be changed. | + +-----------------+-----------------+-------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | No | String | Workspace description. By default, this parameter is left blank. Enter 0 to 256 characters. | + +-----------------+-----------------+-------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | auth_type | No | String | Authorization type. Options: | + | | | | | + | | | | - **PUBLIC**: public access of tenants (default value) | + | | | | | + | | | | - **PRIVATE**: accessible only to the creator and primary account | + | | | | | + | | | | - **INTERNAL**: accessible to the creator, primary account, and specified IAM users. This parameter must be used together with **grants**. | + +-----------------+-----------------+-------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | grants | No | Array of `grants <#updateworkspacerequestgrants>`__ objects | List of authorized users, which is left blank by default. This parameter must be used together with **auth_type** and takes effect only when **auth_type** is set to **INTERNAL**. | + +-----------------+-----------------+-------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _UpdateWorkspacerequestgrants: + +.. table:: **Table 3** grants + + +-----------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+========+===========================================================================================================================+ + | user_id | No | String | User ID. Either this parameter or **user_name** must be set. If both of them are set, **user_id** is used preferentially. | + +-----------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------+ + | user_name | No | String | IAM username. Either this parameter or **user_id** must be set. | + +-----------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _UpdateWorkspaceresponseworkspaceIdResp: + +.. table:: **Table 4** Response body parameters + + +--------------+--------+-----------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +==============+========+=============================================================================================================================+ + | workspace_id | String | Workspace ID, which is a 32-bit UUID generated by the system without hyphens (-). The ID of the default workspace is **0**. | + +--------------+--------+-----------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Modifying a Workspace + +.. code-block:: + + PUT https://{endpoint}/v1/{project_id}/workspaces/{workspace_id} + + { + "name" : "my_workspace", + "description" : "It is my workspace", + "auth_type" : "INTERNAL", + "grants" : [ { + "user_name" : "my_iam_user" + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "workspace_id" : "***05d1a553b4e188ea878e7dcb85***" + } + +Status Codes +------------ + + + +.. _UpdateWorkspacestatuscode: + +=========== =================== +Status Code Description +=========== =================== +200 OK +400 BadRequest +403 Forbidden +500 InternalServerError +=========== =================== + +Error Codes +----------- + +See `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/workspace_management/modifying_a_workspace_quota.rst b/api-ref/source/workspace_management/modifying_a_workspace_quota.rst new file mode 100644 index 0000000..d928630 --- /dev/null +++ b/api-ref/source/workspace_management/modifying_a_workspace_quota.rst @@ -0,0 +1,159 @@ +Modifying a Workspace Quota +=========================== + +Function +-------- + +This API is used to modify a workspace quota. + +URI +--- + +PUT /v1/{project_id}/workspaces/{workspace_id}/quotas + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+=========================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | Yes | String | Workspace ID. | + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + + + +.. _UpdateWorkspaceQuotasrequestupdateWorkspaceQuotasReq: + +.. table:: **Table 2** Request body parameters + + +-----------+-----------+-------------------------------------------------------------------+----------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+===================================================================+================+ + | quotas | Yes | Array of `quotas <#updateworkspacequotasrequestquotas>`__ objects | List of quotas | + +-----------+-----------+-------------------------------------------------------------------+----------------+ + + + +.. _UpdateWorkspaceQuotasrequestquotas: + +.. table:: **Table 3** quotas + + +-----------+-----------+---------+----------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +===========+===========+=========+======================================================================+ + | resource | Yes | String | Unique resource ID | + +-----------+-----------+---------+----------------------------------------------------------------------+ + | quota | Yes | Integer | Current quota. Value **-1** indicates that the quota is not limited. | + +-----------+-----------+---------+----------------------------------------------------------------------+ + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _UpdateWorkspaceQuotasresponseupdateWorkspaceQuotasResp: + +.. table:: **Table 4** Response body parameters + + +-----------+--------------------------------------------------------------------+----------------+ + | Parameter | Type | Description | + +===========+====================================================================+================+ + | quotas | Array of `quotas <#updateworkspacequotasresponsequotas>`__ objects | List of quotas | + +-----------+--------------------------------------------------------------------+----------------+ + + + +.. _UpdateWorkspaceQuotasresponsequotas: + +.. table:: **Table 5** quotas + + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+=========+=================================================================================================================================================+ + | name_en | String | Name of a quota, in English | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | name_cn | String | Name of a quota, in Chinese | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource | String | Unique resource ID | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | quota | Integer | Existing quota. Value **-1** indicates that the quota is not limited. | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | min_quota | Integer | Minimum quota | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | max_quota | Integer | Maximum quota | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | unit_en | String | Quota unit, in English | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | unit_cn | String | Quota unit, in Chinese | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Number | Last modification time, in UTC format. If the resource quota has not been modified, the default value is the time when a workspace was created. | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Modifying Workspace Quotas + +.. code-block:: + + PUT https://{endpoint}/v1/{project_id}/workspaces/{workspace_id}/quotas + + { + "quotas" : [ { + "workspace_id" : "***9cd9ea8a5432cbcd6496e57839***", + "resource" : "exemlProject.gpu_duration", + "quota" : 10 + } ] + } + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "quotas" : [ { + "name_en" : "ExeMLtraining duration (image classification, object detection, and soundclassification)", + "name_cn" : "Chinese name of the quota", + "resource" : "exemlProject.gpu_duration", + "quota" : 10, + "min_quota" : -1, + "max_quota" : 60000, + "unit_en" : "minute", + "unit_cn" : "Chinese name of the minute", + "update_time" : 1470000020000 + } ] + } + +Status Codes +------------ + + + +.. _UpdateWorkspaceQuotasstatuscode: + +=========== =================== +Status Code Description +=========== =================== +200 OK +400 BadRequest +403 Forbidden +500 InternalServerError +=========== =================== + +Error Codes +----------- + +See `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/workspace_management/querying_a_workspace_list.rst b/api-ref/source/workspace_management/querying_a_workspace_list.rst new file mode 100644 index 0000000..8bed30d --- /dev/null +++ b/api-ref/source/workspace_management/querying_a_workspace_list.rst @@ -0,0 +1,187 @@ +Querying a Workspace List +========================= + +Function +-------- + +This API is used to obtain a workspace list with detailed information contained in the response body. + +URI +--- + +GET /v1/{project_id}/workspaces + +.. table:: **Table 1** Path parameters + + +------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +============+===========+========+=========================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. table:: **Table 2** Query parameters + + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +=======================+=================+=================+=============================================================================================================================================================================================================+ + | offset | No | Integer | Start page for pagination display. The default value is **0**. | + | | | | | + | | | | Minimum: **0** | + | | | | | + | | | | Default: **0** | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | limit | No | Integer | Maximum number of records returned on each page. Default value: **1000** | + | | | | | + | | | | Minimum: **1** | + | | | | | + | | | | Default: **1000** | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | sort_by | No | String | Sorting mode. The value can be **name**, **update_time**, or **status**. Default value: **name** | + | | | | | + | | | | Default: **name** | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | order | No | String | Query sequence. Options: | + | | | | | + | | | | - **asc**: ascending order | + | | | | | + | | | | - **desc**: descending order (default value) | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | enterprise_project_id | No | String | Enterprise project ID. If this parameter is specified, only the workspaces of the enterprise project are returned. By default, all workspaces are displayed. | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | No | String | Workspace name. If this parameter is specified, the fuzzy-match workspaces are obtained. By default, all workspaces are displayed. | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | filter_accessible | No | Boolean | Filter accessible workspaces. If this parameter is set to **true**, the workspaces you are not allowed to access are filtered out. The default value is **false**, indicating all workspaces are displayed. | + | | | | | + | | | | Default: **false** | + +-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListWorkspacesresponselistWorkspacesResp: + +.. table:: **Table 3** Response body parameters + + +-------------+-----------------------------------------------------------------------------------------------------------------+-------------------------------------------------------+ + | Parameter | Type | Description | + +=============+=================================================================================================================+=======================================================+ + | total_count | Integer | Total number of workspace queries | + +-------------+-----------------------------------------------------------------------------------------------------------------+-------------------------------------------------------+ + | count | Integer | Number of workspaces returned for the current request | + +-------------+-----------------------------------------------------------------------------------------------------------------+-------------------------------------------------------+ + | workspaces | Array of `workspacePropertiesWithoutGrants <#listworkspacesresponseworkspacepropertieswithoutgrants>`__ objects | Workspace details | + +-------------+-----------------------------------------------------------------------------------------------------------------+-------------------------------------------------------+ + + + +.. _ListWorkspacesresponseworkspacePropertiesWithoutGrants: + +.. table:: **Table 4** workspacePropertiesWithoutGrants + + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=========================+=======================+=================================================================================================================================================================================================================+ + | id | String | Workspace ID, which is a 32-bit UUID generated by the system without hyphens (-). The ID of the default workspace is **0**. | + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Workspace name | + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Workspace description. Enter 0 to 256 characters. | + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | owner | String | Creator name. Enter 0 to 64 characters. | + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Number | Time when a workspace was created, in UTC format | + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Number | Last modification time, in UTC format | + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | auth_type | String | Authorization type. Options: | + | | | | + | | | - **PUBLIC**: public access of tenants (default value) | + | | | | + | | | - **PRIVATE**: accessible only to the creator and primary account | + | | | | + | | | - **INTERNAL**: accessible to the creator, primary account, and specified IAM users. This parameter must be used together with **grants**. | + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | enterprise_project_id | String | Enterprise project ID | + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | enterprise_project_name | String | Name of an enterprise project | + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Workspace status. Options: | + | | | | + | | | - **CREATE_FAILED**: Creating the workspace failed. | + | | | | + | | | - **NORMAL**: The workspace is running properly. | + | | | | + | | | - **DELETING**: The workspace is being deleted. | + | | | | + | | | - **DELETE_FAILED**: Deleting the workspace failed. | + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status_info | String | Status description. By default, this parameter is left blank. This parameter is used to show detailed information about a status. If a deletion failed, you can use this parameter to obtain the failure cause. | + +-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying a Workspace List + +.. code-block:: + + GET https://{endpoint}/v1/{project_id}/workspaces?limit=2&offset=3&sort_by=name&order=desc&enterprise_project_id=0 + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "total_count" : 10, + "count" : 1, + "workspaces" : [ { + "id" : 0, + "name" : "default", + "description" : "", + "owner" : "testUser", + "enterprise_project_id" : "***b0091-887f-4839-9929-cbc884f1e***", + "enterprise_project_name" : "default", + "auth_type" : "public", + "create_time" : 1460000010000, + "update_time" : 1460000010000, + "status" : "NORMAL", + "status_info" : "" + } ] + } + +Status Codes +------------ + + + +.. _ListWorkspacesstatuscode: + +=========== =================== +Status Code Description +=========== =================== +200 OK +400 BadRequest +403 Forbidden +500 InternalServerError +=========== =================== + +Error Codes +----------- + +See `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/workspace_management/querying_a_workspace_quota.rst b/api-ref/source/workspace_management/querying_a_workspace_quota.rst new file mode 100644 index 0000000..2d72534 --- /dev/null +++ b/api-ref/source/workspace_management/querying_a_workspace_quota.rst @@ -0,0 +1,130 @@ +Querying a Workspace Quota +========================== + +Function +-------- + +This API is used to obtain workspace quotas. + +URI +--- + +GET /v1/{project_id}/workspaces/{workspace_id}/quotas + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+=========================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | Yes | String | Workspace ID. | + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ListWorkspaceQuotasresponseworkspaceQuotasResp: + +.. table:: **Table 2** Response body parameters + + +-----------+------------------------------------------------------------------+----------------+ + | Parameter | Type | Description | + +===========+==================================================================+================+ + | quotas | Array of `quotas <#listworkspacequotasresponsequotas>`__ objects | List of quotas | + +-----------+------------------------------------------------------------------+----------------+ + + + +.. _ListWorkspaceQuotasresponsequotas: + +.. table:: **Table 3** quotas + + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=============+=========+=================================================================================================================================================+ + | name_en | String | Name of a quota, in English | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | name_cn | String | Name of a quota, in Chinese | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | resource | String | Unique resource ID | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | quota | Integer | Existing quota. Value **-1** indicates that the quota is not limited. | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | min_quota | Integer | Minimum quota | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | max_quota | Integer | Maximum quota | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | unit_en | String | Quota unit, in English | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | unit_cn | String | Quota unit, in Chinese | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Number | Last modification time, in UTC format. If the resource quota has not been modified, the default value is the time when a workspace was created. | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | used_quota | Number | Used quota. If the value of **quota** is **-1** (indicating that the quota is not limited), the **used_quota** value is **null**. | + +-------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Workspace Quotas + +.. code-block:: + + GET https://{endpoint}/v1/{project_id}/workspaces/{workspace_id}/quotas + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "quotas" : [ { + "name_en" : "ExeMLtraining duration (image classification, object detection, and soundclassification)", + "name_cn" : "Chinese name of the quota", + "resource" : "exemlProject.gpu_duration", + "quota" : 10, + "min_quota" : -1, + "max_quota" : 60000, + "unit_en" : "minute", + "unit_cn" : "Chinese name of the minute", + "update_time" : 1470000020000, + "used_quota" : 5 + } ] + } + +Status Codes +------------ + + + +.. _ListWorkspaceQuotasstatuscode: + +=========== =================== +Status Code Description +=========== =================== +200 OK +400 BadRequest +403 Forbidden +500 InternalServerError +=========== =================== + +Error Codes +----------- + +See `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/api-ref/source/workspace_management/querying_details_about_a_workspace.rst b/api-ref/source/workspace_management/querying_details_about_a_workspace.rst new file mode 100644 index 0000000..9e80e56 --- /dev/null +++ b/api-ref/source/workspace_management/querying_details_about_a_workspace.rst @@ -0,0 +1,153 @@ +Querying Details About a Workspace +================================== + +Function +-------- + +This API is used to obtain details about a workspace. + +URI +--- + +GET /v1/{project_id}/workspaces/{workspace_id} + +.. table:: **Table 1** Path parameters + + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Mandatory | Type | Description | + +==============+===========+========+=========================================================================================================================================================+ + | project_id | Yes | String | Project ID. For details about how to obtain the project ID, see `Obtaining a Project ID <../common_parameters/obtaining_a_project_id_and_name.html>`__. | + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | workspace_id | Yes | String | Workspace ID. | + +--------------+-----------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + +Request Parameters +------------------ + +None + +Response Parameters +------------------- + +**Status code: 200** + + + +.. _ShowWorkspaceInforesponseworkspaceProperties: + +.. table:: **Table 2** Response body parameters + + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +=========================+================================================================+=================================================================================================================================================================================================================+ + | id | String | Workspace ID, which is a 32-bit UUID generated by the system without hyphens (-). The ID of the default workspace is **0**. | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | Workspace name | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | Workspace description. Enter 0 to 256 characters. | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | owner | String | Creator name. Enter 0 to 64 characters. | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | create_time | Number | Time when a workspace was created, in UTC format | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | update_time | Number | Last modification time, in UTC format | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | auth_type | String | Authorization type. Options: | + | | | | + | | | - **PUBLIC**: public access of tenants (default value) | + | | | | + | | | - **PRIVATE**: accessible only to the creator and primary account | + | | | | + | | | - **INTERNAL**: accessible to the creator, primary account, and specified IAM users. This parameter must be used together with **grants**. | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | enterprise_project_id | String | Enterprise project ID | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | enterprise_project_name | String | Name of an enterprise project | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status | String | Workspace status. Options: | + | | | | + | | | - **CREATE_FAILED**: Creating the workspace failed. | + | | | | + | | | - **NORMAL**: The workspace is running properly. | + | | | | + | | | - **DELETING**: The workspace is being deleted. | + | | | | + | | | - **DELETE_FAILED**: Deleting the workspace failed. | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | status_info | String | Status description. By default, this parameter is left blank. This parameter is used to show detailed information about a status. If a deletion failed, you can use this parameter to obtain the failure cause. | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | grants | Array of `grants <#showworkspaceinforesponsegrants>`__ objects | List of authorized users, which is left blank by default. This parameter must be used together with **auth_type** and takes effect only when **auth_type** is set to **INTERNAL**. | + +-------------------------+----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + + +.. _ShowWorkspaceInforesponsegrants: + +.. table:: **Table 3** grants + + +-----------+--------+---------------------------------------------------------------------------------------------------------------------------+ + | Parameter | Type | Description | + +===========+========+===========================================================================================================================+ + | user_id | String | User ID. Either this parameter or **user_name** must be set. If both of them are set, **user_id** is used preferentially. | + +-----------+--------+---------------------------------------------------------------------------------------------------------------------------+ + | user_name | String | IAM username. Either this parameter or **user_id** must be set. | + +-----------+--------+---------------------------------------------------------------------------------------------------------------------------+ + +Example Requests +---------------- + +Querying Details About a Workspace + +.. code-block:: + + GET https://{endpoint}/v1/{project_id}/workspaces/{workspace_id} + +Example Responses +----------------- + +**Status code: 200** + +OK + +.. code-block:: + + { + "id" : "**d05d1a553b4e188ea878e7dcb85e**", + "name" : "test-workspace", + "status" : "NORMAL", + "status_info" : "", + "description" : "", + "owner" : "testUser", + "create_time" : 1470000020000, + "update_time" : 1470000030000, + "enterprise_project_id" : "***b0091-887f-4839-9929-cbc884f1e***", + "enterprise_project_name" : "test-eps", + "auth_type" : "INTERNAL", + "grants" : [ { + "user_id" : "***55d2cd53b4x458ea878e7dcb85***", + "user_name" : "test-iam-user" + } ] + } + +Status Codes +------------ + + + +.. _ShowWorkspaceInfostatuscode: + +=========== =================== +Status Code Description +=========== =================== +200 OK +400 BadRequest +403 Forbidden +500 InternalServerError +=========== =================== + +Error Codes +----------- + +See `Error Codes <../common_parameters/error_codes.html>`__. + + diff --git a/requirements.txt b/requirements.txt index 48d26e8..5ebca87 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,7 +1,7 @@ # The order of packages is significant, because pip processes them in the order # of appearance. Changing the order has an impact on the overall integration # process, which may cause wedges in the gate later. -os-api-ref>=1.4.0 # Apache-2.0 +otc-api-ref # Apache-2.0 reno>=3.1.0 # Apache-2.0 otcdocstheme # Apache-2.0 sphinx>=2.0.0,!=2.1.0 # BSD diff --git a/tox.ini b/tox.ini index 311db7b..e33024f 100644 --- a/tox.ini +++ b/tox.ini @@ -44,9 +44,12 @@ envdir = {toxworkdir}/api-ref whitelist_externals = rm make + bash commands = rm -rf api-ref/build/pdf sphinx-build -a -E -W -b latex api-ref/source api-ref/build/pdf + bash -c "for f in api-ref/build/pdf/*.gif; do convert -flatten $f $\{f/%gif/png\}; done || true" + bash -c "for f in api-ref/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done" make -C api-ref/build/pdf [testenv:umn]