github.com/treeverse/lakefs@v1.24.1-0.20240520134607-95648127bfb0/clients/java-legacy/README.md (about)

     1  # api-client
     2  
     3  lakeFS API
     4  - API version: 1.0.0
     5  
     6  lakeFS HTTP API
     7  
     8  
     9  *Automatically generated by the [OpenAPI Generator](https://openapi-generator.tech)*
    10  
    11  
    12  ## Requirements
    13  
    14  Building the API client library requires:
    15  1. Java 1.7+
    16  2. Maven/Gradle
    17  
    18  ## Installation
    19  
    20  To install the API client library to your local Maven repository, simply execute:
    21  
    22  ```shell
    23  mvn clean install
    24  ```
    25  
    26  To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:
    27  
    28  ```shell
    29  mvn clean deploy
    30  ```
    31  
    32  Refer to the [OSSRH Guide](http://central.sonatype.org/pages/ossrh-guide.html) for more information.
    33  
    34  ### Maven users
    35  
    36  Add this dependency to your project's POM:
    37  
    38  ```xml
    39  <dependency>
    40    <groupId>io.lakefs</groupId>
    41    <artifactId>api-client</artifactId>
    42    <version>0.1.0-SNAPSHOT</version>
    43    <scope>compile</scope>
    44  </dependency>
    45  ```
    46  
    47  ### Gradle users
    48  
    49  Add this dependency to your project's build file:
    50  
    51  ```groovy
    52  compile "io.lakefs:api-client:0.1.0-SNAPSHOT"
    53  ```
    54  
    55  ### Others
    56  
    57  At first generate the JAR by executing:
    58  
    59  ```shell
    60  mvn clean package
    61  ```
    62  
    63  Then manually install the following JARs:
    64  
    65  * `target/api-client-0.1.0-SNAPSHOT.jar`
    66  * `target/lib/*.jar`
    67  
    68  ## Getting Started
    69  
    70  Please follow the [installation](#installation) instruction and execute the following Java code:
    71  
    72  ```java
    73  
    74  // Import classes:
    75  import io.lakefs.clients.api.ApiClient;
    76  import io.lakefs.clients.api.ApiException;
    77  import io.lakefs.clients.api.Configuration;
    78  import io.lakefs.clients.api.auth.*;
    79  import io.lakefs.clients.api.models.*;
    80  import io.lakefs.clients.api.ActionsApi;
    81  
    82  public class Example {
    83    public static void main(String[] args) {
    84      ApiClient defaultClient = Configuration.getDefaultApiClient();
    85      defaultClient.setBasePath("http://localhost/api/v1");
    86      
    87      // Configure HTTP basic authorization: basic_auth
    88      HttpBasicAuth basic_auth = (HttpBasicAuth) defaultClient.getAuthentication("basic_auth");
    89      basic_auth.setUsername("YOUR USERNAME");
    90      basic_auth.setPassword("YOUR PASSWORD");
    91  
    92      // Configure API key authorization: cookie_auth
    93      ApiKeyAuth cookie_auth = (ApiKeyAuth) defaultClient.getAuthentication("cookie_auth");
    94      cookie_auth.setApiKey("YOUR API KEY");
    95      // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
    96      //cookie_auth.setApiKeyPrefix("Token");
    97  
    98      // Configure HTTP bearer authorization: jwt_token
    99      HttpBearerAuth jwt_token = (HttpBearerAuth) defaultClient.getAuthentication("jwt_token");
   100      jwt_token.setBearerToken("BEARER TOKEN");
   101  
   102      // Configure API key authorization: oidc_auth
   103      ApiKeyAuth oidc_auth = (ApiKeyAuth) defaultClient.getAuthentication("oidc_auth");
   104      oidc_auth.setApiKey("YOUR API KEY");
   105      // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
   106      //oidc_auth.setApiKeyPrefix("Token");
   107  
   108      // Configure API key authorization: saml_auth
   109      ApiKeyAuth saml_auth = (ApiKeyAuth) defaultClient.getAuthentication("saml_auth");
   110      saml_auth.setApiKey("YOUR API KEY");
   111      // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
   112      //saml_auth.setApiKeyPrefix("Token");
   113  
   114      ActionsApi apiInstance = new ActionsApi(defaultClient);
   115      String repository = "repository_example"; // String | 
   116      String runId = "runId_example"; // String | 
   117      try {
   118        ActionRun result = apiInstance.getRun(repository, runId);
   119        System.out.println(result);
   120      } catch (ApiException e) {
   121        System.err.println("Exception when calling ActionsApi#getRun");
   122        System.err.println("Status code: " + e.getCode());
   123        System.err.println("Reason: " + e.getResponseBody());
   124        System.err.println("Response headers: " + e.getResponseHeaders());
   125        e.printStackTrace();
   126      }
   127    }
   128  }
   129  
   130  ```
   131  
   132  ## Documentation for API Endpoints
   133  
   134  All URIs are relative to *http://localhost/api/v1*
   135  
   136  Class | Method | HTTP request | Description
   137  ------------ | ------------- | ------------- | -------------
   138  *ActionsApi* | [**getRun**](docs/ActionsApi.md#getRun) | **GET** /repositories/{repository}/actions/runs/{run_id} | get a run
   139  *ActionsApi* | [**getRunHookOutput**](docs/ActionsApi.md#getRunHookOutput) | **GET** /repositories/{repository}/actions/runs/{run_id}/hooks/{hook_run_id}/output | get run hook output
   140  *ActionsApi* | [**listRepositoryRuns**](docs/ActionsApi.md#listRepositoryRuns) | **GET** /repositories/{repository}/actions/runs | list runs
   141  *ActionsApi* | [**listRunHooks**](docs/ActionsApi.md#listRunHooks) | **GET** /repositories/{repository}/actions/runs/{run_id}/hooks | list run hooks
   142  *AuthApi* | [**addGroupMembership**](docs/AuthApi.md#addGroupMembership) | **PUT** /auth/groups/{groupId}/members/{userId} | add group membership
   143  *AuthApi* | [**attachPolicyToGroup**](docs/AuthApi.md#attachPolicyToGroup) | **PUT** /auth/groups/{groupId}/policies/{policyId} | attach policy to group
   144  *AuthApi* | [**attachPolicyToUser**](docs/AuthApi.md#attachPolicyToUser) | **PUT** /auth/users/{userId}/policies/{policyId} | attach policy to user
   145  *AuthApi* | [**createCredentials**](docs/AuthApi.md#createCredentials) | **POST** /auth/users/{userId}/credentials | create credentials
   146  *AuthApi* | [**createGroup**](docs/AuthApi.md#createGroup) | **POST** /auth/groups | create group
   147  *AuthApi* | [**createPolicy**](docs/AuthApi.md#createPolicy) | **POST** /auth/policies | create policy
   148  *AuthApi* | [**createUser**](docs/AuthApi.md#createUser) | **POST** /auth/users | create user
   149  *AuthApi* | [**createUserExternalPrincipal**](docs/AuthApi.md#createUserExternalPrincipal) | **POST** /auth/users/{userId}/external/principals | attach external principal to user
   150  *AuthApi* | [**deleteCredentials**](docs/AuthApi.md#deleteCredentials) | **DELETE** /auth/users/{userId}/credentials/{accessKeyId} | delete credentials
   151  *AuthApi* | [**deleteGroup**](docs/AuthApi.md#deleteGroup) | **DELETE** /auth/groups/{groupId} | delete group
   152  *AuthApi* | [**deleteGroupMembership**](docs/AuthApi.md#deleteGroupMembership) | **DELETE** /auth/groups/{groupId}/members/{userId} | delete group membership
   153  *AuthApi* | [**deletePolicy**](docs/AuthApi.md#deletePolicy) | **DELETE** /auth/policies/{policyId} | delete policy
   154  *AuthApi* | [**deleteUser**](docs/AuthApi.md#deleteUser) | **DELETE** /auth/users/{userId} | delete user
   155  *AuthApi* | [**deleteUserExternalPrincipal**](docs/AuthApi.md#deleteUserExternalPrincipal) | **DELETE** /auth/users/{userId}/external/principals | delete external principal from user
   156  *AuthApi* | [**detachPolicyFromGroup**](docs/AuthApi.md#detachPolicyFromGroup) | **DELETE** /auth/groups/{groupId}/policies/{policyId} | detach policy from group
   157  *AuthApi* | [**detachPolicyFromUser**](docs/AuthApi.md#detachPolicyFromUser) | **DELETE** /auth/users/{userId}/policies/{policyId} | detach policy from user
   158  *AuthApi* | [**externalPrincipalLogin**](docs/AuthApi.md#externalPrincipalLogin) | **POST** /auth/external/principal/login | perform a login using an external authenticator
   159  *AuthApi* | [**getCredentials**](docs/AuthApi.md#getCredentials) | **GET** /auth/users/{userId}/credentials/{accessKeyId} | get credentials
   160  *AuthApi* | [**getCurrentUser**](docs/AuthApi.md#getCurrentUser) | **GET** /user | get current user
   161  *AuthApi* | [**getExternalPrincipal**](docs/AuthApi.md#getExternalPrincipal) | **GET** /auth/external/principals | describe external principal by id
   162  *AuthApi* | [**getGroup**](docs/AuthApi.md#getGroup) | **GET** /auth/groups/{groupId} | get group
   163  *AuthApi* | [**getGroupACL**](docs/AuthApi.md#getGroupACL) | **GET** /auth/groups/{groupId}/acl | get ACL of group
   164  *AuthApi* | [**getPolicy**](docs/AuthApi.md#getPolicy) | **GET** /auth/policies/{policyId} | get policy
   165  *AuthApi* | [**getUser**](docs/AuthApi.md#getUser) | **GET** /auth/users/{userId} | get user
   166  *AuthApi* | [**listGroupMembers**](docs/AuthApi.md#listGroupMembers) | **GET** /auth/groups/{groupId}/members | list group members
   167  *AuthApi* | [**listGroupPolicies**](docs/AuthApi.md#listGroupPolicies) | **GET** /auth/groups/{groupId}/policies | list group policies
   168  *AuthApi* | [**listGroups**](docs/AuthApi.md#listGroups) | **GET** /auth/groups | list groups
   169  *AuthApi* | [**listPolicies**](docs/AuthApi.md#listPolicies) | **GET** /auth/policies | list policies
   170  *AuthApi* | [**listUserCredentials**](docs/AuthApi.md#listUserCredentials) | **GET** /auth/users/{userId}/credentials | list user credentials
   171  *AuthApi* | [**listUserExternalPrincipals**](docs/AuthApi.md#listUserExternalPrincipals) | **GET** /auth/users/{userId}/external/principals/ls | list user external policies attached to a user
   172  *AuthApi* | [**listUserGroups**](docs/AuthApi.md#listUserGroups) | **GET** /auth/users/{userId}/groups | list user groups
   173  *AuthApi* | [**listUserPolicies**](docs/AuthApi.md#listUserPolicies) | **GET** /auth/users/{userId}/policies | list user policies
   174  *AuthApi* | [**listUsers**](docs/AuthApi.md#listUsers) | **GET** /auth/users | list users
   175  *AuthApi* | [**login**](docs/AuthApi.md#login) | **POST** /auth/login | perform a login
   176  *AuthApi* | [**setGroupACL**](docs/AuthApi.md#setGroupACL) | **POST** /auth/groups/{groupId}/acl | set ACL of group
   177  *AuthApi* | [**updatePolicy**](docs/AuthApi.md#updatePolicy) | **PUT** /auth/policies/{policyId} | update policy
   178  *BranchesApi* | [**cherryPick**](docs/BranchesApi.md#cherryPick) | **POST** /repositories/{repository}/branches/{branch}/cherry-pick | Replay the changes from the given commit on the branch
   179  *BranchesApi* | [**createBranch**](docs/BranchesApi.md#createBranch) | **POST** /repositories/{repository}/branches | create branch
   180  *BranchesApi* | [**deleteBranch**](docs/BranchesApi.md#deleteBranch) | **DELETE** /repositories/{repository}/branches/{branch} | delete branch
   181  *BranchesApi* | [**diffBranch**](docs/BranchesApi.md#diffBranch) | **GET** /repositories/{repository}/branches/{branch}/diff | diff branch
   182  *BranchesApi* | [**getBranch**](docs/BranchesApi.md#getBranch) | **GET** /repositories/{repository}/branches/{branch} | get branch
   183  *BranchesApi* | [**listBranches**](docs/BranchesApi.md#listBranches) | **GET** /repositories/{repository}/branches | list branches
   184  *BranchesApi* | [**resetBranch**](docs/BranchesApi.md#resetBranch) | **PUT** /repositories/{repository}/branches/{branch} | reset branch
   185  *BranchesApi* | [**revertBranch**](docs/BranchesApi.md#revertBranch) | **POST** /repositories/{repository}/branches/{branch}/revert | revert
   186  *CommitsApi* | [**commit**](docs/CommitsApi.md#commit) | **POST** /repositories/{repository}/branches/{branch}/commits | create commit
   187  *CommitsApi* | [**getCommit**](docs/CommitsApi.md#getCommit) | **GET** /repositories/{repository}/commits/{commitId} | get commit
   188  *ConfigApi* | [**getConfig**](docs/ConfigApi.md#getConfig) | **GET** /config | 
   189  *ExperimentalApi* | [**abortPresignMultipartUpload**](docs/ExperimentalApi.md#abortPresignMultipartUpload) | **DELETE** /repositories/{repository}/branches/{branch}/staging/pmpu/{uploadId} | Abort a presign multipart upload
   190  *ExperimentalApi* | [**completePresignMultipartUpload**](docs/ExperimentalApi.md#completePresignMultipartUpload) | **PUT** /repositories/{repository}/branches/{branch}/staging/pmpu/{uploadId} | Complete a presign multipart upload request
   191  *ExperimentalApi* | [**createPresignMultipartUpload**](docs/ExperimentalApi.md#createPresignMultipartUpload) | **POST** /repositories/{repository}/branches/{branch}/staging/pmpu | Initiate a multipart upload
   192  *ExperimentalApi* | [**createUserExternalPrincipal**](docs/ExperimentalApi.md#createUserExternalPrincipal) | **POST** /auth/users/{userId}/external/principals | attach external principal to user
   193  *ExperimentalApi* | [**deleteUserExternalPrincipal**](docs/ExperimentalApi.md#deleteUserExternalPrincipal) | **DELETE** /auth/users/{userId}/external/principals | delete external principal from user
   194  *ExperimentalApi* | [**externalPrincipalLogin**](docs/ExperimentalApi.md#externalPrincipalLogin) | **POST** /auth/external/principal/login | perform a login using an external authenticator
   195  *ExperimentalApi* | [**getExternalPrincipal**](docs/ExperimentalApi.md#getExternalPrincipal) | **GET** /auth/external/principals | describe external principal by id
   196  *ExperimentalApi* | [**hardResetBranch**](docs/ExperimentalApi.md#hardResetBranch) | **PUT** /repositories/{repository}/branches/{branch}/hard_reset | hard reset branch
   197  *ExperimentalApi* | [**listUserExternalPrincipals**](docs/ExperimentalApi.md#listUserExternalPrincipals) | **GET** /auth/users/{userId}/external/principals/ls | list user external policies attached to a user
   198  *ExperimentalApi* | [**stsLogin**](docs/ExperimentalApi.md#stsLogin) | **POST** /sts/login | perform a login with STS
   199  *ExternalApi* | [**createUserExternalPrincipal**](docs/ExternalApi.md#createUserExternalPrincipal) | **POST** /auth/users/{userId}/external/principals | attach external principal to user
   200  *ExternalApi* | [**deleteUserExternalPrincipal**](docs/ExternalApi.md#deleteUserExternalPrincipal) | **DELETE** /auth/users/{userId}/external/principals | delete external principal from user
   201  *ExternalApi* | [**externalPrincipalLogin**](docs/ExternalApi.md#externalPrincipalLogin) | **POST** /auth/external/principal/login | perform a login using an external authenticator
   202  *ExternalApi* | [**getExternalPrincipal**](docs/ExternalApi.md#getExternalPrincipal) | **GET** /auth/external/principals | describe external principal by id
   203  *ExternalApi* | [**listUserExternalPrincipals**](docs/ExternalApi.md#listUserExternalPrincipals) | **GET** /auth/users/{userId}/external/principals/ls | list user external policies attached to a user
   204  *HealthCheckApi* | [**healthCheck**](docs/HealthCheckApi.md#healthCheck) | **GET** /healthcheck | 
   205  *ImportApi* | [**importCancel**](docs/ImportApi.md#importCancel) | **DELETE** /repositories/{repository}/branches/{branch}/import | cancel ongoing import
   206  *ImportApi* | [**importStart**](docs/ImportApi.md#importStart) | **POST** /repositories/{repository}/branches/{branch}/import | import data from object store
   207  *ImportApi* | [**importStatus**](docs/ImportApi.md#importStatus) | **GET** /repositories/{repository}/branches/{branch}/import | get import status
   208  *InternalApi* | [**createBranchProtectionRulePreflight**](docs/InternalApi.md#createBranchProtectionRulePreflight) | **GET** /repositories/{repository}/branch_protection/set_allowed | 
   209  *InternalApi* | [**createCommitRecord**](docs/InternalApi.md#createCommitRecord) | **POST** /repositories/{repository}/commits | create commit record
   210  *InternalApi* | [**createSymlinkFile**](docs/InternalApi.md#createSymlinkFile) | **POST** /repositories/{repository}/refs/{branch}/symlink | creates symlink files corresponding to the given directory
   211  *InternalApi* | [**deleteRepositoryMetadata**](docs/InternalApi.md#deleteRepositoryMetadata) | **DELETE** /repositories/{repository}/metadata | delete repository metadata
   212  *InternalApi* | [**dumpRefs**](docs/InternalApi.md#dumpRefs) | **PUT** /repositories/{repository}/refs/dump | Dump repository refs (tags, commits, branches) to object store Deprecated: a new API will introduce long running operations 
   213  *InternalApi* | [**getAuthCapabilities**](docs/InternalApi.md#getAuthCapabilities) | **GET** /auth/capabilities | list authentication capabilities supported
   214  *InternalApi* | [**getGarbageCollectionConfig**](docs/InternalApi.md#getGarbageCollectionConfig) | **GET** /config/garbage-collection | 
   215  *InternalApi* | [**getLakeFSVersion**](docs/InternalApi.md#getLakeFSVersion) | **GET** /config/version | 
   216  *InternalApi* | [**getSetupState**](docs/InternalApi.md#getSetupState) | **GET** /setup_lakefs | check if the lakeFS installation is already set up
   217  *InternalApi* | [**getStorageConfig**](docs/InternalApi.md#getStorageConfig) | **GET** /config/storage | 
   218  *InternalApi* | [**getUsageReportSummary**](docs/InternalApi.md#getUsageReportSummary) | **GET** /usage-report/summary | get usage report summary
   219  *InternalApi* | [**internalCreateBranchProtectionRule**](docs/InternalApi.md#internalCreateBranchProtectionRule) | **POST** /repositories/{repository}/branch_protection | 
   220  *InternalApi* | [**internalDeleteBranchProtectionRule**](docs/InternalApi.md#internalDeleteBranchProtectionRule) | **DELETE** /repositories/{repository}/branch_protection | 
   221  *InternalApi* | [**internalDeleteGarbageCollectionRules**](docs/InternalApi.md#internalDeleteGarbageCollectionRules) | **DELETE** /repositories/{repository}/gc/rules | 
   222  *InternalApi* | [**internalGetBranchProtectionRules**](docs/InternalApi.md#internalGetBranchProtectionRules) | **GET** /repositories/{repository}/branch_protection | get branch protection rules
   223  *InternalApi* | [**internalGetGarbageCollectionRules**](docs/InternalApi.md#internalGetGarbageCollectionRules) | **GET** /repositories/{repository}/gc/rules | 
   224  *InternalApi* | [**internalSetGarbageCollectionRules**](docs/InternalApi.md#internalSetGarbageCollectionRules) | **POST** /repositories/{repository}/gc/rules | 
   225  *InternalApi* | [**postStatsEvents**](docs/InternalApi.md#postStatsEvents) | **POST** /statistics | post stats events, this endpoint is meant for internal use only
   226  *InternalApi* | [**prepareGarbageCollectionCommits**](docs/InternalApi.md#prepareGarbageCollectionCommits) | **POST** /repositories/{repository}/gc/prepare_commits | save lists of active commits for garbage collection
   227  *InternalApi* | [**prepareGarbageCollectionUncommitted**](docs/InternalApi.md#prepareGarbageCollectionUncommitted) | **POST** /repositories/{repository}/gc/prepare_uncommited | save repository uncommitted metadata for garbage collection
   228  *InternalApi* | [**restoreRefs**](docs/InternalApi.md#restoreRefs) | **PUT** /repositories/{repository}/refs/restore | Restore repository refs (tags, commits, branches) from object store. Deprecated: a new API will introduce long running operations 
   229  *InternalApi* | [**setGarbageCollectionRulesPreflight**](docs/InternalApi.md#setGarbageCollectionRulesPreflight) | **GET** /repositories/{repository}/gc/rules/set_allowed | 
   230  *InternalApi* | [**setRepositoryMetadata**](docs/InternalApi.md#setRepositoryMetadata) | **POST** /repositories/{repository}/metadata | set repository metadata
   231  *InternalApi* | [**setup**](docs/InternalApi.md#setup) | **POST** /setup_lakefs | setup lakeFS and create a first user
   232  *InternalApi* | [**setupCommPrefs**](docs/InternalApi.md#setupCommPrefs) | **POST** /setup_comm_prefs | setup communications preferences
   233  *InternalApi* | [**stageObject**](docs/InternalApi.md#stageObject) | **PUT** /repositories/{repository}/branches/{branch}/objects | stage an object&#39;s metadata for the given branch
   234  *InternalApi* | [**uploadObjectPreflight**](docs/InternalApi.md#uploadObjectPreflight) | **GET** /repositories/{repository}/branches/{branch}/objects/stage_allowed | 
   235  *MetadataApi* | [**getMetaRange**](docs/MetadataApi.md#getMetaRange) | **GET** /repositories/{repository}/metadata/meta_range/{meta_range} | return URI to a meta-range file
   236  *MetadataApi* | [**getRange**](docs/MetadataApi.md#getRange) | **GET** /repositories/{repository}/metadata/range/{range} | return URI to a range file
   237  *ObjectsApi* | [**copyObject**](docs/ObjectsApi.md#copyObject) | **POST** /repositories/{repository}/branches/{branch}/objects/copy | create a copy of an object
   238  *ObjectsApi* | [**deleteObject**](docs/ObjectsApi.md#deleteObject) | **DELETE** /repositories/{repository}/branches/{branch}/objects | delete object. Missing objects will not return a NotFound error.
   239  *ObjectsApi* | [**deleteObjects**](docs/ObjectsApi.md#deleteObjects) | **POST** /repositories/{repository}/branches/{branch}/objects/delete | delete objects. Missing objects will not return a NotFound error.
   240  *ObjectsApi* | [**getObject**](docs/ObjectsApi.md#getObject) | **GET** /repositories/{repository}/refs/{ref}/objects | get object content
   241  *ObjectsApi* | [**getUnderlyingProperties**](docs/ObjectsApi.md#getUnderlyingProperties) | **GET** /repositories/{repository}/refs/{ref}/objects/underlyingProperties | get object properties on underlying storage
   242  *ObjectsApi* | [**headObject**](docs/ObjectsApi.md#headObject) | **HEAD** /repositories/{repository}/refs/{ref}/objects | check if object exists
   243  *ObjectsApi* | [**listObjects**](docs/ObjectsApi.md#listObjects) | **GET** /repositories/{repository}/refs/{ref}/objects/ls | list objects under a given prefix
   244  *ObjectsApi* | [**statObject**](docs/ObjectsApi.md#statObject) | **GET** /repositories/{repository}/refs/{ref}/objects/stat | get object metadata
   245  *ObjectsApi* | [**uploadObject**](docs/ObjectsApi.md#uploadObject) | **POST** /repositories/{repository}/branches/{branch}/objects | 
   246  *RefsApi* | [**diffRefs**](docs/RefsApi.md#diffRefs) | **GET** /repositories/{repository}/refs/{leftRef}/diff/{rightRef} | diff references
   247  *RefsApi* | [**findMergeBase**](docs/RefsApi.md#findMergeBase) | **GET** /repositories/{repository}/refs/{sourceRef}/merge/{destinationBranch} | find the merge base for 2 references
   248  *RefsApi* | [**logCommits**](docs/RefsApi.md#logCommits) | **GET** /repositories/{repository}/refs/{ref}/commits | get commit log from ref. If both objects and prefixes are empty, return all commits.
   249  *RefsApi* | [**mergeIntoBranch**](docs/RefsApi.md#mergeIntoBranch) | **POST** /repositories/{repository}/refs/{sourceRef}/merge/{destinationBranch} | merge references
   250  *RepositoriesApi* | [**createRepository**](docs/RepositoriesApi.md#createRepository) | **POST** /repositories | create repository
   251  *RepositoriesApi* | [**deleteGCRules**](docs/RepositoriesApi.md#deleteGCRules) | **DELETE** /repositories/{repository}/settings/gc_rules | 
   252  *RepositoriesApi* | [**deleteRepository**](docs/RepositoriesApi.md#deleteRepository) | **DELETE** /repositories/{repository} | delete repository
   253  *RepositoriesApi* | [**dumpStatus**](docs/RepositoriesApi.md#dumpStatus) | **GET** /repositories/{repository}/dump | Status of a repository dump task
   254  *RepositoriesApi* | [**dumpSubmit**](docs/RepositoriesApi.md#dumpSubmit) | **POST** /repositories/{repository}/dump | Backup the repository metadata (tags, commits, branches) and save the backup to the object store.
   255  *RepositoriesApi* | [**getBranchProtectionRules**](docs/RepositoriesApi.md#getBranchProtectionRules) | **GET** /repositories/{repository}/settings/branch_protection | get branch protection rules
   256  *RepositoriesApi* | [**getGCRules**](docs/RepositoriesApi.md#getGCRules) | **GET** /repositories/{repository}/settings/gc_rules | get repository GC rules
   257  *RepositoriesApi* | [**getRepository**](docs/RepositoriesApi.md#getRepository) | **GET** /repositories/{repository} | get repository
   258  *RepositoriesApi* | [**getRepositoryMetadata**](docs/RepositoriesApi.md#getRepositoryMetadata) | **GET** /repositories/{repository}/metadata | get repository metadata
   259  *RepositoriesApi* | [**listRepositories**](docs/RepositoriesApi.md#listRepositories) | **GET** /repositories | list repositories
   260  *RepositoriesApi* | [**restoreStatus**](docs/RepositoriesApi.md#restoreStatus) | **GET** /repositories/{repository}/restore | Status of a restore request
   261  *RepositoriesApi* | [**restoreSubmit**](docs/RepositoriesApi.md#restoreSubmit) | **POST** /repositories/{repository}/restore | Restore repository from a dump in the object store
   262  *RepositoriesApi* | [**setBranchProtectionRules**](docs/RepositoriesApi.md#setBranchProtectionRules) | **PUT** /repositories/{repository}/settings/branch_protection | 
   263  *RepositoriesApi* | [**setGCRules**](docs/RepositoriesApi.md#setGCRules) | **PUT** /repositories/{repository}/settings/gc_rules | 
   264  *StagingApi* | [**getPhysicalAddress**](docs/StagingApi.md#getPhysicalAddress) | **GET** /repositories/{repository}/branches/{branch}/staging/backing | generate an address to which the client can upload an object
   265  *StagingApi* | [**linkPhysicalAddress**](docs/StagingApi.md#linkPhysicalAddress) | **PUT** /repositories/{repository}/branches/{branch}/staging/backing | associate staging on this physical address with a path
   266  *TagsApi* | [**createTag**](docs/TagsApi.md#createTag) | **POST** /repositories/{repository}/tags | create tag
   267  *TagsApi* | [**deleteTag**](docs/TagsApi.md#deleteTag) | **DELETE** /repositories/{repository}/tags/{tag} | delete tag
   268  *TagsApi* | [**getTag**](docs/TagsApi.md#getTag) | **GET** /repositories/{repository}/tags/{tag} | get tag
   269  *TagsApi* | [**listTags**](docs/TagsApi.md#listTags) | **GET** /repositories/{repository}/tags | list tags
   270  
   271  
   272  ## Documentation for Models
   273  
   274   - [ACL](docs/ACL.md)
   275   - [AbortPresignMultipartUpload](docs/AbortPresignMultipartUpload.md)
   276   - [AccessKeyCredentials](docs/AccessKeyCredentials.md)
   277   - [ActionRun](docs/ActionRun.md)
   278   - [ActionRunList](docs/ActionRunList.md)
   279   - [AuthCapabilities](docs/AuthCapabilities.md)
   280   - [AuthenticationToken](docs/AuthenticationToken.md)
   281   - [BranchCreation](docs/BranchCreation.md)
   282   - [BranchProtectionRule](docs/BranchProtectionRule.md)
   283   - [CherryPickCreation](docs/CherryPickCreation.md)
   284   - [CommPrefsInput](docs/CommPrefsInput.md)
   285   - [Commit](docs/Commit.md)
   286   - [CommitCreation](docs/CommitCreation.md)
   287   - [CommitList](docs/CommitList.md)
   288   - [CommitRecordCreation](docs/CommitRecordCreation.md)
   289   - [CompletePresignMultipartUpload](docs/CompletePresignMultipartUpload.md)
   290   - [Config](docs/Config.md)
   291   - [Credentials](docs/Credentials.md)
   292   - [CredentialsList](docs/CredentialsList.md)
   293   - [CredentialsWithSecret](docs/CredentialsWithSecret.md)
   294   - [CurrentUser](docs/CurrentUser.md)
   295   - [Diff](docs/Diff.md)
   296   - [DiffList](docs/DiffList.md)
   297   - [Error](docs/Error.md)
   298   - [ErrorNoACL](docs/ErrorNoACL.md)
   299   - [ExternalLoginInformation](docs/ExternalLoginInformation.md)
   300   - [ExternalPrincipal](docs/ExternalPrincipal.md)
   301   - [ExternalPrincipalCreation](docs/ExternalPrincipalCreation.md)
   302   - [ExternalPrincipalList](docs/ExternalPrincipalList.md)
   303   - [FindMergeBaseResult](docs/FindMergeBaseResult.md)
   304   - [GarbageCollectionConfig](docs/GarbageCollectionConfig.md)
   305   - [GarbageCollectionPrepareResponse](docs/GarbageCollectionPrepareResponse.md)
   306   - [GarbageCollectionRule](docs/GarbageCollectionRule.md)
   307   - [GarbageCollectionRules](docs/GarbageCollectionRules.md)
   308   - [Group](docs/Group.md)
   309   - [GroupCreation](docs/GroupCreation.md)
   310   - [GroupList](docs/GroupList.md)
   311   - [HookRun](docs/HookRun.md)
   312   - [HookRunList](docs/HookRunList.md)
   313   - [ImportCreation](docs/ImportCreation.md)
   314   - [ImportCreationResponse](docs/ImportCreationResponse.md)
   315   - [ImportLocation](docs/ImportLocation.md)
   316   - [ImportStatus](docs/ImportStatus.md)
   317   - [InlineObject](docs/InlineObject.md)
   318   - [InlineObject1](docs/InlineObject1.md)
   319   - [InstallationUsageReport](docs/InstallationUsageReport.md)
   320   - [LoginConfig](docs/LoginConfig.md)
   321   - [LoginInformation](docs/LoginInformation.md)
   322   - [Merge](docs/Merge.md)
   323   - [MergeResult](docs/MergeResult.md)
   324   - [MetaRangeCreation](docs/MetaRangeCreation.md)
   325   - [MetaRangeCreationResponse](docs/MetaRangeCreationResponse.md)
   326   - [ObjectCopyCreation](docs/ObjectCopyCreation.md)
   327   - [ObjectError](docs/ObjectError.md)
   328   - [ObjectErrorList](docs/ObjectErrorList.md)
   329   - [ObjectStageCreation](docs/ObjectStageCreation.md)
   330   - [ObjectStats](docs/ObjectStats.md)
   331   - [ObjectStatsList](docs/ObjectStatsList.md)
   332   - [Pagination](docs/Pagination.md)
   333   - [PathList](docs/PathList.md)
   334   - [Policy](docs/Policy.md)
   335   - [PolicyList](docs/PolicyList.md)
   336   - [PrepareGCUncommittedRequest](docs/PrepareGCUncommittedRequest.md)
   337   - [PrepareGCUncommittedResponse](docs/PrepareGCUncommittedResponse.md)
   338   - [PresignMultipartUpload](docs/PresignMultipartUpload.md)
   339   - [RangeMetadata](docs/RangeMetadata.md)
   340   - [Ref](docs/Ref.md)
   341   - [RefList](docs/RefList.md)
   342   - [RefsDump](docs/RefsDump.md)
   343   - [RefsRestore](docs/RefsRestore.md)
   344   - [Repository](docs/Repository.md)
   345   - [RepositoryCreation](docs/RepositoryCreation.md)
   346   - [RepositoryDumpStatus](docs/RepositoryDumpStatus.md)
   347   - [RepositoryList](docs/RepositoryList.md)
   348   - [RepositoryMetadataKeys](docs/RepositoryMetadataKeys.md)
   349   - [RepositoryMetadataSet](docs/RepositoryMetadataSet.md)
   350   - [RepositoryRestoreStatus](docs/RepositoryRestoreStatus.md)
   351   - [ResetCreation](docs/ResetCreation.md)
   352   - [RevertCreation](docs/RevertCreation.md)
   353   - [Setup](docs/Setup.md)
   354   - [SetupState](docs/SetupState.md)
   355   - [StagingLocation](docs/StagingLocation.md)
   356   - [StagingMetadata](docs/StagingMetadata.md)
   357   - [Statement](docs/Statement.md)
   358   - [StatsEvent](docs/StatsEvent.md)
   359   - [StatsEventsList](docs/StatsEventsList.md)
   360   - [StorageConfig](docs/StorageConfig.md)
   361   - [StorageURI](docs/StorageURI.md)
   362   - [StsAuthRequest](docs/StsAuthRequest.md)
   363   - [TagCreation](docs/TagCreation.md)
   364   - [TaskInfo](docs/TaskInfo.md)
   365   - [UnderlyingObjectProperties](docs/UnderlyingObjectProperties.md)
   366   - [UpdateToken](docs/UpdateToken.md)
   367   - [UploadPart](docs/UploadPart.md)
   368   - [UsageReport](docs/UsageReport.md)
   369   - [User](docs/User.md)
   370   - [UserCreation](docs/UserCreation.md)
   371   - [UserList](docs/UserList.md)
   372   - [VersionConfig](docs/VersionConfig.md)
   373  
   374  
   375  ## Documentation for Authorization
   376  
   377  Authentication schemes defined for the API:
   378  ### basic_auth
   379  
   380  - **Type**: HTTP basic authentication
   381  
   382  ### cookie_auth
   383  
   384  - **Type**: API key
   385  - **API key parameter name**: internal_auth_session
   386  - **Location**: 
   387  
   388  ### jwt_token
   389  
   390  - **Type**: HTTP basic authentication
   391  
   392  ### oidc_auth
   393  
   394  - **Type**: API key
   395  - **API key parameter name**: oidc_auth_session
   396  - **Location**: 
   397  
   398  ### saml_auth
   399  
   400  - **Type**: API key
   401  - **API key parameter name**: saml_auth_session
   402  - **Location**: 
   403  
   404  
   405  ## Recommendation
   406  
   407  It's recommended to create an instance of `ApiClient` per thread in a multithreaded environment to avoid any potential issues.
   408  
   409  ## Author
   410  
   411  
   412