pulp_maven_client 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d45224724d8a990989192786764bc604b2a6c5f197f038c9bbf02da41155e6ad
-  data.tar.gz: a4853a052fc1ce417fc8d82c086ba2fc8d54e2c05ce29ff51a388c445a50f4d4
+  metadata.gz: 5ca1f48c99dc8eb0ea0bb9a96914aba88874b383a9f119f3b9284603ce2f6e2f
+  data.tar.gz: 1739f4acdcdb2937620f8fc8de08a165cad25164b98f808552ce295c0c701c17
 SHA512:
-  metadata.gz: 86aab0ce92617e5e0661f9d2ac0f7ab46552d560a2aaa43091422b808f1ae6a6425f907cdf52e29550b799a0d50d5572d2d02a3118222623c13ce82177cf9f5f
-  data.tar.gz: 7c4cc8d459c7ddc6ac8e618b20ca7eef0f9d59303b22a4fe4ae205478c94b6c654adbb50dcb0d639dcd7be6b1a01968b9c162c9566eda0f44f2aacc523c677d5
+  metadata.gz: 98e6bb118a07ef5c823d3677b235e8707f588a4d8140f421d0b0d14f05d5be6b9538165994faeeddfed47ed61e9d290d0791dadd72101e188bbe8ab3e676d620
+  data.tar.gz: b1e1b242442f1f3c5d783e76501c9867c5ddd7a096a7bc46423b7983e87aff65a9751b9034e6daae92bd69fe0d7f38589238c1903486c7e73f6625fb12998029

data/README.md

