organization_data_api module
OrganizationDataApi
class edgeimpulse_api.api.organization_data_api.OrganizationDataApi(
api_client=None
)
Parameters
api_client=None
Methods
add_organization_bucket
edgeimpulse_api.api.organization_data_api.add_organization_bucket(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
add_organization_bucket_request: edgeimpulse_api.models.add_organization_bucket_request.AddOrganizationBucketRequest,
**kwargs
) ‑> edgeimpulse_api.models.entity_created_response.EntityCreatedResponse
Add a storage bucket
Add a storage bucket.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
add_organization_bucket_request: edgeimpulse_api.models.add_organization_bucket_request.AddOrganizationBucketRequest
**kwargs
Return
edgeimpulse_api.models.entity_created_response.EntityCreatedResponse
add_organization_data_file
edgeimpulse_api.api.organization_data_api.add_organization_data_file(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})],
files: List[pydantic.types.StrictBytes],
**kwargs
) ‑> edgeimpulse_api.models.generic_api_response.GenericApiResponse
Add files
Add a new file to an existing data item.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})]
files: List[pydantic.types.StrictBytes]
**kwargs
Return
edgeimpulse_api.models.generic_api_response.GenericApiResponse
add_organization_data_folder
edgeimpulse_api.api.organization_data_api.add_organization_data_folder(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
organization_add_data_folder_request: edgeimpulse_api.models.organization_add_data_folder_request.OrganizationAddDataFolderRequest,
**kwargs
) ‑> edgeimpulse_api.models.start_job_response.StartJobResponse
Add data items from bucket
Bulk adds data items that already exist in a storage bucket. The bucket path specified should contain folders. Each folder is added as a data item in Edge Impulse.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
organization_add_data_folder_request: edgeimpulse_api.models.organization_add_data_folder_request.OrganizationAddDataFolderRequest
**kwargs
Return
edgeimpulse_api.models.start_job_response.StartJobResponse
add_organization_data_item
edgeimpulse_api.api.organization_data_api.add_organization_data_item(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
name: pydantic.types.StrictStr,
dataset: pydantic.types.StrictStr,
metadata: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Key-value pair of metadata (in JSON format)', extra={})],
files: List[pydantic.types.StrictBytes],
bucket_id: pydantic.types.StrictInt | None = None,
bucket_name: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Name of the bucket name (as an Edge Impulse name)', extra={})] = None,
bucket_path: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Optional path in the bucket to create this data item (files are created under this path).', extra={})] = None,
**kwargs
) ‑> edgeimpulse_api.models.entity_created_response.EntityCreatedResponse
Add new data
Add a new data item. You can add a maximum of 10000 files directly through this API. Use addOrganizationDataFile
to add additional files.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
name: pydantic.types.StrictStr
dataset: pydantic.types.StrictStr
metadata: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Key-value pair of metadata (in JSON format)', extra={})]
files: List[pydantic.types.StrictBytes]
bucket_id: pydantic.types.StrictInt | None = None
bucket_name: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Name of the bucket name (as an Edge Impulse name)', extra={})] = None
bucket_path: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Optional path in the bucket to create this data item (files are created under this path).', extra={})] = None
**kwargs
Return
edgeimpulse_api.models.entity_created_response.EntityCreatedResponse
add_organization_dataset
edgeimpulse_api.api.organization_data_api.add_organization_dataset(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
organization_add_dataset_request: edgeimpulse_api.models.organization_add_dataset_request.OrganizationAddDatasetRequest,
**kwargs
) ‑> edgeimpulse_api.models.start_job_response.StartJobResponse
Add dataset
Add a new research dataset
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
organization_add_dataset_request: edgeimpulse_api.models.organization_add_dataset_request.OrganizationAddDatasetRequest
**kwargs
Return
edgeimpulse_api.models.start_job_response.StartJobResponse
change_dataset_organization_data_items
edgeimpulse_api.api.organization_data_api.change_dataset_organization_data_items(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_ids: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Data IDs as an Array', extra={})],
set_organization_data_dataset_request: edgeimpulse_api.models.set_organization_data_dataset_request.SetOrganizationDataDatasetRequest,
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None,
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None,
**kwargs
) ‑> edgeimpulse_api.models.start_job_response.StartJobResponse
Change dataset
Change the dataset for selected data items.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_ids: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Data IDs as an Array', extra={})]
set_organization_data_dataset_request: edgeimpulse_api.models.set_organization_data_dataset_request.SetOrganizationDataDatasetRequest
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None
**kwargs
Return
edgeimpulse_api.models.start_job_response.StartJobResponse
clear_checklist_organization_data_items
edgeimpulse_api.api.organization_data_api.clear_checklist_organization_data_items(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_ids: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Data IDs as an Array', extra={})],
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None,
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None,
**kwargs
) ‑> edgeimpulse_api.models.start_job_response.StartJobResponse
Clear checklist for data
Clear all checklist flags for selected data items.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_ids: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Data IDs as an Array', extra={})]
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None
**kwargs
Return
edgeimpulse_api.models.start_job_response.StartJobResponse
create_signed_upload_link_dataset
edgeimpulse_api.api.organization_data_api.create_signed_upload_link_dataset(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
create_signed_upload_link_request: edgeimpulse_api.models.create_signed_upload_link_request.CreateSignedUploadLinkRequest,
**kwargs
) ‑> edgeimpulse_api.models.create_signed_upload_link_response.CreateSignedUploadLinkResponse
Create pre-signed S3 upload link
Creates a signed link to securely upload data to s3 bucket directly from the client.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
create_signed_upload_link_request: edgeimpulse_api.models.create_signed_upload_link_request.CreateSignedUploadLinkRequest
**kwargs
Return
edgeimpulse_api.models.create_signed_upload_link_response.CreateSignedUploadLinkResponse
delete_dataset_file
edgeimpulse_api.api.organization_data_api.delete_dataset_file(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
delete_portal_file_request: edgeimpulse_api.models.delete_portal_file_request.DeletePortalFileRequest,
**kwargs
) ‑> edgeimpulse_api.models.generic_api_response.GenericApiResponse
Delete file from dataset
Delete a file from a dataset
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
delete_portal_file_request: edgeimpulse_api.models.delete_portal_file_request.DeletePortalFileRequest
**kwargs
Return
edgeimpulse_api.models.generic_api_response.GenericApiResponse
delete_organization_data_file
edgeimpulse_api.api.organization_data_api.delete_organization_data_file(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})],
file_name: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='File name', extra={})],
**kwargs
) ‑> edgeimpulse_api.models.generic_api_response.GenericApiResponse
Delete file
Delete a single file from a data item.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})]
file_name: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='File name', extra={})]
**kwargs
Return
edgeimpulse_api.models.generic_api_response.GenericApiResponse
delete_organization_data_item
edgeimpulse_api.api.organization_data_api.delete_organization_data_item(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})],
**kwargs
) ‑> edgeimpulse_api.models.generic_api_response.GenericApiResponse
Delete data
Delete a data item. This will remove items the items from the underlying storage if your dataset has "bucketPath" set.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})]
**kwargs
Return
edgeimpulse_api.models.generic_api_response.GenericApiResponse
delete_organization_data_items
edgeimpulse_api.api.organization_data_api.delete_organization_data_items(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_ids: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Data IDs as an Array', extra={})],
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None,
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None,
**kwargs
) ‑> edgeimpulse_api.models.start_job_response.StartJobResponse
Delete data
Delete all data for selected data items. This removes all data in the underlying data bucket.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_ids: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Data IDs as an Array', extra={})]
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None
**kwargs
Return
edgeimpulse_api.models.start_job_response.StartJobResponse
download_dataset_file
edgeimpulse_api.api.organization_data_api.download_dataset_file(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
download_portal_file_request: edgeimpulse_api.models.download_portal_file_request.DownloadPortalFileRequest,
**kwargs
) ‑> edgeimpulse_api.models.download_portal_file_response.DownloadPortalFileResponse
Download file from dataset
Download a file from a dataset. Will return a signed URL to the bucket.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
download_portal_file_request: edgeimpulse_api.models.download_portal_file_request.DownloadPortalFileRequest
**kwargs
Return
edgeimpulse_api.models.download_portal_file_response.DownloadPortalFileResponse
download_dataset_folder
edgeimpulse_api.api.organization_data_api.download_dataset_folder(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
path: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Path, relative to dataset', extra={})],
**kwargs
) ‑> str
Download folder from dataset
Download all files in the given folder in a dataset, ignoring any subdirectories.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
path: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Path, relative to dataset', extra={})]
**kwargs
Return
str
download_organization_data_file
edgeimpulse_api.api.organization_data_api.download_organization_data_file(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})],
file_name: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='File name', extra={})],
**kwargs
) ‑> str
Download file
Download a single file from a data item.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})]
file_name: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='File name', extra={})]
**kwargs
Return
str
download_organization_data_item
edgeimpulse_api.api.organization_data_api.download_organization_data_item(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_ids: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Data IDs as an Array', extra={})],
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None,
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None,
**kwargs
) ‑> str
Download data
Download all data for selected data items. This function does not query the underlying bucket.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_ids: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Data IDs as an Array', extra={})]
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None
**kwargs
Return
str
download_organization_single_data_item
edgeimpulse_api.api.organization_data_api.download_organization_single_data_item(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})],
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None,
**kwargs
) ‑> str
Download data
Download all data for this data item.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})]
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None
**kwargs
Return
str
get_organization_bucket
edgeimpulse_api.api.organization_data_api.get_organization_bucket(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
bucket_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Bucket ID', extra={})],
**kwargs
) ‑> edgeimpulse_api.models.get_organization_bucket_response.GetOrganizationBucketResponse
Get storage bucket
Get storage bucket details.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
bucket_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Bucket ID', extra={})]
**kwargs
Return
edgeimpulse_api.models.get_organization_bucket_response.GetOrganizationBucketResponse
get_organization_data_item
edgeimpulse_api.api.organization_data_api.get_organization_data_item(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})],
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None,
**kwargs
) ‑> edgeimpulse_api.models.get_organization_data_item_response.GetOrganizationDataItemResponse
Get data metadata
Get a data item. This will HEAD the underlying bucket to retrieve the last file information.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})]
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None
**kwargs
Return
edgeimpulse_api.models.get_organization_data_item_response.GetOrganizationDataItemResponse
get_organization_data_item_transform_jobs
edgeimpulse_api.api.organization_data_api.get_organization_data_item_transform_jobs(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})],
limit: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Maximum number of results', extra={})] = None,
offset: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Offset in results, can be used in conjunction with LimitResultsParameter to implement paging.', extra={})] = None,
**kwargs
) ‑> edgeimpulse_api.models.get_organization_data_item_transform_jobs_response.GetOrganizationDataItemTransformJobsResponse
Get transformation jobs for data item
Get all transformation jobs that ran for a data item. If limit / offset is not provided then max. 20 results are returned.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})]
limit: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Maximum number of results', extra={})] = None
offset: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Offset in results, can be used in conjunction with LimitResultsParameter to implement paging.', extra={})] = None
**kwargs
Return
edgeimpulse_api.models.get_organization_data_item_transform_jobs_response.GetOrganizationDataItemTransformJobsResponse
get_organization_dataset
edgeimpulse_api.api.organization_data_api.get_organization_dataset(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
**kwargs
) ‑> edgeimpulse_api.models.get_organization_dataset_response.GetOrganizationDatasetResponse
Get dataset
Get information about a dataset
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
**kwargs
Return
edgeimpulse_api.models.get_organization_dataset_response.GetOrganizationDatasetResponse
hide_organization_dataset
edgeimpulse_api.api.organization_data_api.hide_organization_dataset(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
**kwargs
) ‑> edgeimpulse_api.models.generic_api_response.GenericApiResponse
Hide dataset
Hide a dataset (does not remove underlying data)
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
**kwargs
Return
edgeimpulse_api.models.generic_api_response.GenericApiResponse
list_dataset_files_in_folder
edgeimpulse_api.api.organization_data_api.list_dataset_files_in_folder(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
list_portal_files_in_folder_request: edgeimpulse_api.models.list_portal_files_in_folder_request.ListPortalFilesInFolderRequest,
**kwargs
) ‑> edgeimpulse_api.models.list_portal_files_in_folder_response.ListPortalFilesInFolderResponse
List files in dataset
List all files and directories in specified prefix.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
list_portal_files_in_folder_request: edgeimpulse_api.models.list_portal_files_in_folder_request.ListPortalFilesInFolderRequest
**kwargs
Return
edgeimpulse_api.models.list_portal_files_in_folder_response.ListPortalFilesInFolderResponse
list_organization_buckets
edgeimpulse_api.api.organization_data_api.list_organization_buckets(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
**kwargs
) ‑> edgeimpulse_api.models.list_organization_buckets_response.ListOrganizationBucketsResponse
List storage buckets
Retrieve all configured storage buckets. This does not list the secret key.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
**kwargs
Return
edgeimpulse_api.models.list_organization_buckets_response.ListOrganizationBucketsResponse
list_organization_data
edgeimpulse_api.api.organization_data_api.list_organization_data(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None,
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None,
limit: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Maximum number of results', extra={})] = None,
offset: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Offset in results, can be used in conjunction with LimitResultsParameter to implement paging.', extra={})] = None,
**kwargs
) ‑> edgeimpulse_api.models.list_organization_data_response.ListOrganizationDataResponse
List data
Lists all data items. This can be filtered by the ?filter parameter.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None
limit: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Maximum number of results', extra={})] = None
offset: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Offset in results, can be used in conjunction with LimitResultsParameter to implement paging.', extra={})] = None
**kwargs
Return
edgeimpulse_api.models.list_organization_data_response.ListOrganizationDataResponse
list_organization_files
edgeimpulse_api.api.organization_data_api.list_organization_files(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None,
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None,
limit: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Maximum number of results', extra={})] = None,
offset: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Offset in results, can be used in conjunction with LimitResultsParameter to implement paging.', extra={})] = None,
**kwargs
) ‑> edgeimpulse_api.models.list_organization_files_response.ListOrganizationFilesResponse
List files
Lists all files included by the filter.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description='Selected dataset', extra={})] = None
filter: Annotated[pydantic.types.StrictStr | None, FieldInfo(default=PydanticUndefined, description="Data filter in SQL WHERE format, where you can reference 'dataset', 'bucket', 'name', 'total_file_count', 'total_file_size', 'created' and any metadata label through 'metadata->' (dots are replaced by underscore).", extra={})] = None
limit: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Maximum number of results', extra={})] = None
offset: Annotated[pydantic.types.StrictInt | None, FieldInfo(default=PydanticUndefined, description='Offset in results, can be used in conjunction with LimitResultsParameter to implement paging.', extra={})] = None
**kwargs
Return
edgeimpulse_api.models.list_organization_files_response.ListOrganizationFilesResponse
organization_bulk_update_metadata
edgeimpulse_api.api.organization_data_api.organization_bulk_update_metadata(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: pydantic.types.StrictStr,
csv_file: pydantic.types.StrictStr,
**kwargs
) ‑> edgeimpulse_api.models.start_job_response.StartJobResponse
Bulk update metadata
Bulk update the metadata of many data items in one go. This requires you to submit a CSV file with headers, one of which the columns should be named 'name'. The other columns are used as metadata keys.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: pydantic.types.StrictStr
csv_file: pydantic.types.StrictStr
**kwargs
Return
edgeimpulse_api.models.start_job_response.StartJobResponse
preview_default_files_in_folder
edgeimpulse_api.api.organization_data_api.preview_default_files_in_folder(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
preview_default_files_in_folder_request: edgeimpulse_api.models.preview_default_files_in_folder_request.PreviewDefaultFilesInFolderRequest,
**kwargs
) ‑> edgeimpulse_api.models.preview_default_files_in_folder_response.PreviewDefaultFilesInFolderResponse
Preview files in a default dataset
Preview files and directories in a default dataset for the given prefix, with support for wildcards. This is an internal API used when starting a transformation job.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
preview_default_files_in_folder_request: edgeimpulse_api.models.preview_default_files_in_folder_request.PreviewDefaultFilesInFolderRequest
**kwargs
Return
edgeimpulse_api.models.preview_default_files_in_folder_response.PreviewDefaultFilesInFolderResponse
preview_organization_data_file
edgeimpulse_api.api.organization_data_api.preview_organization_data_file(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})],
file_name: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='File name', extra={})],
**kwargs
) ‑> str
Preview file
Preview a single file from a data item (same as downloadOrganizationDataFile but w/ content-disposition inline and could be truncated).
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})]
file_name: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='File name', extra={})]
**kwargs
Return
str
refresh_organization_data
edgeimpulse_api.api.organization_data_api.refresh_organization_data(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Selected dataset', extra={})],
**kwargs
) ‑> edgeimpulse_api.models.start_job_response.StartJobResponse
Refresh data
Update all data items. HEADs all underlying buckets to retrieve the last file information. Use this API after uploading data directly to S3. If your dataset has bucketId and bucketPath set then this will also remove items that have been removed from S3.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Selected dataset', extra={})]
**kwargs
Return
edgeimpulse_api.models.start_job_response.StartJobResponse
remove_organization_bucket
edgeimpulse_api.api.organization_data_api.remove_organization_bucket(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
bucket_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Bucket ID', extra={})],
**kwargs
) ‑> edgeimpulse_api.models.generic_api_response.GenericApiResponse
Remove storage bucket
Remove a storage bucket. This will render any data in this storage bucket unreachable.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
bucket_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Bucket ID', extra={})]
**kwargs
Return
edgeimpulse_api.models.generic_api_response.GenericApiResponse
rename_dataset_file
edgeimpulse_api.api.organization_data_api.rename_dataset_file(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
rename_portal_file_request: edgeimpulse_api.models.rename_portal_file_request.RenamePortalFileRequest,
**kwargs
) ‑> edgeimpulse_api.models.generic_api_response.GenericApiResponse
Rename file from dataset
Rename a file in a dataset
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
rename_portal_file_request: edgeimpulse_api.models.rename_portal_file_request.RenamePortalFileRequest
**kwargs
Return
edgeimpulse_api.models.generic_api_response.GenericApiResponse
update_organization_bucket
edgeimpulse_api.api.organization_data_api.update_organization_bucket(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
bucket_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Bucket ID', extra={})],
update_organization_bucket_request: edgeimpulse_api.models.update_organization_bucket_request.UpdateOrganizationBucketRequest,
**kwargs
) ‑> edgeimpulse_api.models.generic_api_response.GenericApiResponse
Update storage bucket
Updates storage bucket details. This only updates fields that were set in the request body. Before updating the bucket details, it is required to verify the connection using the POST /api/organizations/{organizationId}/buckets/verify endpoint. The verification process: 1. Call the verify endpoint with the new bucket details. 2. Poll the verify endpoint until it responds with connectionStatus: connected
. 3. If the endpoint responds with connectionStatus: error
, the verification has failed. Only proceed with updating the bucket details after receiving a connected
status. The polling interval and timeout should be determined based on your application's requirements.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
bucket_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Bucket ID', extra={})]
update_organization_bucket_request: edgeimpulse_api.models.update_organization_bucket_request.UpdateOrganizationBucketRequest
**kwargs
Return
edgeimpulse_api.models.generic_api_response.GenericApiResponse
update_organization_data_item
edgeimpulse_api.api.organization_data_api.update_organization_data_item(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})],
update_organization_data_item_request: edgeimpulse_api.models.update_organization_data_item_request.UpdateOrganizationDataItemRequest,
**kwargs
) ‑> edgeimpulse_api.models.generic_api_response.GenericApiResponse
Update data metadata
Update the data item metadata.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
data_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Data ID', extra={})]
update_organization_data_item_request: edgeimpulse_api.models.update_organization_data_item_request.UpdateOrganizationDataItemRequest
**kwargs
Return
edgeimpulse_api.models.generic_api_response.GenericApiResponse
update_organization_dataset
edgeimpulse_api.api.organization_data_api.update_organization_dataset(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
update_organization_dataset_request: edgeimpulse_api.models.update_organization_dataset_request.UpdateOrganizationDatasetRequest,
**kwargs
) ‑> edgeimpulse_api.models.generic_api_response.GenericApiResponse
Update dataset
Set information about a dataset
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
update_organization_dataset_request: edgeimpulse_api.models.update_organization_dataset_request.UpdateOrganizationDatasetRequest
**kwargs
Return
edgeimpulse_api.models.generic_api_response.GenericApiResponse
verify_dataset
edgeimpulse_api.api.organization_data_api.verify_dataset(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
**kwargs
) ‑> edgeimpulse_api.models.verify_organization_bucket_response.VerifyOrganizationBucketResponse
Verify dataset
Verify whether we can reach a dataset (and return some random files, used for data sources)
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
**kwargs
Return
edgeimpulse_api.models.verify_organization_bucket_response.VerifyOrganizationBucketResponse
verify_existing_organization_bucket
edgeimpulse_api.api.organization_data_api.verify_existing_organization_bucket(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
bucket_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Bucket ID', extra={})],
verify_organization_existing_bucket_request: edgeimpulse_api.models.verify_organization_existing_bucket_request.VerifyOrganizationExistingBucketRequest,
**kwargs
) ‑> edgeimpulse_api.models.verify_organization_bucket_response.VerifyOrganizationBucketResponse
Verify existing bucket connectivity
Verify whether we can reach a bucket before adding it.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
bucket_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Bucket ID', extra={})]
verify_organization_existing_bucket_request: edgeimpulse_api.models.verify_organization_existing_bucket_request.VerifyOrganizationExistingBucketRequest
**kwargs
Return
edgeimpulse_api.models.verify_organization_bucket_response.VerifyOrganizationBucketResponse
verify_organization_bucket
edgeimpulse_api.api.organization_data_api.verify_organization_bucket(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
verify_organization_bucket_request: edgeimpulse_api.models.verify_organization_bucket_request.VerifyOrganizationBucketRequest,
**kwargs
) ‑> edgeimpulse_api.models.verify_organization_bucket_response.VerifyOrganizationBucketResponse
Verify bucket connectivity
Verify connectivity to a storage bucket and optionally list its contents. This endpoint allows you to: 1. Check if the provided bucket credentials are valid and the bucket is accessible. 2. Optionally list files in the bucket up to a specified limit. 3. Validate the bucket configuration before adding it to the organization. The request can include details such as the bucket name, region, credentials, and listing options. The response provides information about the bucket's accessibility and, if requested, a list of files in the bucket. Important note on verification process: - For S3-compatible storage backends: Verification is expected to be immediate. - For Azure buckets: Verification takes longer. Users are required to poll this endpoint until the connectionStatus changes from 'connecting' to 'connected'. When dealing with Azure buckets, implement a polling mechanism to check the status periodically until it's confirmed as connected.
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
verify_organization_bucket_request: edgeimpulse_api.models.verify_organization_bucket_request.VerifyOrganizationBucketRequest
**kwargs
Return
edgeimpulse_api.models.verify_organization_bucket_response.VerifyOrganizationBucketResponse
view_dataset_file
edgeimpulse_api.api.organization_data_api.view_dataset_file(
self,
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})],
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})],
path: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Path to file in portal', extra={})],
**kwargs
) ‑> str
View file from dataset
View a file that's located in a dataset (requires JWT auth). File might be converted (e.g. Parquet) or truncated (e.g. CSV).
Parameters
self
organization_id: Annotated[pydantic.types.StrictInt, FieldInfo(default=Ellipsis, description='Organization ID', extra={})]
dataset: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Dataset name', extra={})]
path: Annotated[pydantic.types.StrictStr, FieldInfo(default=Ellipsis, description='Path to file in portal', extra={})]
**kwargs
Return
str
Last updated
Was this helpful?