{ "opencollection": "1.0.0", "info": { "name": "OpenMetadata APIs Agent Executions Database Services API", "version": "1.13" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Database Services", "type": "folder" }, "items": [ { "info": { "name": "Add a follower", "type": "http" }, "http": { "method": "PUT", "url": "/api/v1/services/databaseServices/:id/followers", "params": [ { "name": "id", "value": "", "type": "path", "description": "Id of the Database Service" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Add a user identified by `userId` as followed of this database service" }, { "info": { "name": "Add test connection result", "type": "http" }, "http": { "method": "PUT", "url": "/api/v1/services/databaseServices/:id/testConnectionResult", "params": [ { "name": "id", "value": "", "type": "path", "description": "Id of the service" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Add test connection result to the service." }, { "info": { "name": "List database services", "type": "http" }, "http": { "method": "GET", "url": "/api/v1/services/databaseServices", "params": [ { "name": "fields", "value": "", "type": "query", "description": "Fields requested in the returned resource" }, { "name": "domain", "value": "", "type": "query", "description": "Filter services by domain" }, { "name": "limit", "value": "", "type": "query" }, { "name": "before", "value": "", "type": "query", "description": "Returns list of database services before this cursor" }, { "name": "after", "value": "", "type": "query", "description": "Returns list of database services after this cursor" }, { "name": "include", "value": "", "type": "query", "description": "Include all, deleted, or non-deleted entities." } ] }, "docs": "Get a list of database services." }, { "info": { "name": "Create database service", "type": "http" }, "http": { "method": "POST", "url": "/api/v1/services/databaseServices", "body": { "type": "json", "data": "{}" } }, "docs": "Create a new database service." }, { "info": { "name": "Update database service", "type": "http" }, "http": { "method": "PUT", "url": "/api/v1/services/databaseServices", "body": { "type": "json", "data": "{}" } }, "docs": "Update an existing or create a new database service." }, { "info": { "name": "Get database service by name", "type": "http" }, "http": { "method": "GET", "url": "/api/v1/services/databaseServices/name/:name", "params": [ { "name": "name", "value": "", "type": "path", "description": "Name of the database service" }, { "name": "fields", "value": "", "type": "query", "description": "Fields requested in the returned resource" }, { "name": "include", "value": "", "type": "query", "description": "Include all, deleted, or non-deleted entities." }, { "name": "includeRelations", "value": "", "type": "query", "description": "Per-relation include control. Format: field:value,field2:value2. Example: owners:non-deleted,followers:all. Valid values: all, deleted, non-deleted. If not specified for a field, uses the entity's include value." } ] }, "docs": "Get a database service by the service `name`." }, { "info": { "name": "Delete a database service by name", "type": "http" }, "http": { "method": "DELETE", "url": "/api/v1/services/databaseServices/name/:name", "params": [ { "name": "hardDelete", "value": "", "type": "query", "description": "Hard delete the entity. (Default = `false`)" }, { "name": "recursive", "value": "", "type": "query", "description": "Recursively delete this entity and it's children. (Default `false`)" }, { "name": "name", "value": "", "type": "path", "description": "Name of the database service" } ] }, "docs": "Delete a database services by `name`. If databases (and tables) belong the service, it can't be deleted." }, { "info": { "name": "Get a database service", "type": "http" }, "http": { "method": "GET", "url": "/api/v1/services/databaseServices/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "Id of the database service" }, { "name": "fields", "value": "", "type": "query", "description": "Fields requested in the returned resource" }, { "name": "include", "value": "", "type": "query", "description": "Include all, deleted, or non-deleted entities." }, { "name": "includeRelations", "value": "", "type": "query", "description": "Per-relation include control. Format: field:value,field2:value2. Example: owners:non-deleted,followers:all. Valid values: all, deleted, non-deleted. If not specified for a field, uses the entity's include value." } ] }, "docs": "Get a database service by `Id`." }, { "info": { "name": "Update a database service", "type": "http" }, "http": { "method": "PATCH", "url": "/api/v1/services/databaseServices/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "Id of the database service" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update an existing database service using JsonPatch." }, { "info": { "name": "Delete a database service by Id", "type": "http" }, "http": { "method": "DELETE", "url": "/api/v1/services/databaseServices/:id", "params": [ { "name": "recursive", "value": "", "type": "query", "description": "Recursively delete this entity and it's children. (Default `false`)" }, { "name": "hardDelete", "value": "", "type": "query", "description": "Hard delete the entity. (Default = `false`)" }, { "name": "id", "value": "", "type": "path", "description": "Id of the database service" } ] }, "docs": "Delete a database services. If databases (and tables) belong the service, it can't be deleted." }, { "info": { "name": "Asynchronously delete a database service by Id", "type": "http" }, "http": { "method": "DELETE", "url": "/api/v1/services/databaseServices/async/:id", "params": [ { "name": "recursive", "value": "", "type": "query", "description": "Recursively delete this entity and it's children. (Default `false`)" }, { "name": "hardDelete", "value": "", "type": "query", "description": "Hard delete the entity. (Default = `false`)" }, { "name": "id", "value": "", "type": "path", "description": "Id of the database service" } ] }, "docs": "Asynchronously delete a database services. If databases (and tables) belong the service, it can't be deleted." }, { "info": { "name": "Remove a follower", "type": "http" }, "http": { "method": "DELETE", "url": "/api/v1/services/databaseServices/:id/followers/:userId", "params": [ { "name": "id", "value": "", "type": "path", "description": "Id of the Entity" }, { "name": "userId", "value": "", "type": "path", "description": "Id of the user being removed as follower" } ] }, "docs": "Remove the user identified `userId` as a follower of the entity." }, { "info": { "name": "Export database service in CSV format", "type": "http" }, "http": { "method": "GET", "url": "/api/v1/services/databaseServices/name/:name/export", "params": [ { "name": "name", "value": "", "type": "path", "description": "Name of the Database Service" }, { "name": "recursive", "value": "", "type": "query", "description": "If true, export will include child entities (schemas, tables, columns)" } ] }, "docs": "Export database service in CSV format" }, { "info": { "name": "Export database service in CSV format", "type": "http" }, "http": { "method": "GET", "url": "/api/v1/services/databaseServices/name/:name/exportAsync", "params": [ { "name": "name", "value": "", "type": "path", "description": "Name of the Database" }, { "name": "recursive", "value": "", "type": "query", "description": "If true, export will include child entities (schemas, tables, columns)" } ] }, "docs": "Export database service in CSV format" }, { "info": { "name": "Get a version of the database service", "type": "http" }, "http": { "method": "GET", "url": "/api/v1/services/databaseServices/:id/versions/:version", "params": [ { "name": "id", "value": "", "type": "path", "description": "Id of the database service" }, { "name": "version", "value": "", "type": "path", "description": "database service version number in the form `major`.`minor`" } ] }, "docs": "Get a version of the database service by given `Id`" }, { "info": { "name": "Import service from CSV to update database service (no creation allowed)", "type": "http" }, "http": { "method": "PUT", "url": "/api/v1/services/databaseServices/name/:name/import", "params": [ { "name": "name", "value": "", "type": "path", "description": "Name of the Database Service" }, { "name": "dryRun", "value": "", "type": "query", "description": "Dry-run when true is used for validating the CSV without really importing it. (default=true)" }, { "name": "recursive", "value": "", "type": "query", "description": "If true, recursive import" } ] }, "docs": "Import service from CSV to update database service (no creation allowed)" }, { "info": { "name": "Import service from CSV to update database service asynchronously (no creation allowed)", "type": "http" }, "http": { "method": "PUT", "url": "/api/v1/services/databaseServices/name/:name/importAsync", "params": [ { "name": "name", "value": "", "type": "path", "description": "Name of the Database Service" }, { "name": "dryRun", "value": "", "type": "query", "description": "Dry-run when true is used for validating the CSV without really importing it. (default=true)" }, { "name": "recursive", "value": "", "type": "query", "description": "If true, recursive import" } ] }, "docs": "Import service from CSV to update database service asynchronously (no creation allowed)" }, { "info": { "name": "List all entity versions within a time range", "type": "http" }, "http": { "method": "GET", "url": "/api/v1/services/databaseServices/history", "params": [ { "name": "startTs", "value": "", "type": "query", "description": "Start timestamp in milliseconds since epoch" }, { "name": "endTs", "value": "", "type": "query", "description": "End timestamp in milliseconds since epoch" }, { "name": "limit", "value": "", "type": "query", "description": "Limit the number of entity returned (1 to 1000000, default = 10)" }, { "name": "before", "value": "", "type": "query", "description": "Returns list of entity versions before this cursor" }, { "name": "after", "value": "", "type": "query", "description": "Returns list of entity versions after this cursor" } ] }, "docs": "Get a paginated list of all entity versions within a given time range specified by `startTs` and `endTs` in milliseconds since epoch. " }, { "info": { "name": "List database service versions", "type": "http" }, "http": { "method": "GET", "url": "/api/v1/services/databaseServices/:id/versions", "params": [ { "name": "id", "value": "", "type": "path", "description": "Id of the database service" } ] }, "docs": "Get a list of all the versions of a database service identified by `Id`" }, { "info": { "name": "Update a database service using name.", "type": "http" }, "http": { "method": "PATCH", "url": "/api/v1/services/databaseServices/name/:fqn", "params": [ { "name": "fqn", "value": "", "type": "path", "description": "Name of the database service" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update an existing database service using JsonPatch." }, { "info": { "name": "Restore a soft deleted database service", "type": "http" }, "http": { "method": "PUT", "url": "/api/v1/services/databaseServices/restore", "body": { "type": "json", "data": "{}" } }, "docs": "Restore a soft deleted database service." } ] } ], "bundled": true }