github.com/treeverse/lakefs@v1.24.1-0.20240520134607-95648127bfb0/clients/python-legacy/README.md (about) 1 # lakefs-client 2 lakeFS HTTP API 3 4 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project: 5 6 - API version: 1.0.0 7 - Package version: 0.1.0-SNAPSHOT 8 - Build package: org.openapitools.codegen.languages.PythonClientCodegen 9 10 ## Requirements. 11 12 Python >= 3.6 13 14 ## Installation & Usage 15 ### pip install 16 17 If the python package is hosted on a repository, you can install directly using: 18 19 ```sh 20 pip install git+https://github.com/treeverse/lakeFS.git 21 ``` 22 (you may need to run `pip` with root permission: `sudo pip install git+https://github.com/treeverse/lakeFS.git`) 23 24 Then import the package: 25 ```python 26 import lakefs_client 27 ``` 28 29 ### Setuptools 30 31 Install via [Setuptools](http://pypi.python.org/pypi/setuptools). 32 33 ```sh 34 python setup.py install --user 35 ``` 36 (or `sudo python setup.py install` to install the package for all users) 37 38 Then import the package: 39 ```python 40 import lakefs_client 41 ``` 42 43 ## Getting Started 44 45 Please follow the [installation procedure](#installation--usage) and then run the following: 46 47 ```python 48 49 import time 50 import lakefs_client 51 from pprint import pprint 52 from lakefs_client.api import actions_api 53 from lakefs_client.model.action_run import ActionRun 54 from lakefs_client.model.action_run_list import ActionRunList 55 from lakefs_client.model.error import Error 56 from lakefs_client.model.hook_run_list import HookRunList 57 # Defining the host is optional and defaults to http://localhost/api/v1 58 # See configuration.py for a list of all supported configuration parameters. 59 configuration = lakefs_client.Configuration( 60 host = "http://localhost/api/v1" 61 ) 62 63 # The client must configure the authentication and authorization parameters 64 # in accordance with the API server security policy. 65 # Examples for each auth method are provided below, use the example that 66 # satisfies your auth use case. 67 68 # Configure HTTP basic authorization: basic_auth 69 configuration = lakefs_client.Configuration( 70 username = 'YOUR_USERNAME', 71 password = 'YOUR_PASSWORD' 72 ) 73 74 # Configure API key authorization: cookie_auth 75 configuration.api_key['cookie_auth'] = 'YOUR_API_KEY' 76 77 # Uncomment below to setup prefix (e.g. Bearer) for API key, if needed 78 # configuration.api_key_prefix['cookie_auth'] = 'Bearer' 79 80 # Configure Bearer authorization (JWT): jwt_token 81 configuration = lakefs_client.Configuration( 82 access_token = 'YOUR_BEARER_TOKEN' 83 ) 84 85 # Configure API key authorization: oidc_auth 86 configuration.api_key['oidc_auth'] = 'YOUR_API_KEY' 87 88 # Uncomment below to setup prefix (e.g. Bearer) for API key, if needed 89 # configuration.api_key_prefix['oidc_auth'] = 'Bearer' 90 91 # Configure API key authorization: saml_auth 92 configuration.api_key['saml_auth'] = 'YOUR_API_KEY' 93 94 # Uncomment below to setup prefix (e.g. Bearer) for API key, if needed 95 # configuration.api_key_prefix['saml_auth'] = 'Bearer' 96 97 98 # Enter a context with an instance of the API client 99 with lakefs_client.ApiClient(configuration) as api_client: 100 # Create an instance of the API class 101 api_instance = actions_api.ActionsApi(api_client) 102 repository = "repository_example" # str | 103 run_id = "run_id_example" # str | 104 105 try: 106 # get a run 107 api_response = api_instance.get_run(repository, run_id) 108 pprint(api_response) 109 except lakefs_client.ApiException as e: 110 print("Exception when calling ActionsApi->get_run: %s\n" % e) 111 ``` 112 113 ## Documentation for API Endpoints 114 115 All URIs are relative to *http://localhost/api/v1* 116 117 Class | Method | HTTP request | Description 118 ------------ | ------------- | ------------- | ------------- 119 *ActionsApi* | [**get_run**](docs/ActionsApi.md#get_run) | **GET** /repositories/{repository}/actions/runs/{run_id} | get a run 120 *ActionsApi* | [**get_run_hook_output**](docs/ActionsApi.md#get_run_hook_output) | **GET** /repositories/{repository}/actions/runs/{run_id}/hooks/{hook_run_id}/output | get run hook output 121 *ActionsApi* | [**list_repository_runs**](docs/ActionsApi.md#list_repository_runs) | **GET** /repositories/{repository}/actions/runs | list runs 122 *ActionsApi* | [**list_run_hooks**](docs/ActionsApi.md#list_run_hooks) | **GET** /repositories/{repository}/actions/runs/{run_id}/hooks | list run hooks 123 *AuthApi* | [**add_group_membership**](docs/AuthApi.md#add_group_membership) | **PUT** /auth/groups/{groupId}/members/{userId} | add group membership 124 *AuthApi* | [**attach_policy_to_group**](docs/AuthApi.md#attach_policy_to_group) | **PUT** /auth/groups/{groupId}/policies/{policyId} | attach policy to group 125 *AuthApi* | [**attach_policy_to_user**](docs/AuthApi.md#attach_policy_to_user) | **PUT** /auth/users/{userId}/policies/{policyId} | attach policy to user 126 *AuthApi* | [**create_credentials**](docs/AuthApi.md#create_credentials) | **POST** /auth/users/{userId}/credentials | create credentials 127 *AuthApi* | [**create_group**](docs/AuthApi.md#create_group) | **POST** /auth/groups | create group 128 *AuthApi* | [**create_policy**](docs/AuthApi.md#create_policy) | **POST** /auth/policies | create policy 129 *AuthApi* | [**create_user**](docs/AuthApi.md#create_user) | **POST** /auth/users | create user 130 *AuthApi* | [**create_user_external_principal**](docs/AuthApi.md#create_user_external_principal) | **POST** /auth/users/{userId}/external/principals | attach external principal to user 131 *AuthApi* | [**delete_credentials**](docs/AuthApi.md#delete_credentials) | **DELETE** /auth/users/{userId}/credentials/{accessKeyId} | delete credentials 132 *AuthApi* | [**delete_group**](docs/AuthApi.md#delete_group) | **DELETE** /auth/groups/{groupId} | delete group 133 *AuthApi* | [**delete_group_membership**](docs/AuthApi.md#delete_group_membership) | **DELETE** /auth/groups/{groupId}/members/{userId} | delete group membership 134 *AuthApi* | [**delete_policy**](docs/AuthApi.md#delete_policy) | **DELETE** /auth/policies/{policyId} | delete policy 135 *AuthApi* | [**delete_user**](docs/AuthApi.md#delete_user) | **DELETE** /auth/users/{userId} | delete user 136 *AuthApi* | [**delete_user_external_principal**](docs/AuthApi.md#delete_user_external_principal) | **DELETE** /auth/users/{userId}/external/principals | delete external principal from user 137 *AuthApi* | [**detach_policy_from_group**](docs/AuthApi.md#detach_policy_from_group) | **DELETE** /auth/groups/{groupId}/policies/{policyId} | detach policy from group 138 *AuthApi* | [**detach_policy_from_user**](docs/AuthApi.md#detach_policy_from_user) | **DELETE** /auth/users/{userId}/policies/{policyId} | detach policy from user 139 *AuthApi* | [**external_principal_login**](docs/AuthApi.md#external_principal_login) | **POST** /auth/external/principal/login | perform a login using an external authenticator 140 *AuthApi* | [**get_credentials**](docs/AuthApi.md#get_credentials) | **GET** /auth/users/{userId}/credentials/{accessKeyId} | get credentials 141 *AuthApi* | [**get_current_user**](docs/AuthApi.md#get_current_user) | **GET** /user | get current user 142 *AuthApi* | [**get_external_principal**](docs/AuthApi.md#get_external_principal) | **GET** /auth/external/principals | describe external principal by id 143 *AuthApi* | [**get_group**](docs/AuthApi.md#get_group) | **GET** /auth/groups/{groupId} | get group 144 *AuthApi* | [**get_group_acl**](docs/AuthApi.md#get_group_acl) | **GET** /auth/groups/{groupId}/acl | get ACL of group 145 *AuthApi* | [**get_policy**](docs/AuthApi.md#get_policy) | **GET** /auth/policies/{policyId} | get policy 146 *AuthApi* | [**get_user**](docs/AuthApi.md#get_user) | **GET** /auth/users/{userId} | get user 147 *AuthApi* | [**list_group_members**](docs/AuthApi.md#list_group_members) | **GET** /auth/groups/{groupId}/members | list group members 148 *AuthApi* | [**list_group_policies**](docs/AuthApi.md#list_group_policies) | **GET** /auth/groups/{groupId}/policies | list group policies 149 *AuthApi* | [**list_groups**](docs/AuthApi.md#list_groups) | **GET** /auth/groups | list groups 150 *AuthApi* | [**list_policies**](docs/AuthApi.md#list_policies) | **GET** /auth/policies | list policies 151 *AuthApi* | [**list_user_credentials**](docs/AuthApi.md#list_user_credentials) | **GET** /auth/users/{userId}/credentials | list user credentials 152 *AuthApi* | [**list_user_external_principals**](docs/AuthApi.md#list_user_external_principals) | **GET** /auth/users/{userId}/external/principals/ls | list user external policies attached to a user 153 *AuthApi* | [**list_user_groups**](docs/AuthApi.md#list_user_groups) | **GET** /auth/users/{userId}/groups | list user groups 154 *AuthApi* | [**list_user_policies**](docs/AuthApi.md#list_user_policies) | **GET** /auth/users/{userId}/policies | list user policies 155 *AuthApi* | [**list_users**](docs/AuthApi.md#list_users) | **GET** /auth/users | list users 156 *AuthApi* | [**login**](docs/AuthApi.md#login) | **POST** /auth/login | perform a login 157 *AuthApi* | [**set_group_acl**](docs/AuthApi.md#set_group_acl) | **POST** /auth/groups/{groupId}/acl | set ACL of group 158 *AuthApi* | [**update_policy**](docs/AuthApi.md#update_policy) | **PUT** /auth/policies/{policyId} | update policy 159 *BranchesApi* | [**cherry_pick**](docs/BranchesApi.md#cherry_pick) | **POST** /repositories/{repository}/branches/{branch}/cherry-pick | Replay the changes from the given commit on the branch 160 *BranchesApi* | [**create_branch**](docs/BranchesApi.md#create_branch) | **POST** /repositories/{repository}/branches | create branch 161 *BranchesApi* | [**delete_branch**](docs/BranchesApi.md#delete_branch) | **DELETE** /repositories/{repository}/branches/{branch} | delete branch 162 *BranchesApi* | [**diff_branch**](docs/BranchesApi.md#diff_branch) | **GET** /repositories/{repository}/branches/{branch}/diff | diff branch 163 *BranchesApi* | [**get_branch**](docs/BranchesApi.md#get_branch) | **GET** /repositories/{repository}/branches/{branch} | get branch 164 *BranchesApi* | [**list_branches**](docs/BranchesApi.md#list_branches) | **GET** /repositories/{repository}/branches | list branches 165 *BranchesApi* | [**reset_branch**](docs/BranchesApi.md#reset_branch) | **PUT** /repositories/{repository}/branches/{branch} | reset branch 166 *BranchesApi* | [**revert_branch**](docs/BranchesApi.md#revert_branch) | **POST** /repositories/{repository}/branches/{branch}/revert | revert 167 *CommitsApi* | [**commit**](docs/CommitsApi.md#commit) | **POST** /repositories/{repository}/branches/{branch}/commits | create commit 168 *CommitsApi* | [**get_commit**](docs/CommitsApi.md#get_commit) | **GET** /repositories/{repository}/commits/{commitId} | get commit 169 *ConfigApi* | [**get_config**](docs/ConfigApi.md#get_config) | **GET** /config | 170 *ExperimentalApi* | [**abort_presign_multipart_upload**](docs/ExperimentalApi.md#abort_presign_multipart_upload) | **DELETE** /repositories/{repository}/branches/{branch}/staging/pmpu/{uploadId} | Abort a presign multipart upload 171 *ExperimentalApi* | [**complete_presign_multipart_upload**](docs/ExperimentalApi.md#complete_presign_multipart_upload) | **PUT** /repositories/{repository}/branches/{branch}/staging/pmpu/{uploadId} | Complete a presign multipart upload request 172 *ExperimentalApi* | [**create_presign_multipart_upload**](docs/ExperimentalApi.md#create_presign_multipart_upload) | **POST** /repositories/{repository}/branches/{branch}/staging/pmpu | Initiate a multipart upload 173 *ExperimentalApi* | [**create_user_external_principal**](docs/ExperimentalApi.md#create_user_external_principal) | **POST** /auth/users/{userId}/external/principals | attach external principal to user 174 *ExperimentalApi* | [**delete_user_external_principal**](docs/ExperimentalApi.md#delete_user_external_principal) | **DELETE** /auth/users/{userId}/external/principals | delete external principal from user 175 *ExperimentalApi* | [**external_principal_login**](docs/ExperimentalApi.md#external_principal_login) | **POST** /auth/external/principal/login | perform a login using an external authenticator 176 *ExperimentalApi* | [**get_external_principal**](docs/ExperimentalApi.md#get_external_principal) | **GET** /auth/external/principals | describe external principal by id 177 *ExperimentalApi* | [**hard_reset_branch**](docs/ExperimentalApi.md#hard_reset_branch) | **PUT** /repositories/{repository}/branches/{branch}/hard_reset | hard reset branch 178 *ExperimentalApi* | [**list_user_external_principals**](docs/ExperimentalApi.md#list_user_external_principals) | **GET** /auth/users/{userId}/external/principals/ls | list user external policies attached to a user 179 *ExperimentalApi* | [**sts_login**](docs/ExperimentalApi.md#sts_login) | **POST** /sts/login | perform a login with STS 180 *ExternalApi* | [**create_user_external_principal**](docs/ExternalApi.md#create_user_external_principal) | **POST** /auth/users/{userId}/external/principals | attach external principal to user 181 *ExternalApi* | [**delete_user_external_principal**](docs/ExternalApi.md#delete_user_external_principal) | **DELETE** /auth/users/{userId}/external/principals | delete external principal from user 182 *ExternalApi* | [**external_principal_login**](docs/ExternalApi.md#external_principal_login) | **POST** /auth/external/principal/login | perform a login using an external authenticator 183 *ExternalApi* | [**get_external_principal**](docs/ExternalApi.md#get_external_principal) | **GET** /auth/external/principals | describe external principal by id 184 *ExternalApi* | [**list_user_external_principals**](docs/ExternalApi.md#list_user_external_principals) | **GET** /auth/users/{userId}/external/principals/ls | list user external policies attached to a user 185 *HealthCheckApi* | [**health_check**](docs/HealthCheckApi.md#health_check) | **GET** /healthcheck | 186 *ImportApi* | [**import_cancel**](docs/ImportApi.md#import_cancel) | **DELETE** /repositories/{repository}/branches/{branch}/import | cancel ongoing import 187 *ImportApi* | [**import_start**](docs/ImportApi.md#import_start) | **POST** /repositories/{repository}/branches/{branch}/import | import data from object store 188 *ImportApi* | [**import_status**](docs/ImportApi.md#import_status) | **GET** /repositories/{repository}/branches/{branch}/import | get import status 189 *InternalApi* | [**create_branch_protection_rule_preflight**](docs/InternalApi.md#create_branch_protection_rule_preflight) | **GET** /repositories/{repository}/branch_protection/set_allowed | 190 *InternalApi* | [**create_commit_record**](docs/InternalApi.md#create_commit_record) | **POST** /repositories/{repository}/commits | create commit record 191 *InternalApi* | [**create_symlink_file**](docs/InternalApi.md#create_symlink_file) | **POST** /repositories/{repository}/refs/{branch}/symlink | creates symlink files corresponding to the given directory 192 *InternalApi* | [**delete_repository_metadata**](docs/InternalApi.md#delete_repository_metadata) | **DELETE** /repositories/{repository}/metadata | delete repository metadata 193 *InternalApi* | [**dump_refs**](docs/InternalApi.md#dump_refs) | **PUT** /repositories/{repository}/refs/dump | Dump repository refs (tags, commits, branches) to object store Deprecated: a new API will introduce long running operations 194 *InternalApi* | [**get_auth_capabilities**](docs/InternalApi.md#get_auth_capabilities) | **GET** /auth/capabilities | list authentication capabilities supported 195 *InternalApi* | [**get_garbage_collection_config**](docs/InternalApi.md#get_garbage_collection_config) | **GET** /config/garbage-collection | 196 *InternalApi* | [**get_lake_fs_version**](docs/InternalApi.md#get_lake_fs_version) | **GET** /config/version | 197 *InternalApi* | [**get_setup_state**](docs/InternalApi.md#get_setup_state) | **GET** /setup_lakefs | check if the lakeFS installation is already set up 198 *InternalApi* | [**get_storage_config**](docs/InternalApi.md#get_storage_config) | **GET** /config/storage | 199 *InternalApi* | [**get_usage_report_summary**](docs/InternalApi.md#get_usage_report_summary) | **GET** /usage-report/summary | get usage report summary 200 *InternalApi* | [**internal_create_branch_protection_rule**](docs/InternalApi.md#internal_create_branch_protection_rule) | **POST** /repositories/{repository}/branch_protection | 201 *InternalApi* | [**internal_delete_branch_protection_rule**](docs/InternalApi.md#internal_delete_branch_protection_rule) | **DELETE** /repositories/{repository}/branch_protection | 202 *InternalApi* | [**internal_delete_garbage_collection_rules**](docs/InternalApi.md#internal_delete_garbage_collection_rules) | **DELETE** /repositories/{repository}/gc/rules | 203 *InternalApi* | [**internal_get_branch_protection_rules**](docs/InternalApi.md#internal_get_branch_protection_rules) | **GET** /repositories/{repository}/branch_protection | get branch protection rules 204 *InternalApi* | [**internal_get_garbage_collection_rules**](docs/InternalApi.md#internal_get_garbage_collection_rules) | **GET** /repositories/{repository}/gc/rules | 205 *InternalApi* | [**internal_set_garbage_collection_rules**](docs/InternalApi.md#internal_set_garbage_collection_rules) | **POST** /repositories/{repository}/gc/rules | 206 *InternalApi* | [**post_stats_events**](docs/InternalApi.md#post_stats_events) | **POST** /statistics | post stats events, this endpoint is meant for internal use only 207 *InternalApi* | [**prepare_garbage_collection_commits**](docs/InternalApi.md#prepare_garbage_collection_commits) | **POST** /repositories/{repository}/gc/prepare_commits | save lists of active commits for garbage collection 208 *InternalApi* | [**prepare_garbage_collection_uncommitted**](docs/InternalApi.md#prepare_garbage_collection_uncommitted) | **POST** /repositories/{repository}/gc/prepare_uncommited | save repository uncommitted metadata for garbage collection 209 *InternalApi* | [**restore_refs**](docs/InternalApi.md#restore_refs) | **PUT** /repositories/{repository}/refs/restore | Restore repository refs (tags, commits, branches) from object store. Deprecated: a new API will introduce long running operations 210 *InternalApi* | [**set_garbage_collection_rules_preflight**](docs/InternalApi.md#set_garbage_collection_rules_preflight) | **GET** /repositories/{repository}/gc/rules/set_allowed | 211 *InternalApi* | [**set_repository_metadata**](docs/InternalApi.md#set_repository_metadata) | **POST** /repositories/{repository}/metadata | set repository metadata 212 *InternalApi* | [**setup**](docs/InternalApi.md#setup) | **POST** /setup_lakefs | setup lakeFS and create a first user 213 *InternalApi* | [**setup_comm_prefs**](docs/InternalApi.md#setup_comm_prefs) | **POST** /setup_comm_prefs | setup communications preferences 214 *InternalApi* | [**stage_object**](docs/InternalApi.md#stage_object) | **PUT** /repositories/{repository}/branches/{branch}/objects | stage an object's metadata for the given branch 215 *InternalApi* | [**upload_object_preflight**](docs/InternalApi.md#upload_object_preflight) | **GET** /repositories/{repository}/branches/{branch}/objects/stage_allowed | 216 *MetadataApi* | [**get_meta_range**](docs/MetadataApi.md#get_meta_range) | **GET** /repositories/{repository}/metadata/meta_range/{meta_range} | return URI to a meta-range file 217 *MetadataApi* | [**get_range**](docs/MetadataApi.md#get_range) | **GET** /repositories/{repository}/metadata/range/{range} | return URI to a range file 218 *ObjectsApi* | [**copy_object**](docs/ObjectsApi.md#copy_object) | **POST** /repositories/{repository}/branches/{branch}/objects/copy | create a copy of an object 219 *ObjectsApi* | [**delete_object**](docs/ObjectsApi.md#delete_object) | **DELETE** /repositories/{repository}/branches/{branch}/objects | delete object. Missing objects will not return a NotFound error. 220 *ObjectsApi* | [**delete_objects**](docs/ObjectsApi.md#delete_objects) | **POST** /repositories/{repository}/branches/{branch}/objects/delete | delete objects. Missing objects will not return a NotFound error. 221 *ObjectsApi* | [**get_object**](docs/ObjectsApi.md#get_object) | **GET** /repositories/{repository}/refs/{ref}/objects | get object content 222 *ObjectsApi* | [**get_underlying_properties**](docs/ObjectsApi.md#get_underlying_properties) | **GET** /repositories/{repository}/refs/{ref}/objects/underlyingProperties | get object properties on underlying storage 223 *ObjectsApi* | [**head_object**](docs/ObjectsApi.md#head_object) | **HEAD** /repositories/{repository}/refs/{ref}/objects | check if object exists 224 *ObjectsApi* | [**list_objects**](docs/ObjectsApi.md#list_objects) | **GET** /repositories/{repository}/refs/{ref}/objects/ls | list objects under a given prefix 225 *ObjectsApi* | [**stat_object**](docs/ObjectsApi.md#stat_object) | **GET** /repositories/{repository}/refs/{ref}/objects/stat | get object metadata 226 *ObjectsApi* | [**upload_object**](docs/ObjectsApi.md#upload_object) | **POST** /repositories/{repository}/branches/{branch}/objects | 227 *RefsApi* | [**diff_refs**](docs/RefsApi.md#diff_refs) | **GET** /repositories/{repository}/refs/{leftRef}/diff/{rightRef} | diff references 228 *RefsApi* | [**find_merge_base**](docs/RefsApi.md#find_merge_base) | **GET** /repositories/{repository}/refs/{sourceRef}/merge/{destinationBranch} | find the merge base for 2 references 229 *RefsApi* | [**log_commits**](docs/RefsApi.md#log_commits) | **GET** /repositories/{repository}/refs/{ref}/commits | get commit log from ref. If both objects and prefixes are empty, return all commits. 230 *RefsApi* | [**merge_into_branch**](docs/RefsApi.md#merge_into_branch) | **POST** /repositories/{repository}/refs/{sourceRef}/merge/{destinationBranch} | merge references 231 *RepositoriesApi* | [**create_repository**](docs/RepositoriesApi.md#create_repository) | **POST** /repositories | create repository 232 *RepositoriesApi* | [**delete_gc_rules**](docs/RepositoriesApi.md#delete_gc_rules) | **DELETE** /repositories/{repository}/settings/gc_rules | 233 *RepositoriesApi* | [**delete_repository**](docs/RepositoriesApi.md#delete_repository) | **DELETE** /repositories/{repository} | delete repository 234 *RepositoriesApi* | [**dump_status**](docs/RepositoriesApi.md#dump_status) | **GET** /repositories/{repository}/dump | Status of a repository dump task 235 *RepositoriesApi* | [**dump_submit**](docs/RepositoriesApi.md#dump_submit) | **POST** /repositories/{repository}/dump | Backup the repository metadata (tags, commits, branches) and save the backup to the object store. 236 *RepositoriesApi* | [**get_branch_protection_rules**](docs/RepositoriesApi.md#get_branch_protection_rules) | **GET** /repositories/{repository}/settings/branch_protection | get branch protection rules 237 *RepositoriesApi* | [**get_gc_rules**](docs/RepositoriesApi.md#get_gc_rules) | **GET** /repositories/{repository}/settings/gc_rules | get repository GC rules 238 *RepositoriesApi* | [**get_repository**](docs/RepositoriesApi.md#get_repository) | **GET** /repositories/{repository} | get repository 239 *RepositoriesApi* | [**get_repository_metadata**](docs/RepositoriesApi.md#get_repository_metadata) | **GET** /repositories/{repository}/metadata | get repository metadata 240 *RepositoriesApi* | [**list_repositories**](docs/RepositoriesApi.md#list_repositories) | **GET** /repositories | list repositories 241 *RepositoriesApi* | [**restore_status**](docs/RepositoriesApi.md#restore_status) | **GET** /repositories/{repository}/restore | Status of a restore request 242 *RepositoriesApi* | [**restore_submit**](docs/RepositoriesApi.md#restore_submit) | **POST** /repositories/{repository}/restore | Restore repository from a dump in the object store 243 *RepositoriesApi* | [**set_branch_protection_rules**](docs/RepositoriesApi.md#set_branch_protection_rules) | **PUT** /repositories/{repository}/settings/branch_protection | 244 *RepositoriesApi* | [**set_gc_rules**](docs/RepositoriesApi.md#set_gc_rules) | **PUT** /repositories/{repository}/settings/gc_rules | 245 *StagingApi* | [**get_physical_address**](docs/StagingApi.md#get_physical_address) | **GET** /repositories/{repository}/branches/{branch}/staging/backing | generate an address to which the client can upload an object 246 *StagingApi* | [**link_physical_address**](docs/StagingApi.md#link_physical_address) | **PUT** /repositories/{repository}/branches/{branch}/staging/backing | associate staging on this physical address with a path 247 *TagsApi* | [**create_tag**](docs/TagsApi.md#create_tag) | **POST** /repositories/{repository}/tags | create tag 248 *TagsApi* | [**delete_tag**](docs/TagsApi.md#delete_tag) | **DELETE** /repositories/{repository}/tags/{tag} | delete tag 249 *TagsApi* | [**get_tag**](docs/TagsApi.md#get_tag) | **GET** /repositories/{repository}/tags/{tag} | get tag 250 *TagsApi* | [**list_tags**](docs/TagsApi.md#list_tags) | **GET** /repositories/{repository}/tags | list tags 251 252 253 ## Documentation For Models 254 255 - [ACL](docs/ACL.md) 256 - [AbortPresignMultipartUpload](docs/AbortPresignMultipartUpload.md) 257 - [AccessKeyCredentials](docs/AccessKeyCredentials.md) 258 - [ActionRun](docs/ActionRun.md) 259 - [ActionRunList](docs/ActionRunList.md) 260 - [AuthCapabilities](docs/AuthCapabilities.md) 261 - [AuthenticationToken](docs/AuthenticationToken.md) 262 - [BranchCreation](docs/BranchCreation.md) 263 - [BranchProtectionRule](docs/BranchProtectionRule.md) 264 - [CherryPickCreation](docs/CherryPickCreation.md) 265 - [CommPrefsInput](docs/CommPrefsInput.md) 266 - [Commit](docs/Commit.md) 267 - [CommitCreation](docs/CommitCreation.md) 268 - [CommitList](docs/CommitList.md) 269 - [CommitRecordCreation](docs/CommitRecordCreation.md) 270 - [CompletePresignMultipartUpload](docs/CompletePresignMultipartUpload.md) 271 - [Config](docs/Config.md) 272 - [Credentials](docs/Credentials.md) 273 - [CredentialsList](docs/CredentialsList.md) 274 - [CredentialsWithSecret](docs/CredentialsWithSecret.md) 275 - [CurrentUser](docs/CurrentUser.md) 276 - [Diff](docs/Diff.md) 277 - [DiffList](docs/DiffList.md) 278 - [Error](docs/Error.md) 279 - [ErrorNoACL](docs/ErrorNoACL.md) 280 - [ExternalLoginInformation](docs/ExternalLoginInformation.md) 281 - [ExternalPrincipal](docs/ExternalPrincipal.md) 282 - [ExternalPrincipalCreation](docs/ExternalPrincipalCreation.md) 283 - [ExternalPrincipalList](docs/ExternalPrincipalList.md) 284 - [ExternalPrincipalSettings](docs/ExternalPrincipalSettings.md) 285 - [FindMergeBaseResult](docs/FindMergeBaseResult.md) 286 - [GarbageCollectionConfig](docs/GarbageCollectionConfig.md) 287 - [GarbageCollectionPrepareResponse](docs/GarbageCollectionPrepareResponse.md) 288 - [GarbageCollectionRule](docs/GarbageCollectionRule.md) 289 - [GarbageCollectionRules](docs/GarbageCollectionRules.md) 290 - [Group](docs/Group.md) 291 - [GroupCreation](docs/GroupCreation.md) 292 - [GroupList](docs/GroupList.md) 293 - [HookRun](docs/HookRun.md) 294 - [HookRunList](docs/HookRunList.md) 295 - [ImportCreation](docs/ImportCreation.md) 296 - [ImportCreationResponse](docs/ImportCreationResponse.md) 297 - [ImportLocation](docs/ImportLocation.md) 298 - [ImportStatus](docs/ImportStatus.md) 299 - [InlineObject](docs/InlineObject.md) 300 - [InlineObject1](docs/InlineObject1.md) 301 - [InstallationUsageReport](docs/InstallationUsageReport.md) 302 - [LoginConfig](docs/LoginConfig.md) 303 - [LoginInformation](docs/LoginInformation.md) 304 - [Merge](docs/Merge.md) 305 - [MergeResult](docs/MergeResult.md) 306 - [MetaRangeCreation](docs/MetaRangeCreation.md) 307 - [MetaRangeCreationResponse](docs/MetaRangeCreationResponse.md) 308 - [ObjectCopyCreation](docs/ObjectCopyCreation.md) 309 - [ObjectError](docs/ObjectError.md) 310 - [ObjectErrorList](docs/ObjectErrorList.md) 311 - [ObjectStageCreation](docs/ObjectStageCreation.md) 312 - [ObjectStats](docs/ObjectStats.md) 313 - [ObjectStatsList](docs/ObjectStatsList.md) 314 - [ObjectUserMetadata](docs/ObjectUserMetadata.md) 315 - [Pagination](docs/Pagination.md) 316 - [PathList](docs/PathList.md) 317 - [Policy](docs/Policy.md) 318 - [PolicyList](docs/PolicyList.md) 319 - [PrepareGCUncommittedRequest](docs/PrepareGCUncommittedRequest.md) 320 - [PrepareGCUncommittedResponse](docs/PrepareGCUncommittedResponse.md) 321 - [PresignMultipartUpload](docs/PresignMultipartUpload.md) 322 - [RangeMetadata](docs/RangeMetadata.md) 323 - [Ref](docs/Ref.md) 324 - [RefList](docs/RefList.md) 325 - [RefsDump](docs/RefsDump.md) 326 - [RefsRestore](docs/RefsRestore.md) 327 - [Repository](docs/Repository.md) 328 - [RepositoryCreation](docs/RepositoryCreation.md) 329 - [RepositoryDumpStatus](docs/RepositoryDumpStatus.md) 330 - [RepositoryList](docs/RepositoryList.md) 331 - [RepositoryMetadata](docs/RepositoryMetadata.md) 332 - [RepositoryMetadataKeys](docs/RepositoryMetadataKeys.md) 333 - [RepositoryMetadataSet](docs/RepositoryMetadataSet.md) 334 - [RepositoryRestoreStatus](docs/RepositoryRestoreStatus.md) 335 - [ResetCreation](docs/ResetCreation.md) 336 - [RevertCreation](docs/RevertCreation.md) 337 - [Setup](docs/Setup.md) 338 - [SetupState](docs/SetupState.md) 339 - [StagingLocation](docs/StagingLocation.md) 340 - [StagingMetadata](docs/StagingMetadata.md) 341 - [Statement](docs/Statement.md) 342 - [StatsEvent](docs/StatsEvent.md) 343 - [StatsEventsList](docs/StatsEventsList.md) 344 - [StorageConfig](docs/StorageConfig.md) 345 - [StorageURI](docs/StorageURI.md) 346 - [StsAuthRequest](docs/StsAuthRequest.md) 347 - [TagCreation](docs/TagCreation.md) 348 - [TaskInfo](docs/TaskInfo.md) 349 - [UnderlyingObjectProperties](docs/UnderlyingObjectProperties.md) 350 - [UpdateToken](docs/UpdateToken.md) 351 - [UploadPart](docs/UploadPart.md) 352 - [UsageReport](docs/UsageReport.md) 353 - [User](docs/User.md) 354 - [UserCreation](docs/UserCreation.md) 355 - [UserList](docs/UserList.md) 356 - [VersionConfig](docs/VersionConfig.md) 357 358 359 ## Documentation For Authorization 360 361 362 ## basic_auth 363 364 - **Type**: HTTP basic authentication 365 366 367 ## cookie_auth 368 369 - **Type**: API key 370 - **API key parameter name**: internal_auth_session 371 - **Location**: 372 373 374 ## jwt_token 375 376 - **Type**: Bearer authentication (JWT) 377 378 379 ## oidc_auth 380 381 - **Type**: API key 382 - **API key parameter name**: oidc_auth_session 383 - **Location**: 384 385 386 ## saml_auth 387 388 - **Type**: API key 389 - **API key parameter name**: saml_auth_session 390 - **Location**: 391 392 393 ## Author 394 395 services@treeverse.io 396 397 398 ## Notes for Large OpenAPI documents 399 If the OpenAPI document is large, imports in lakefs_client.apis and lakefs_client.models may fail with a 400 RecursionError indicating the maximum recursion limit has been exceeded. In that case, there are a couple of solutions: 401 402 Solution 1: 403 Use specific imports for apis and models like: 404 - `from lakefs_client.api.default_api import DefaultApi` 405 - `from lakefs_client.model.pet import Pet` 406 407 Solution 2: 408 Before importing the package, adjust the maximum recursion limit as shown below: 409 ``` 410 import sys 411 sys.setrecursionlimit(1500) 412 import lakefs_client 413 from lakefs_client.apis import * 414 from lakefs_client.models import * 415 ``` 416