Consulta de la lista de versiones del conjunto de datos
Función
Esta API se utiliza para consultar la lista de versiones de un conjunto de datos específico.
URI
GET /v2/{project_id}/datasets/{dataset_id}/versions
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
dataset_id |
Sí |
String |
ID de conjunto de datos. |
project_id |
Sí |
String |
ID del proyecto. Para obtener más información sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de proyecto. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
status |
No |
Integer |
Estado de una versión de conjunto de datos. Opciones:
|
train_evaluate_ratio |
No |
String |
Relación de división de versiones para el filtrado de versiones. Los números antes y después de la coma indican las relaciones de división mínima y máxima, y las versiones cuyas relaciones de división están dentro del intervalo se filtran, por ejemplo, 0.0,1.0. Nota: Si este parámetro se deja en blanco o no está disponible, el sistema no filtra los conjuntos de datos basados en la relación de división de versiones de forma predeterminada. |
version_format |
No |
Integer |
Formato de una versión de conjunto de datos. Opciones:
|
offset |
No |
Integer |
Página de inicio para la visualización de paginación. El valor predeterminado es 0. |
limit |
No |
Integer |
Número máximo de registros devueltos en cada página. El valor varía de 1 a 1000. El valor predeterminado es 1000. |
Parámetros de solicitud
Ninguno
Parámetros de respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripción |
---|---|---|
total_number |
Integer |
Número total de versiones del conjunto de datos. |
versions |
Array of DatasetVersion objects |
Lista de versiones del conjunto de datos. |
Parámetro |
Tipo |
Descripción |
---|---|---|
add_sample_count |
Integer |
Número de muestras añadidas. |
analysis_cache_path |
String |
Ruta de caché para el análisis de características. |
analysis_status |
Integer |
Estado de una tarea de análisis de elementos. Opciones:
|
analysis_task_id |
String |
ID de una tarea de análisis de características. |
annotated_sample_count |
Integer |
Número de muestras con versiones etiquetadas. |
annotated_sub_sample_count |
Integer |
Número de submuestras etiquetadas. |
clear_hard_property |
Boolean |
Si se deben borrar las propiedades del ejemplo duro durante la publicación. Opciones:
|
code |
String |
Código de estado de una tarea de preprocesamiento, como rotación y recorte. |
create_time |
Long |
Hora en que se crea una versión. |
crop |
Boolean |
Si desea recortar la imagen. Este campo sólo es válido para el conjunto de datos de detección de objetos cuyo cuadro de etiquetado está en forma de rectángulo. Opciones:
|
crop_path |
String |
Ruta para almacenar archivos recortados. |
crop_rotate_cache_path |
String |
Directorio temporal para ejecutar la tarea de rotación y recorte. |
data_analysis |
Map<String,Object> |
Resultado del análisis de características en formato JSON. |
data_path |
String |
Ruta para almacenar datos. |
data_statistics |
Map<String,Object> |
Estadísticas de ejemplo en un conjunto de datos, incluidas las estadísticas de metadatos de ejemplo en formato JSON. |
data_validate |
Boolean |
Si los datos son validados por el algoritmo de validación antes de publicación. Opciones:
|
deleted_sample_count |
Integer |
Número de muestras eliminadas. |
deletion_stats |
Map<String,Integer> |
Estadísticas de motivos de eliminación. |
description |
String |
Descripción de una versión. |
export_images |
Boolean |
Si desea exportar imágenes al directorio de salida de la versión durante el lanzamiento. Opciones:
|
extract_serial_number |
Boolean |
Si se va a analizar el número de submuestra durante la publicación. El campo es válido para el conjunto de datos de atención médica. Opciones:
|
include_dataset_data |
Boolean |
Si desea incluir los datos de origen de un conjunto de datos durante la publicación. Opciones:
|
is_current |
Boolean |
Si se utiliza la versión actual del conjunto de datos. Opciones:
|
label_stats |
Array of LabelStats objects |
Lista de estadísticas de etiquetas de una versión publicada. |
label_type |
String |
Tipo de etiqueta de una versión publicada. Opciones:
|
manifest_cache_input_path |
String |
Ruta de entrada para la caché del archivo de manifest durante la publicación de la versión. |
manifest_path |
String |
Ruta de acceso para almacenar el archivo de manifest con la versión publicada. |
message |
String |
Información de la tarea registrada durante la liberación (por ejemplo, información de error). |
modified_sample_count |
Integer |
Número de muestras modificadas. |
previous_annotated_sample_count |
Integer |
Número de muestras etiquetadas de versiones principales. |
previous_total_sample_count |
Integer |
Muestras totales de versiones principales. |
previous_version_id |
String |
ID de versión principal |
processor_task_id |
String |
ID de una tarea de preprocesamiento, como rotación y recorte. |
processor_task_status |
Integer |
Estado de una tarea de preprocesamiento, como rotación y recorte. Opciones:
|
remove_sample_usage |
Boolean |
Si se debe borrar la información de uso existente de un conjunto de datos durante el lanzamiento. Opciones:
|
rotate |
Boolean |
Si desea girar la imagen. Opciones:
|
rotate_path |
String |
Ruta de acceso para almacenar el archivo rotado. |
sample_state |
String |
Estado de la muestra. Opciones:
|
start_processor_task |
Boolean |
Si se debe iniciar una tarea de análisis de datos durante la publicación. Opciones:
|
status |
Integer |
Estado de una versión de conjunto de datos. Opciones:
|
tags |
Array of strings |
Lista de identificadores de clave del conjunto de datos. El tipo de etiquetado se utiliza como etiqueta predeterminada cuando la tarea de etiquetado publica una versión. Por ejemplo, ["Image","Object detection"]. |
task_type |
Integer |
Tipo de tarea de etiquetado de la versión publicada, que es el mismo que el tipo de conjunto de datos. |
total_sample_count |
Integer |
Número total de muestras de versión. |
total_sub_sample_count |
Integer |
Número total de submuestras generadas a partir de las muestras prinicpales. |
train_evaluate_sample_ratio |
String |
Dividir la relación de entrenamiento y verificación durante el lanzamiento de la versión. El valor predeterminado es 1.00, lo que indica que todas las versiones publicadas son conjuntos de entrenamiento. |
update_time |
Long |
Hora en que se actualiza una versión. |
version_format |
String |
Formato de una versión de conjunto de datos. Opciones:
|
version_id |
String |
ID de versión del conjunto de datos. |
version_name |
String |
Nombre de la versión del conjunto de datos. |
with_column_header |
Boolean |
Si la primera fila del archivo CSV publicada es un nombre de columna. Este campo es válido para el conjunto de datos de la tabla. Opciones:
|
Parámetro |
Tipo |
Descripción |
---|---|---|
attributes |
Array of LabelAttribute objects |
Atributo multidimensional de una etiqueta. Por ejemplo, si la etiqueta es música, se pueden incluir atributos como el estilo y el artista. |
count |
Integer |
Número de etiquetas. |
name |
String |
Nombre de la etiqueta. |
property |
LabelProperty object |
Par clave-valor de atributo básico de una etiqueta, como el color y las teclas de método abreviado. |
sample_count |
Integer |
Número de muestras que contienen la etiqueta. |
type |
Integer |
Tipo de etiqueta. Opciones:
|
Parámetro |
Tipo |
Descripción |
---|---|---|
default_value |
String |
Valor predeterminado de un atributo de etiqueta. |
id |
String |
ID de atributo de etiqueta. |
name |
String |
Nombre del atributo de etiqueta. |
type |
String |
Tipo de atributo de etiqueta. Opciones:
|
values |
Array of LabelAttributeValue objects |
Lista de valores de atributo de etiqueta. |
Parámetro |
Tipo |
Descripción |
---|---|---|
id |
String |
ID de valor de atributo de etiqueta. |
value |
String |
Valor del atributo de etiqueta. |
Parámetro |
Tipo |
Descripción |
---|---|---|
@modelarts:color |
String |
Atributo predeterminado: Color de etiqueta, que es un código hexadecimal del color. De forma predeterminada, este parámetro se deja en blanco. Ejemplo: #FFFFF0. |
@modelarts:default_shape |
String |
Atributo predeterminado: forma predeterminada de una etiqueta de detección de objeto (atributo dedicado). De forma predeterminada, este parámetro se deja en blanco. Opciones:
|
@modelarts:from_type |
String |
Atributo por defecto: Tipo de la entidad de cabecera en la etiqueta de relación de triplete. Este atributo debe especificarse cuando se crea una etiqueta de relación. Este parámetro solo se utiliza para el conjunto de datos de texto triplete. |
@modelarts:rename_to |
String |
Atributo predeterminado: el nuevo nombre de la etiqueta. |
@modelarts:shortcut |
String |
Atributo predeterminado: Tecla de método abreviado de etiqueta. De forma predeterminada, este parámetro se deja en blanco. Por ejemplo: D. |
@modelarts:to_type |
String |
Atributo por defecto: Tipo de la entidad de cola en la etiqueta de relación de triplete. Este atributo debe especificarse cuando se crea una etiqueta de relación. Este parámetro solo se utiliza para el conjunto de datos de texto triplete. |
Solicitudes de ejemplo
Consulta de la lista de versiones de un conjunto de datos específico
GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/versions
Ejemplo de respuestas
Código de estado: 200
OK
{ "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, "analysis_status" : 3, "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, "analysis_status" : 3, "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, "analysis_status" : 3, "train_evaluate_sample_ratio" : "0.99", "remove_sample_usage" : false, "export_images" : false, "description" : "", "task_type" : 0, "extract_serial_number" : false } ] }
Códigos de estado
Código de estado |
Descripción |
---|---|
200 |
OK |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
Códigos de error
Consulte Códigos de error.