orvanta-api 4.1.0

No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
Documentation
# \DataMigrationApi

All URIs are relative to */api*

Method | HTTP request | Description
------------- | ------------- | -------------
[**archive_data_migration_by_path**](DataMigrationApi.md#archive_data_migration_by_path) | **POST** /w/{workspace}/data_migration/definitions/archive/{path} | archive or unarchive a data-migration definition
[**create_data_migration**](DataMigrationApi.md#create_data_migration) | **POST** /w/{workspace}/data_migration/definitions/create | create a data-migration definition
[**data_migration_dry_run**](DataMigrationApi.md#data_migration_dry_run) | **POST** /w/{workspace}/data_migration/dry_run | dry-run a source->target data migration (preview only, no writes)
[**data_migration_get_run**](DataMigrationApi.md#data_migration_get_run) | **GET** /w/{workspace}/data_migration/runs/{id} | get one data-migration run, with its mapping and error text
[**data_migration_list_runs**](DataMigrationApi.md#data_migration_list_runs) | **GET** /w/{workspace}/data_migration/runs | list this workspace's data-migration runs, newest first
[**data_migration_run**](DataMigrationApi.md#data_migration_run) | **POST** /w/{workspace}/data_migration/run | queue a source->target data migration
[**delete_data_migration_by_path**](DataMigrationApi.md#delete_data_migration_by_path) | **DELETE** /w/{workspace}/data_migration/definitions/delete/{path} | delete a data-migration definition
[**exists_data_migration_by_path**](DataMigrationApi.md#exists_data_migration_by_path) | **GET** /w/{workspace}/data_migration/definitions/exists/{path} | does a data-migration definition exist at this path
[**get_data_migration_by_path**](DataMigrationApi.md#get_data_migration_by_path) | **GET** /w/{workspace}/data_migration/definitions/get/{path} | get a data-migration definition by path
[**list_data_migrations**](DataMigrationApi.md#list_data_migrations) | **GET** /w/{workspace}/data_migration/definitions/list | list saved data-migration definitions
[**update_data_migration**](DataMigrationApi.md#update_data_migration) | **POST** /w/{workspace}/data_migration/definitions/update/{path} | update a data-migration definition



## archive_data_migration_by_path

> String archive_data_migration_by_path(workspace, path, archive_flow_by_path_request)
archive or unarchive a data-migration definition

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |
**archive_flow_by_path_request** | [**ArchiveFlowByPathRequest**](ArchiveFlowByPathRequest.md) | archive a data-migration definition | [required] |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## create_data_migration

> String create_data_migration(workspace, new_data_migration)
create a data-migration definition

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**new_data_migration** | [**NewDataMigration**](NewDataMigration.md) | data-migration definition to create | [required] |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## data_migration_dry_run

> models::DryRunReport data_migration_dry_run(workspace, data_migration_request)
dry-run a source->target data migration (preview only, no writes)

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**data_migration_request** | [**DataMigrationRequest**](DataMigrationRequest.md) | source/target resources, tables, and column mapping to preview | [required] |

### Return type

[**models::DryRunReport**](DryRunReport.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## data_migration_get_run

> models::DataMigrationRunDetail data_migration_get_run(workspace, id)
get one data-migration run, with its mapping and error text

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**id** | **i64** | `data_migration_run.id` | [required] |

### Return type

[**models::DataMigrationRunDetail**](DataMigrationRunDetail.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## data_migration_list_runs

> Vec<models::DataMigrationRunSummary> data_migration_list_runs(workspace, page, per_page, status)
list this workspace's data-migration runs, newest first

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**page** | Option<**i32**> | which page to return (start at 1, default 1) |  |
**per_page** | Option<**i32**> | number of items to return for a given page (default 30, max 100) |  |
**status** | Option<**String**> | exact `status` match -- `running`, `completed`, `failed` or `cancelled`. Any other value simply matches nothing. |  |

### Return type

[**Vec<models::DataMigrationRunSummary>**](DataMigrationRunSummary.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## data_migration_run

> models::QueuedDataMigrationRun data_migration_run(workspace, data_migration_request)
queue a source->target data migration

Pushes the migration onto the job queue and returns the job id immediately (#1212). It does **not** wait for the copy: the run's progress, logs, result and cancel control are reached through the ordinary job endpoints under that id -- `/jobs_u/get/{id}`, `/jobs/get_progress/{id}` (a `progress_perc` percentage, updated after each committed batch), `/jobs_u/queue/cancel/{id}` and the job SSE stream.  **Cancelling is not a rollback.** The engine has no cross-batch transaction and no checkpoint (#1216), so cancelling an in-flight run stops it at the next batch boundary and **leaves every batch that already committed in the target**. The job's error message names how many rows were written. A client must not present this operation as atomic.  The dry-run operation stays synchronous -- it is bounded by a sample row limit and is what an interactive mapping UI calls. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**data_migration_request** | [**DataMigrationRequest**](DataMigrationRequest.md) | source/target resources, tables, and column mapping to migrate | [required] |

### Return type

[**models::QueuedDataMigrationRun**](QueuedDataMigrationRun.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## delete_data_migration_by_path

> String delete_data_migration_by_path(workspace, path)
delete a data-migration definition

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## exists_data_migration_by_path

> bool exists_data_migration_by_path(workspace, path)
does a data-migration definition exist at this path

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |

### Return type

**bool**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## get_data_migration_by_path

> models::DataMigrationDefinition get_data_migration_by_path(workspace, path)
get a data-migration definition by path

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |

### Return type

[**models::DataMigrationDefinition**](DataMigrationDefinition.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## list_data_migrations

> Vec<models::ListableDataMigration> list_data_migrations(workspace, page, per_page, order_desc, path_start, path_exact, show_archived, label, edited_by, without_description)
list saved data-migration definitions

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**page** | Option<**i32**> | which page to return (start at 1, default 1) |  |
**per_page** | Option<**i32**> | number of items to return for a given page (default 30, max 100) |  |
**order_desc** | Option<**bool**> | order by desc order (default true) |  |
**path_start** | Option<**String**> | mask to filter matching starting path |  |
**path_exact** | Option<**String**> | mask to filter exact matching path |  |
**show_archived** | Option<**bool**> |  |  |
**label** | Option<**String**> | Filter by label |  |
**edited_by** | Option<**String**> | Filter by the user who last edited the definition |  |
**without_description** | Option<**bool**> | Return NULL for description to reduce payload size |  |

### Return type

[**Vec<models::ListableDataMigration>**](ListableDataMigration.md)

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json, text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## update_data_migration

> String update_data_migration(workspace, path, new_data_migration)
update a data-migration definition

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**workspace** | **String** |  | [required] |
**path** | **String** |  | [required] |
**new_data_migration** | [**NewDataMigration**](NewDataMigration.md) | data-migration definition to update | [required] |

### Return type

**String**

### Authorization

[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: text/plain

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)