# PulpFileClient::AcsFileApi All URIs are relative to *http://localhost:24817* Method | HTTP request | Description ------------- | ------------- | ------------- [**acs_file_file_add_role**](AcsFileApi.md#acs_file_file_add_role) | **POST** {file_file_alternate_content_source_href}add_role/ | Add a role [**acs_file_file_create**](AcsFileApi.md#acs_file_file_create) | **POST** /pulp/api/v3/acs/file/file/ | Create a file alternate content source [**acs_file_file_delete**](AcsFileApi.md#acs_file_file_delete) | **DELETE** {file_file_alternate_content_source_href} | Delete a file alternate content source [**acs_file_file_list**](AcsFileApi.md#acs_file_file_list) | **GET** /pulp/api/v3/acs/file/file/ | List file alternate content sources [**acs_file_file_list_roles**](AcsFileApi.md#acs_file_file_list_roles) | **GET** {file_file_alternate_content_source_href}list_roles/ | List roles [**acs_file_file_my_permissions**](AcsFileApi.md#acs_file_file_my_permissions) | **GET** {file_file_alternate_content_source_href}my_permissions/ | List user permissions [**acs_file_file_partial_update**](AcsFileApi.md#acs_file_file_partial_update) | **PATCH** {file_file_alternate_content_source_href} | Update a file alternate content source [**acs_file_file_read**](AcsFileApi.md#acs_file_file_read) | **GET** {file_file_alternate_content_source_href} | Inspect a file alternate content source [**acs_file_file_refresh**](AcsFileApi.md#acs_file_file_refresh) | **POST** {file_file_alternate_content_source_href}refresh/ | Refresh metadata [**acs_file_file_remove_role**](AcsFileApi.md#acs_file_file_remove_role) | **POST** {file_file_alternate_content_source_href}remove_role/ | Remove a role [**acs_file_file_update**](AcsFileApi.md#acs_file_file_update) | **PUT** {file_file_alternate_content_source_href} | Update a file alternate content source ## acs_file_file_add_role > NestedRoleResponse acs_file_file_add_role(file_file_alternate_content_source_href, nested_role) Add a role Add a role for this object to users/groups. ### Example ```ruby # load the gem require 'pulp_file_client' # setup authorization PulpFileClient.configure do |config| # Configure HTTP basic authorization: basicAuth config.username = 'YOUR USERNAME' config.password = 'YOUR PASSWORD' end api_instance = PulpFileClient::AcsFileApi.new file_file_alternate_content_source_href = 'file_file_alternate_content_source_href_example' # String | nested_role = PulpFileClient::NestedRole.new # NestedRole | begin #Add a role result = api_instance.acs_file_file_add_role(file_file_alternate_content_source_href, nested_role) p result rescue PulpFileClient::ApiError => e puts "Exception when calling AcsFileApi->acs_file_file_add_role: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **file_file_alternate_content_source_href** | **String**| | **nested_role** | [**NestedRole**](NestedRole.md)| | ### Return type [**NestedRoleResponse**](NestedRoleResponse.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: application/json, application/x-www-form-urlencoded, multipart/form-data - **Accept**: application/json ## acs_file_file_create > FileFileAlternateContentSourceResponse acs_file_file_create(file_file_alternate_content_source) Create a file alternate content source Alternate Content Source ViewSet for File ACS support is provided as a tech preview in pulp_file. ### Example ```ruby # load the gem require 'pulp_file_client' # setup authorization PulpFileClient.configure do |config| # Configure HTTP basic authorization: basicAuth config.username = 'YOUR USERNAME' config.password = 'YOUR PASSWORD' end api_instance = PulpFileClient::AcsFileApi.new file_file_alternate_content_source = PulpFileClient::FileFileAlternateContentSource.new # FileFileAlternateContentSource | begin #Create a file alternate content source result = api_instance.acs_file_file_create(file_file_alternate_content_source) p result rescue PulpFileClient::ApiError => e puts "Exception when calling AcsFileApi->acs_file_file_create: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **file_file_alternate_content_source** | [**FileFileAlternateContentSource**](FileFileAlternateContentSource.md)| | ### Return type [**FileFileAlternateContentSourceResponse**](FileFileAlternateContentSourceResponse.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: application/json, application/x-www-form-urlencoded, multipart/form-data - **Accept**: application/json ## acs_file_file_delete > AsyncOperationResponse acs_file_file_delete(file_file_alternate_content_source_href) Delete a file alternate content source Trigger an asynchronous delete ACS task ### Example ```ruby # load the gem require 'pulp_file_client' # setup authorization PulpFileClient.configure do |config| # Configure HTTP basic authorization: basicAuth config.username = 'YOUR USERNAME' config.password = 'YOUR PASSWORD' end api_instance = PulpFileClient::AcsFileApi.new file_file_alternate_content_source_href = 'file_file_alternate_content_source_href_example' # String | begin #Delete a file alternate content source result = api_instance.acs_file_file_delete(file_file_alternate_content_source_href) p result rescue PulpFileClient::ApiError => e puts "Exception when calling AcsFileApi->acs_file_file_delete: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **file_file_alternate_content_source_href** | **String**| | ### Return type [**AsyncOperationResponse**](AsyncOperationResponse.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## acs_file_file_list > PaginatedfileFileAlternateContentSourceResponseList acs_file_file_list(opts) List file alternate content sources Alternate Content Source ViewSet for File ACS support is provided as a tech preview in pulp_file. ### Example ```ruby # load the gem require 'pulp_file_client' # setup authorization PulpFileClient.configure do |config| # Configure HTTP basic authorization: basicAuth config.username = 'YOUR USERNAME' config.password = 'YOUR PASSWORD' end api_instance = PulpFileClient::AcsFileApi.new opts = { limit: 56, # Integer | Number of results to return per page. name: 'name_example', # String | Filter results where name matches value name__contains: 'name__contains_example', # String | Filter results where name contains value name__icontains: 'name__icontains_example', # String | Filter results where name contains value name__iexact: 'name__iexact_example', # String | Filter results where name matches value name__in: ['name__in_example'], # Array | Filter results where name is in a comma-separated list of values name__iregex: 'name__iregex_example', # String | Filter results where name matches regex value name__istartswith: 'name__istartswith_example', # String | Filter results where name starts with value name__regex: 'name__regex_example', # String | Filter results where name matches regex value name__startswith: 'name__startswith_example', # String | Filter results where name starts with value offset: 56, # Integer | The initial index from which to return the results. ordering: ['ordering_example'], # Array | Ordering * `pulp_id` - Pulp id * `-pulp_id` - Pulp id (descending) * `pulp_created` - Pulp created * `-pulp_created` - Pulp created (descending) * `pulp_last_updated` - Pulp last updated * `-pulp_last_updated` - Pulp last updated (descending) * `pulp_type` - Pulp type * `-pulp_type` - Pulp type (descending) * `name` - Name * `-name` - Name (descending) * `last_refreshed` - Last refreshed * `-last_refreshed` - Last refreshed (descending) * `pk` - Pk * `-pk` - Pk (descending) pulp_href__in: ['pulp_href__in_example'], # Array | Multiple values may be separated by commas. pulp_id__in: ['pulp_id__in_example'], # Array | Multiple values may be separated by commas. q: 'q_example', # String | fields: ['fields_example'], # Array | A list of fields to include in the response. exclude_fields: ['exclude_fields_example'] # Array | A list of fields to exclude from the response. } begin #List file alternate content sources result = api_instance.acs_file_file_list(opts) p result rescue PulpFileClient::ApiError => e puts "Exception when calling AcsFileApi->acs_file_file_list: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **limit** | **Integer**| Number of results to return per page. | [optional] **name** | **String**| Filter results where name matches value | [optional] **name__contains** | **String**| Filter results where name contains value | [optional] **name__icontains** | **String**| Filter results where name contains value | [optional] **name__iexact** | **String**| Filter results where name matches value | [optional] **name__in** | [**Array<String>**](String.md)| Filter results where name is in a comma-separated list of values | [optional] **name__iregex** | **String**| Filter results where name matches regex value | [optional] **name__istartswith** | **String**| Filter results where name starts with value | [optional] **name__regex** | **String**| Filter results where name matches regex value | [optional] **name__startswith** | **String**| Filter results where name starts with value | [optional] **offset** | **Integer**| The initial index from which to return the results. | [optional] **ordering** | [**Array<String>**](String.md)| Ordering * `pulp_id` - Pulp id * `-pulp_id` - Pulp id (descending) * `pulp_created` - Pulp created * `-pulp_created` - Pulp created (descending) * `pulp_last_updated` - Pulp last updated * `-pulp_last_updated` - Pulp last updated (descending) * `pulp_type` - Pulp type * `-pulp_type` - Pulp type (descending) * `name` - Name * `-name` - Name (descending) * `last_refreshed` - Last refreshed * `-last_refreshed` - Last refreshed (descending) * `pk` - Pk * `-pk` - Pk (descending) | [optional] **pulp_href__in** | [**Array<String>**](String.md)| Multiple values may be separated by commas. | [optional] **pulp_id__in** | [**Array<String>**](String.md)| Multiple values may be separated by commas. | [optional] **q** | **String**| | [optional] **fields** | [**Array<String>**](String.md)| A list of fields to include in the response. | [optional] **exclude_fields** | [**Array<String>**](String.md)| A list of fields to exclude from the response. | [optional] ### Return type [**PaginatedfileFileAlternateContentSourceResponseList**](PaginatedfileFileAlternateContentSourceResponseList.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## acs_file_file_list_roles > ObjectRolesResponse acs_file_file_list_roles(file_file_alternate_content_source_href, opts) List roles List roles assigned to this object. ### Example ```ruby # load the gem require 'pulp_file_client' # setup authorization PulpFileClient.configure do |config| # Configure HTTP basic authorization: basicAuth config.username = 'YOUR USERNAME' config.password = 'YOUR PASSWORD' end api_instance = PulpFileClient::AcsFileApi.new file_file_alternate_content_source_href = 'file_file_alternate_content_source_href_example' # String | opts = { fields: ['fields_example'], # Array | A list of fields to include in the response. exclude_fields: ['exclude_fields_example'] # Array | A list of fields to exclude from the response. } begin #List roles result = api_instance.acs_file_file_list_roles(file_file_alternate_content_source_href, opts) p result rescue PulpFileClient::ApiError => e puts "Exception when calling AcsFileApi->acs_file_file_list_roles: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **file_file_alternate_content_source_href** | **String**| | **fields** | [**Array<String>**](String.md)| A list of fields to include in the response. | [optional] **exclude_fields** | [**Array<String>**](String.md)| A list of fields to exclude from the response. | [optional] ### Return type [**ObjectRolesResponse**](ObjectRolesResponse.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## acs_file_file_my_permissions > MyPermissionsResponse acs_file_file_my_permissions(file_file_alternate_content_source_href, opts) List user permissions List permissions available to the current user on this object. ### Example ```ruby # load the gem require 'pulp_file_client' # setup authorization PulpFileClient.configure do |config| # Configure HTTP basic authorization: basicAuth config.username = 'YOUR USERNAME' config.password = 'YOUR PASSWORD' end api_instance = PulpFileClient::AcsFileApi.new file_file_alternate_content_source_href = 'file_file_alternate_content_source_href_example' # String | opts = { fields: ['fields_example'], # Array | A list of fields to include in the response. exclude_fields: ['exclude_fields_example'] # Array | A list of fields to exclude from the response. } begin #List user permissions result = api_instance.acs_file_file_my_permissions(file_file_alternate_content_source_href, opts) p result rescue PulpFileClient::ApiError => e puts "Exception when calling AcsFileApi->acs_file_file_my_permissions: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **file_file_alternate_content_source_href** | **String**| | **fields** | [**Array<String>**](String.md)| A list of fields to include in the response. | [optional] **exclude_fields** | [**Array<String>**](String.md)| A list of fields to exclude from the response. | [optional] ### Return type [**MyPermissionsResponse**](MyPermissionsResponse.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## acs_file_file_partial_update > AsyncOperationResponse acs_file_file_partial_update(file_file_alternate_content_source_href, patchedfile_file_alternate_content_source) Update a file alternate content source Trigger an asynchronous partial update task ### Example ```ruby # load the gem require 'pulp_file_client' # setup authorization PulpFileClient.configure do |config| # Configure HTTP basic authorization: basicAuth config.username = 'YOUR USERNAME' config.password = 'YOUR PASSWORD' end api_instance = PulpFileClient::AcsFileApi.new file_file_alternate_content_source_href = 'file_file_alternate_content_source_href_example' # String | patchedfile_file_alternate_content_source = PulpFileClient::PatchedfileFileAlternateContentSource.new # PatchedfileFileAlternateContentSource | begin #Update a file alternate content source result = api_instance.acs_file_file_partial_update(file_file_alternate_content_source_href, patchedfile_file_alternate_content_source) p result rescue PulpFileClient::ApiError => e puts "Exception when calling AcsFileApi->acs_file_file_partial_update: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **file_file_alternate_content_source_href** | **String**| | **patchedfile_file_alternate_content_source** | [**PatchedfileFileAlternateContentSource**](PatchedfileFileAlternateContentSource.md)| | ### Return type [**AsyncOperationResponse**](AsyncOperationResponse.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: application/json, application/x-www-form-urlencoded, multipart/form-data - **Accept**: application/json ## acs_file_file_read > FileFileAlternateContentSourceResponse acs_file_file_read(file_file_alternate_content_source_href, opts) Inspect a file alternate content source Alternate Content Source ViewSet for File ACS support is provided as a tech preview in pulp_file. ### Example ```ruby # load the gem require 'pulp_file_client' # setup authorization PulpFileClient.configure do |config| # Configure HTTP basic authorization: basicAuth config.username = 'YOUR USERNAME' config.password = 'YOUR PASSWORD' end api_instance = PulpFileClient::AcsFileApi.new file_file_alternate_content_source_href = 'file_file_alternate_content_source_href_example' # String | opts = { fields: ['fields_example'], # Array | A list of fields to include in the response. exclude_fields: ['exclude_fields_example'] # Array | A list of fields to exclude from the response. } begin #Inspect a file alternate content source result = api_instance.acs_file_file_read(file_file_alternate_content_source_href, opts) p result rescue PulpFileClient::ApiError => e puts "Exception when calling AcsFileApi->acs_file_file_read: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **file_file_alternate_content_source_href** | **String**| | **fields** | [**Array<String>**](String.md)| A list of fields to include in the response. | [optional] **exclude_fields** | [**Array<String>**](String.md)| A list of fields to exclude from the response. | [optional] ### Return type [**FileFileAlternateContentSourceResponse**](FileFileAlternateContentSourceResponse.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## acs_file_file_refresh > TaskGroupOperationResponse acs_file_file_refresh(file_file_alternate_content_source_href) Refresh metadata Trigger an asynchronous task to create Alternate Content Source content. ### Example ```ruby # load the gem require 'pulp_file_client' # setup authorization PulpFileClient.configure do |config| # Configure HTTP basic authorization: basicAuth config.username = 'YOUR USERNAME' config.password = 'YOUR PASSWORD' end api_instance = PulpFileClient::AcsFileApi.new file_file_alternate_content_source_href = 'file_file_alternate_content_source_href_example' # String | begin #Refresh metadata result = api_instance.acs_file_file_refresh(file_file_alternate_content_source_href) p result rescue PulpFileClient::ApiError => e puts "Exception when calling AcsFileApi->acs_file_file_refresh: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **file_file_alternate_content_source_href** | **String**| | ### Return type [**TaskGroupOperationResponse**](TaskGroupOperationResponse.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## acs_file_file_remove_role > NestedRoleResponse acs_file_file_remove_role(file_file_alternate_content_source_href, nested_role) Remove a role Remove a role for this object from users/groups. ### Example ```ruby # load the gem require 'pulp_file_client' # setup authorization PulpFileClient.configure do |config| # Configure HTTP basic authorization: basicAuth config.username = 'YOUR USERNAME' config.password = 'YOUR PASSWORD' end api_instance = PulpFileClient::AcsFileApi.new file_file_alternate_content_source_href = 'file_file_alternate_content_source_href_example' # String | nested_role = PulpFileClient::NestedRole.new # NestedRole | begin #Remove a role result = api_instance.acs_file_file_remove_role(file_file_alternate_content_source_href, nested_role) p result rescue PulpFileClient::ApiError => e puts "Exception when calling AcsFileApi->acs_file_file_remove_role: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **file_file_alternate_content_source_href** | **String**| | **nested_role** | [**NestedRole**](NestedRole.md)| | ### Return type [**NestedRoleResponse**](NestedRoleResponse.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: application/json, application/x-www-form-urlencoded, multipart/form-data - **Accept**: application/json ## acs_file_file_update > AsyncOperationResponse acs_file_file_update(file_file_alternate_content_source_href, file_file_alternate_content_source) Update a file alternate content source Trigger an asynchronous update task ### Example ```ruby # load the gem require 'pulp_file_client' # setup authorization PulpFileClient.configure do |config| # Configure HTTP basic authorization: basicAuth config.username = 'YOUR USERNAME' config.password = 'YOUR PASSWORD' end api_instance = PulpFileClient::AcsFileApi.new file_file_alternate_content_source_href = 'file_file_alternate_content_source_href_example' # String | file_file_alternate_content_source = PulpFileClient::FileFileAlternateContentSource.new # FileFileAlternateContentSource | begin #Update a file alternate content source result = api_instance.acs_file_file_update(file_file_alternate_content_source_href, file_file_alternate_content_source) p result rescue PulpFileClient::ApiError => e puts "Exception when calling AcsFileApi->acs_file_file_update: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **file_file_alternate_content_source_href** | **String**| | **file_file_alternate_content_source** | [**FileFileAlternateContentSource**](FileFileAlternateContentSource.md)| | ### Return type [**AsyncOperationResponse**](AsyncOperationResponse.md) ### Authorization [basicAuth](../README.md#basicAuth) ### HTTP request headers - **Content-Type**: application/json, application/x-www-form-urlencoded, multipart/form-data - **Accept**: application/json