@@ -7,7 +7,7 @@ Fetch, Upload, Organize, and Distribute Software Packages
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: v3
-- Package version: 0.15.0
+- Package version: 0.16.0
 - Generator version: 7.10.0
 - Build package: org.openapitools.codegen.languages.RubyClientCodegen
 For more information, please visit [https://pulpproject.org](https://pulpproject.org)
@@ -25,16 +25,16 @@ gem build pulp_maven_client.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./pulp_maven_client-0.15.0.gem
+gem install ./pulp_maven_client-0.16.0.gem
 ```
 
-(for development, run `gem install --dev ./pulp_maven_client-0.15.0.gem` to install the development dependencies)
+(for development, run `gem install --dev ./pulp_maven_client-0.16.0.gem` to install the development dependencies)
 
 or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
 Finally add this to the Gemfile:
 
-    gem 'pulp_maven_client', '~> 0.15.0'
+    gem 'pulp_maven_client', '~> 0.16.0'
 
 ### Install from Git
 
@@ -75,7 +75,10 @@ opts = {
   overwrite: true, # Boolean | When set to true, existing content in the repository with the same unique key will be silently overwritten. When set to false, the task will fail if content would be overwritten. Only used when 'repository' is specified. Defaults to true.
   pulp_labels: { key: 'inner_example'}, # Hash<String, String> | A dictionary of arbitrary key/value pairs used to describe a specific Content instance.
   artifact: 'artifact_example', # String | Artifact file representing the physical content
-  file: File.new('/path/to/some/file') # File | An uploaded file that may be turned into the content unit.
+  file: File.new('/path/to/some/file'), # File | An uploaded file that may be turned into the content unit.
+  upload: 'upload_example', # String | An uncommitted upload that may be turned into the content unit.
+  file_url: 'file_url_example', # String | A url that Pulp can download and turn into the content unit.
+  downloader_config: PulpMavenClient::RemoteNetworkConfig.new # RemoteNetworkConfig | Configuration for the download process (e.g., proxies, auth, timeouts). Only applicable when providing a 'file_url.
 }
 
 begin
@@ -99,6 +102,7 @@ Class | Method | HTTP request | Description
 *PulpMavenClient::ContentArtifactApi* | [**read**](docs/ContentArtifactApi.md#read) | **GET** {maven_maven_artifact_href} | Inspect a maven artifact
 *PulpMavenClient::ContentArtifactApi* | [**set_label**](docs/ContentArtifactApi.md#set_label) | **POST** {maven_maven_artifact_href}set_label/ | Set a label
 *PulpMavenClient::ContentArtifactApi* | [**unset_label**](docs/ContentArtifactApi.md#unset_label) | **POST** {maven_maven_artifact_href}unset_label/ | Unset a label
+*PulpMavenClient::ContentArtifactApi* | [**upload**](docs/ContentArtifactApi.md#upload) | **POST** /pulp/api/v3/content/maven/artifact/upload/ | Upload a Maven artifact synchronously.
 *PulpMavenClient::DistributionsMavenApi* | [**create**](docs/DistributionsMavenApi.md#create) | **POST** /pulp/api/v3/distributions/maven/maven/ | Create a maven distribution
 *PulpMavenClient::DistributionsMavenApi* | [**delete**](docs/DistributionsMavenApi.md#delete) | **DELETE** {maven_maven_distribution_href} | Delete a maven distribution
 *PulpMavenClient::DistributionsMavenApi* | [**list**](docs/DistributionsMavenApi.md#list) | **GET** /pulp/api/v3/distributions/maven/maven/ | List maven distributions
@@ -154,6 +158,8 @@ Class | Method | HTTP request | Description
  - [PulpMavenClient::PatchedmavenMavenRemote](docs/PatchedmavenMavenRemote.md)
  - [PulpMavenClient::PatchedmavenMavenRepository](docs/PatchedmavenMavenRepository.md)
  - [PulpMavenClient::PolicyEnum](docs/PolicyEnum.md)
+ - [PulpMavenClient::RemoteNetworkConfig](docs/RemoteNetworkConfig.md)
+ - [PulpMavenClient::RemoteNetworkConfigResponse](docs/RemoteNetworkConfigResponse.md)
  - [PulpMavenClient::Repair](docs/Repair.md)
  - [PulpMavenClient::RepositoryAddCachedContent](docs/RepositoryAddCachedContent.md)
  - [PulpMavenClient::RepositoryAddRemoveContent](docs/RepositoryAddRemoveContent.md)

data/docs/ContentArtifactApi.md

@@ -9,15 +9,16 @@ All URIs are relative to *http://localhost:24817*
 | [**read**](ContentArtifactApi.md#read) | **GET** {maven_maven_artifact_href} | Inspect a maven artifact |
 | [**set_label**](ContentArtifactApi.md#set_label) | **POST** {maven_maven_artifact_href}set_label/ | Set a label |
 | [**unset_label**](ContentArtifactApi.md#unset_label) | **POST** {maven_maven_artifact_href}unset_label/ | Unset a label |
+| [**upload**](ContentArtifactApi.md#upload) | **POST** /pulp/api/v3/content/maven/artifact/upload/ | Upload a Maven artifact synchronously. |
 
 
 ## create
 
-> <MavenMavenArtifactResponse> create(relative_path, opts)
+> <AsyncOperationResponse> create(relative_path, opts)
 
 Create a maven artifact
 
-A ViewSet for MavenArtifact.
+Trigger an asynchronous task to create content,optionally create new repository version.
 
 ### Examples
 
@@ -39,7 +40,10 @@ opts = {
   overwrite: true, # Boolean | When set to true, existing content in the repository with the same unique key will be silently overwritten. When set to false, the task will fail if content would be overwritten. Only used when 'repository' is specified. Defaults to true.
   pulp_labels: { key: 'inner_example'}, # Hash<String, String> | A dictionary of arbitrary key/value pairs used to describe a specific Content instance.
   artifact: 'artifact_example', # String | Artifact file representing the physical content
-  file: File.new('/path/to/some/file') # File | An uploaded file that may be turned into the content unit.
+  file: File.new('/path/to/some/file'), # File | An uploaded file that may be turned into the content unit.
+  upload: 'upload_example', # String | An uncommitted upload that may be turned into the content unit.
+  file_url: 'file_url_example', # String | A url that Pulp can download and turn into the content unit.
+  downloader_config: PulpMavenClient::RemoteNetworkConfig.new # RemoteNetworkConfig | Configuration for the download process (e.g., proxies, auth, timeouts). Only applicable when providing a 'file_url.
 }
 
 begin
@@ -55,7 +59,7 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<MavenMavenArtifactResponse>, Integer, Hash)> create_with_http_info(relative_path, opts)
+> <Array(<AsyncOperationResponse>, Integer, Hash)> create_with_http_info(relative_path, opts)
 
 ```ruby
 begin
@@ -63,7 +67,7 @@ begin
   data, status_code, headers = api_instance.create_with_http_info(relative_path, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <MavenMavenArtifactResponse>
+  p data # => <AsyncOperationResponse>
 rescue PulpMavenClient::ApiError => e
   puts "Error when calling ContentArtifactApi->create_with_http_info: #{e}"
 end
@@ -80,10 +84,13 @@ end
 | **pulp_labels** | [**Hash&lt;String, String&gt;**](Hash.md) | A dictionary of arbitrary key/value pairs used to describe a specific Content instance. | [optional] |
 | **artifact** | **String** | Artifact file representing the physical content | [optional] |
 | **file** | **File** | An uploaded file that may be turned into the content unit. | [optional] |
+| **upload** | **String** | An uncommitted upload that may be turned into the content unit. | [optional] |
+| **file_url** | **String** | A url that Pulp can download and turn into the content unit. | [optional] |
+| **downloader_config** | [**RemoteNetworkConfig**](RemoteNetworkConfig.md) | Configuration for the download process (e.g., proxies, auth, timeouts). Only applicable when providing a &#39;file_url. | [optional] |
 
 ### Return type
 
-[**MavenMavenArtifactResponse**](MavenMavenArtifactResponse.md)
+[**AsyncOperationResponse**](AsyncOperationResponse.md)
 
 ### Authorization
 
@@ -432,3 +439,93 @@ end
 - **Content-Type**: application/json, application/x-www-form-urlencoded, multipart/form-data
 - **Accept**: application/json
 
+
+## upload
+
+> <MavenMavenArtifactResponse> upload(relative_path, opts)
+
+Upload a Maven artifact synchronously.
+
+Synchronously upload a Maven artifact.
+
+### Examples
+
+```ruby
+require 'time'
+require 'pulp_maven_client'
+# setup authorization
+PulpMavenClient.configure do |config|
+  # Configure HTTP basic authorization: basicAuth
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = PulpMavenClient::ContentArtifactApi.new
+relative_path = 'relative_path_example' # String | Path where the artifact is located relative to distributions base_path
+opts = {
+  x_task_diagnostics: ['inner_example'], # Array<String> | List of profilers to use on tasks.
+  repository: 'repository_example', # String | A URI of a repository the new content unit should be associated with.
+  overwrite: true, # Boolean | When set to true, existing content in the repository with the same unique key will be silently overwritten. When set to false, the task will fail if content would be overwritten. Only used when 'repository' is specified. Defaults to true.
+  pulp_labels: { key: 'inner_example'}, # Hash<String, String> | A dictionary of arbitrary key/value pairs used to describe a specific Content instance.
+  artifact: 'artifact_example', # String | Artifact file representing the physical content
+  file: File.new('/path/to/some/file'), # File | An uploaded file that may be turned into the content unit.
+  upload: 'upload_example', # String | An uncommitted upload that may be turned into the content unit.
+  file_url: 'file_url_example', # String | A url that Pulp can download and turn into the content unit.
+  downloader_config: PulpMavenClient::RemoteNetworkConfig.new # RemoteNetworkConfig | Configuration for the download process (e.g., proxies, auth, timeouts). Only applicable when providing a 'file_url.
+}
+
+begin
+  # Upload a Maven artifact synchronously.
+  result = api_instance.upload(relative_path, opts)
+  p result
+rescue PulpMavenClient::ApiError => e
+  puts "Error when calling ContentArtifactApi->upload: #{e}"
+end
+```
+
+#### Using the upload_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MavenMavenArtifactResponse>, Integer, Hash)> upload_with_http_info(relative_path, opts)
+
+```ruby
+begin
+  # Upload a Maven artifact synchronously.
+  data, status_code, headers = api_instance.upload_with_http_info(relative_path, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MavenMavenArtifactResponse>
+rescue PulpMavenClient::ApiError => e
+  puts "Error when calling ContentArtifactApi->upload_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **relative_path** | **String** | Path where the artifact is located relative to distributions base_path |  |
+| **x_task_diagnostics** | [**Array&lt;String&gt;**](String.md) | List of profilers to use on tasks. | [optional] |
+| **repository** | **String** | A URI of a repository the new content unit should be associated with. | [optional] |
+| **overwrite** | **Boolean** | When set to true, existing content in the repository with the same unique key will be silently overwritten. When set to false, the task will fail if content would be overwritten. Only used when &#39;repository&#39; is specified. Defaults to true. | [optional] |
+| **pulp_labels** | [**Hash&lt;String, String&gt;**](Hash.md) | A dictionary of arbitrary key/value pairs used to describe a specific Content instance. | [optional] |
+| **artifact** | **String** | Artifact file representing the physical content | [optional] |
+| **file** | **File** | An uploaded file that may be turned into the content unit. | [optional] |
+| **upload** | **String** | An uncommitted upload that may be turned into the content unit. | [optional] |
+| **file_url** | **String** | A url that Pulp can download and turn into the content unit. | [optional] |
+| **downloader_config** | [**RemoteNetworkConfig**](RemoteNetworkConfig.md) | Configuration for the download process (e.g., proxies, auth, timeouts). Only applicable when providing a &#39;file_url. | [optional] |
+
+### Return type
+
+[**MavenMavenArtifactResponse**](MavenMavenArtifactResponse.md)
+
+### Authorization
+
+[basicAuth](../README.md#basicAuth)
+
+### HTTP request headers
+
+- **Content-Type**: multipart/form-data, application/x-www-form-urlencoded
+- **Accept**: application/json
+

data/docs/RemoteNetworkConfig.md

@@ -0,0 +1,50 @@
+# PulpMavenClient::RemoteNetworkConfig
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ca_cert** | **String** | A PEM encoded CA certificate used to validate the server certificate presented by the remote server. | [optional] |
+| **client_cert** | **String** | A PEM encoded client certificate used for authentication. | [optional] |
+| **client_key** | **String** | A PEM encoded private key used for authentication. | [optional] |
+| **tls_validation** | **Boolean** | If True, TLS peer validation must be performed. | [optional] |
+| **proxy_url** | **String** | The proxy URL. Format: scheme://host:port | [optional] |
+| **proxy_username** | **String** | The username to authenticte to the proxy. | [optional] |
+| **proxy_password** | **String** | The password to authenticate to the proxy. Extra leading and trailing whitespace characters are not trimmed. | [optional] |
+| **username** | **String** | The username to be used for authentication when syncing. | [optional] |
+| **password** | **String** | The password to be used for authentication when syncing. Extra leading and trailing whitespace characters are not trimmed. | [optional] |
+| **max_retries** | **Integer** | Maximum number of retry attempts after a download failure. If not set then the default value (3) will be used. | [optional] |
+| **total_timeout** | **Float** | aiohttp.ClientTimeout.total (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. | [optional] |
+| **connect_timeout** | **Float** | aiohttp.ClientTimeout.connect (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. | [optional] |
+| **sock_connect_timeout** | **Float** | aiohttp.ClientTimeout.sock_connect (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. | [optional] |
+| **sock_read_timeout** | **Float** | aiohttp.ClientTimeout.sock_read (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. | [optional] |
+| **headers** | **Array<Object>** | Headers for aiohttp.Clientsession | [optional] |
+| **download_concurrency** | **Integer** | Total number of simultaneous connections. If not set then the default value will be used. | [optional] |
+| **rate_limit** | **Integer** | Limits requests per second for each concurrent downloader | [optional] |
+
+## Example
+
+```ruby
+require 'pulp_maven_client'
+
+instance = PulpMavenClient::RemoteNetworkConfig.new(
+  ca_cert: null,
+  client_cert: null,
+  client_key: null,
+  tls_validation: null,
+  proxy_url: null,
+  proxy_username: null,
+  proxy_password: null,
+  username: null,
+  password: null,
+  max_retries: null,
+  total_timeout: null,
+  connect_timeout: null,
+  sock_connect_timeout: null,
+  sock_read_timeout: null,
+  headers: null,
+  download_concurrency: null,
+  rate_limit: null
+)
+```
+

data/docs/RemoteNetworkConfigResponse.md

@@ -0,0 +1,40 @@
+# PulpMavenClient::RemoteNetworkConfigResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ca_cert** | **String** | A PEM encoded CA certificate used to validate the server certificate presented by the remote server. | [optional] |
+| **client_cert** | **String** | A PEM encoded client certificate used for authentication. | [optional] |
+| **tls_validation** | **Boolean** | If True, TLS peer validation must be performed. | [optional] |
+| **proxy_url** | **String** | The proxy URL. Format: scheme://host:port | [optional] |
+| **max_retries** | **Integer** | Maximum number of retry attempts after a download failure. If not set then the default value (3) will be used. | [optional] |
+| **total_timeout** | **Float** | aiohttp.ClientTimeout.total (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. | [optional] |
+| **connect_timeout** | **Float** | aiohttp.ClientTimeout.connect (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. | [optional] |
+| **sock_connect_timeout** | **Float** | aiohttp.ClientTimeout.sock_connect (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. | [optional] |
+| **sock_read_timeout** | **Float** | aiohttp.ClientTimeout.sock_read (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. | [optional] |
+| **headers** | **Array<Object>** | Headers for aiohttp.Clientsession | [optional] |
+| **download_concurrency** | **Integer** | Total number of simultaneous connections. If not set then the default value will be used. | [optional] |
+| **rate_limit** | **Integer** | Limits requests per second for each concurrent downloader | [optional] |
+
+## Example
+
+```ruby
+require 'pulp_maven_client'
+
+instance = PulpMavenClient::RemoteNetworkConfigResponse.new(
+  ca_cert: null,
+  client_cert: null,
+  tls_validation: null,
+  proxy_url: null,
+  max_retries: null,
+  total_timeout: null,
+  connect_timeout: null,
+  sock_connect_timeout: null,
+  sock_read_timeout: null,
+  headers: null,
+  download_concurrency: null,
+  rate_limit: null
+)
+```
+

data/lib/pulp_maven_client/api/content_artifact_api.rb

@@ -20,7 +20,7 @@ module PulpMavenClient
       @api_client = api_client
     end
     # Create a maven artifact
-    # A ViewSet for MavenArtifact.
+    # Trigger an asynchronous task to create content,optionally create new repository version.
     # @param relative_path [String] Path where the artifact is located relative to distributions base_path
     # @param [Hash] opts the optional parameters
     # @option opts [Array<String>] :x_task_diagnostics List of profilers to use on tasks.
@@ -29,14 +29,17 @@ module PulpMavenClient
     # @option opts [Hash<String, String>] :pulp_labels A dictionary of arbitrary key/value pairs used to describe a specific Content instance.
     # @option opts [String] :artifact Artifact file representing the physical content
     # @option opts [File] :file An uploaded file that may be turned into the content unit.
-    # @return [MavenMavenArtifactResponse]
+    # @option opts [String] :upload An uncommitted upload that may be turned into the content unit.
+    # @option opts [String] :file_url A url that Pulp can download and turn into the content unit.
+    # @option opts [RemoteNetworkConfig] :downloader_config Configuration for the download process (e.g., proxies, auth, timeouts). Only applicable when providing a &#39;file_url.
+    # @return [AsyncOperationResponse]
     def create(relative_path, opts = {})
       data, _status_code, _headers = create_with_http_info(relative_path, opts)
       data
     end
 
     # Create a maven artifact
-    # A ViewSet for MavenArtifact.
+    # Trigger an asynchronous task to create content,optionally create new repository version.
     # @param relative_path [String] Path where the artifact is located relative to distributions base_path
     # @param [Hash] opts the optional parameters
     # @option opts [Array<String>] :x_task_diagnostics List of profilers to use on tasks.
@@ -45,7 +48,10 @@ module PulpMavenClient
     # @option opts [Hash<String, String>] :pulp_labels A dictionary of arbitrary key/value pairs used to describe a specific Content instance.
     # @option opts [String] :artifact Artifact file representing the physical content
     # @option opts [File] :file An uploaded file that may be turned into the content unit.
-    # @return [Array<(MavenMavenArtifactResponse, Integer, Hash)>] MavenMavenArtifactResponse data, response status code and response headers
+    # @option opts [String] :upload An uncommitted upload that may be turned into the content unit.
+    # @option opts [String] :file_url A url that Pulp can download and turn into the content unit.
+    # @option opts [RemoteNetworkConfig] :downloader_config Configuration for the download process (e.g., proxies, auth, timeouts). Only applicable when providing a &#39;file_url.
+    # @return [Array<(AsyncOperationResponse, Integer, Hash)>] AsyncOperationResponse data, response status code and response headers
     def create_with_http_info(relative_path, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: ContentArtifactApi.create ...'
@@ -58,6 +64,10 @@ module PulpMavenClient
         fail ArgumentError, 'invalid value for "relative_path" when calling ContentArtifactApi.create, the character length must be great than or equal to 1.'
       end
 
+      if @api_client.config.client_side_validation && !opts[:'file_url'].nil? && opts[:'file_url'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"file_url"]" when calling ContentArtifactApi.create, the character length must be great than or equal to 1.'
+      end
+
       # resource path
       local_var_path = '/pulp/api/v3/content/maven/artifact/'
 
@@ -83,12 +93,15 @@ module PulpMavenClient
       form_params['pulp_labels'] = opts[:'pulp_labels'] if !opts[:'pulp_labels'].nil?
       form_params['artifact'] = opts[:'artifact'] if !opts[:'artifact'].nil?
       form_params['file'] = opts[:'file'] if !opts[:'file'].nil?
+      form_params['upload'] = opts[:'upload'] if !opts[:'upload'].nil?
+      form_params['file_url'] = opts[:'file_url'] if !opts[:'file_url'].nil?
+      form_params['downloader_config'] = opts[:'downloader_config'] if !opts[:'downloader_config'].nil?
 
       # http body (model)
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'MavenMavenArtifactResponse'
+      return_type = opts[:debug_return_type] || 'AsyncOperationResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['basicAuth']
@@ -453,5 +466,109 @@ module PulpMavenClient
       end
       return data, status_code, headers
     end
+
+    # Upload a Maven artifact synchronously.
+    # Synchronously upload a Maven artifact.
+    # @param relative_path [String] Path where the artifact is located relative to distributions base_path
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :x_task_diagnostics List of profilers to use on tasks.
+    # @option opts [String] :repository A URI of a repository the new content unit should be associated with.
+    # @option opts [Boolean] :overwrite When set to true, existing content in the repository with the same unique key will be silently overwritten. When set to false, the task will fail if content would be overwritten. Only used when &#39;repository&#39; is specified. Defaults to true.
+    # @option opts [Hash<String, String>] :pulp_labels A dictionary of arbitrary key/value pairs used to describe a specific Content instance.
+    # @option opts [String] :artifact Artifact file representing the physical content
+    # @option opts [File] :file An uploaded file that may be turned into the content unit.
+    # @option opts [String] :upload An uncommitted upload that may be turned into the content unit.
+    # @option opts [String] :file_url A url that Pulp can download and turn into the content unit.
+    # @option opts [RemoteNetworkConfig] :downloader_config Configuration for the download process (e.g., proxies, auth, timeouts). Only applicable when providing a &#39;file_url.
+    # @return [MavenMavenArtifactResponse]
+    def upload(relative_path, opts = {})
+      data, _status_code, _headers = upload_with_http_info(relative_path, opts)
+      data
+    end
+
+    # Upload a Maven artifact synchronously.
+    # Synchronously upload a Maven artifact.
+    # @param relative_path [String] Path where the artifact is located relative to distributions base_path
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :x_task_diagnostics List of profilers to use on tasks.
+    # @option opts [String] :repository A URI of a repository the new content unit should be associated with.
+    # @option opts [Boolean] :overwrite When set to true, existing content in the repository with the same unique key will be silently overwritten. When set to false, the task will fail if content would be overwritten. Only used when &#39;repository&#39; is specified. Defaults to true.
+    # @option opts [Hash<String, String>] :pulp_labels A dictionary of arbitrary key/value pairs used to describe a specific Content instance.
+    # @option opts [String] :artifact Artifact file representing the physical content
+    # @option opts [File] :file An uploaded file that may be turned into the content unit.
+    # @option opts [String] :upload An uncommitted upload that may be turned into the content unit.
+    # @option opts [String] :file_url A url that Pulp can download and turn into the content unit.
+    # @option opts [RemoteNetworkConfig] :downloader_config Configuration for the download process (e.g., proxies, auth, timeouts). Only applicable when providing a &#39;file_url.
+    # @return [Array<(MavenMavenArtifactResponse, Integer, Hash)>] MavenMavenArtifactResponse data, response status code and response headers
+    def upload_with_http_info(relative_path, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContentArtifactApi.upload ...'
+      end
+      # verify the required parameter 'relative_path' is set
+      if @api_client.config.client_side_validation && relative_path.nil?
+        fail ArgumentError, "Missing the required parameter 'relative_path' when calling ContentArtifactApi.upload"
+      end
+      if @api_client.config.client_side_validation && relative_path.to_s.length < 1
+        fail ArgumentError, 'invalid value for "relative_path" when calling ContentArtifactApi.upload, the character length must be great than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'file_url'].nil? && opts[:'file_url'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"file_url"]" when calling ContentArtifactApi.upload, the character length must be great than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/pulp/api/v3/content/maven/artifact/upload/'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['multipart/form-data', 'application/x-www-form-urlencoded'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'X-Task-Diagnostics'] = @api_client.build_collection_param(opts[:'x_task_diagnostics'], :csv) if !opts[:'x_task_diagnostics'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+      form_params['relative_path'] = relative_path
+      form_params['repository'] = opts[:'repository'] if !opts[:'repository'].nil?
+      form_params['overwrite'] = opts[:'overwrite'] if !opts[:'overwrite'].nil?
+      form_params['pulp_labels'] = opts[:'pulp_labels'] if !opts[:'pulp_labels'].nil?
+      form_params['artifact'] = opts[:'artifact'] if !opts[:'artifact'].nil?
+      form_params['file'] = opts[:'file'] if !opts[:'file'].nil?
+      form_params['upload'] = opts[:'upload'] if !opts[:'upload'].nil?
+      form_params['file_url'] = opts[:'file_url'] if !opts[:'file_url'].nil?
+      form_params['downloader_config'] = opts[:'downloader_config'] if !opts[:'downloader_config'].nil?
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'MavenMavenArtifactResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['basicAuth']
+
+      new_options = opts.merge(
+        :operation => :"ContentArtifactApi.upload",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ContentArtifactApi#upload\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end