# PulpContainerClient::DistributionsContainerApi

All URIs are relative to *http://localhost:24817*

Method | HTTP request | Description
------------- | ------------- | -------------
[**distributions_container_container_add_role**](DistributionsContainerApi.md#distributions_container_container_add_role) | **POST** {container_container_distribution_href}add_role/ | 
[**distributions_container_container_create**](DistributionsContainerApi.md#distributions_container_container_create) | **POST** /pulp/api/v3/distributions/container/container/ | Create a container distribution
[**distributions_container_container_delete**](DistributionsContainerApi.md#distributions_container_container_delete) | **DELETE** {container_container_distribution_href} | Delete a container distribution
[**distributions_container_container_list**](DistributionsContainerApi.md#distributions_container_container_list) | **GET** /pulp/api/v3/distributions/container/container/ | List container distributions
[**distributions_container_container_list_roles**](DistributionsContainerApi.md#distributions_container_container_list_roles) | **GET** {container_container_distribution_href}list_roles/ | 
[**distributions_container_container_my_permissions**](DistributionsContainerApi.md#distributions_container_container_my_permissions) | **GET** {container_container_distribution_href}my_permissions/ | 
[**distributions_container_container_partial_update**](DistributionsContainerApi.md#distributions_container_container_partial_update) | **PATCH** {container_container_distribution_href} | Update a container distribution
[**distributions_container_container_read**](DistributionsContainerApi.md#distributions_container_container_read) | **GET** {container_container_distribution_href} | Inspect a container distribution
[**distributions_container_container_remove_role**](DistributionsContainerApi.md#distributions_container_container_remove_role) | **POST** {container_container_distribution_href}remove_role/ | 
[**distributions_container_container_update**](DistributionsContainerApi.md#distributions_container_container_update) | **PUT** {container_container_distribution_href} | Update a container distribution



## distributions_container_container_add_role

> NestedRoleResponse distributions_container_container_add_role(container_container_distribution_href, nested_role)



Add a role for this object to users/groups.

### Example

```ruby
# load the gem
require 'pulp_container_client'
# setup authorization
PulpContainerClient.configure do |config|
  # Configure HTTP basic authorization: basicAuth
  config.username = 'YOUR USERNAME'
  config.password = 'YOUR PASSWORD'
end

api_instance = PulpContainerClient::DistributionsContainerApi.new
container_container_distribution_href = 'container_container_distribution_href_example' # String | 
nested_role = PulpContainerClient::NestedRole.new # NestedRole | 

begin
  result = api_instance.distributions_container_container_add_role(container_container_distribution_href, nested_role)
  p result
rescue PulpContainerClient::ApiError => e
  puts "Exception when calling DistributionsContainerApi->distributions_container_container_add_role: #{e}"
end
```

### Parameters


Name | Type | Description  | Notes
------------- | ------------- | ------------- | -------------
 **container_container_distribution_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


## distributions_container_container_create

> AsyncOperationResponse distributions_container_container_create(container_container_distribution)

Create a container distribution

Trigger an asynchronous create task

### Example

```ruby
# load the gem
require 'pulp_container_client'
# setup authorization
PulpContainerClient.configure do |config|
  # Configure HTTP basic authorization: basicAuth
  config.username = 'YOUR USERNAME'
  config.password = 'YOUR PASSWORD'
end

api_instance = PulpContainerClient::DistributionsContainerApi.new
container_container_distribution = PulpContainerClient::ContainerContainerDistribution.new # ContainerContainerDistribution | 

begin
  #Create a container distribution
  result = api_instance.distributions_container_container_create(container_container_distribution)
  p result
rescue PulpContainerClient::ApiError => e
  puts "Exception when calling DistributionsContainerApi->distributions_container_container_create: #{e}"
end
```

### Parameters


Name | Type | Description  | Notes
------------- | ------------- | ------------- | -------------
 **container_container_distribution** | [**ContainerContainerDistribution**](ContainerContainerDistribution.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


## distributions_container_container_delete

> AsyncOperationResponse distributions_container_container_delete(container_container_distribution_href)

Delete a container distribution

Trigger an asynchronous delete task

### Example

```ruby
# load the gem
require 'pulp_container_client'
# setup authorization
PulpContainerClient.configure do |config|
  # Configure HTTP basic authorization: basicAuth
  config.username = 'YOUR USERNAME'
  config.password = 'YOUR PASSWORD'
end

api_instance = PulpContainerClient::DistributionsContainerApi.new
container_container_distribution_href = 'container_container_distribution_href_example' # String | 

begin
  #Delete a container distribution
  result = api_instance.distributions_container_container_delete(container_container_distribution_href)
  p result
rescue PulpContainerClient::ApiError => e
  puts "Exception when calling DistributionsContainerApi->distributions_container_container_delete: #{e}"
end
```

### Parameters


Name | Type | Description  | Notes
------------- | ------------- | ------------- | -------------
 **container_container_distribution_href** | **String**|  | 

### Return type

[**AsyncOperationResponse**](AsyncOperationResponse.md)

### Authorization

[basicAuth](../README.md#basicAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json


## distributions_container_container_list

> PaginatedcontainerContainerDistributionResponseList distributions_container_container_list(opts)

List container distributions

The Container Distribution will serve the latest version of a Repository if ``repository`` is specified. The Container Distribution will serve a specific repository version if ``repository_version``. Note that **either** ``repository`` or ``repository_version`` can be set on a Container Distribution, but not both.

### Example

```ruby
# load the gem
require 'pulp_container_client'
# setup authorization
PulpContainerClient.configure do |config|
  # Configure HTTP basic authorization: basicAuth
  config.username = 'YOUR USERNAME'
  config.password = 'YOUR PASSWORD'
end

api_instance = PulpContainerClient::DistributionsContainerApi.new
opts = {
  base_path: 'base_path_example', # String | Filter results where base_path matches value
  base_path__contains: 'base_path__contains_example', # String | Filter results where base_path contains value
  base_path__icontains: 'base_path__icontains_example', # String | Filter results where base_path contains value
  base_path__in: ['base_path__in_example'], # Array<String> | Filter results where base_path is in a comma-separated list of values
  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__in: ['name__in_example'], # Array<String> | Filter results where name is in a comma-separated list of values
  name__startswith: 'name__startswith_example', # String | Filter results where name starts with value
  namespace__name: 'namespace__name_example', # String | 
  offset: 56, # Integer | The initial index from which to return the results.
  ordering: ['ordering_example'], # Array<String> | Ordering
  pulp_label_select: 'pulp_label_select_example', # String | Filter labels by search string
  with_content: 'with_content_example', # String | Filter distributions based on the content served by them
  fields: ['fields_example'], # Array<String> | A list of fields to include in the response.
  exclude_fields: ['exclude_fields_example'] # Array<String> | A list of fields to exclude from the response.
}

begin
  #List container distributions
  result = api_instance.distributions_container_container_list(opts)
  p result
rescue PulpContainerClient::ApiError => e
  puts "Exception when calling DistributionsContainerApi->distributions_container_container_list: #{e}"
end
```

### Parameters


Name | Type | Description  | Notes
------------- | ------------- | ------------- | -------------
 **base_path** | **String**| Filter results where base_path matches value | [optional] 
 **base_path__contains** | **String**| Filter results where base_path contains value | [optional] 
 **base_path__icontains** | **String**| Filter results where base_path contains value | [optional] 
 **base_path__in** | [**Array&lt;String&gt;**](String.md)| Filter results where base_path is in a comma-separated list of values | [optional] 
 **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__in** | [**Array&lt;String&gt;**](String.md)| Filter results where name is in a comma-separated list of values | [optional] 
 **name__startswith** | **String**| Filter results where name starts with value | [optional] 
 **namespace__name** | **String**|  | [optional] 
 **offset** | **Integer**| The initial index from which to return the results. | [optional] 
 **ordering** | [**Array&lt;String&gt;**](String.md)| Ordering | [optional] 
 **pulp_label_select** | **String**| Filter labels by search string | [optional] 
 **with_content** | **String**| Filter distributions based on the content served by them | [optional] 
 **fields** | [**Array&lt;String&gt;**](String.md)| A list of fields to include in the response. | [optional] 
 **exclude_fields** | [**Array&lt;String&gt;**](String.md)| A list of fields to exclude from the response. | [optional] 

### Return type

[**PaginatedcontainerContainerDistributionResponseList**](PaginatedcontainerContainerDistributionResponseList.md)

### Authorization

[basicAuth](../README.md#basicAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json


## distributions_container_container_list_roles

> ObjectRolesResponse distributions_container_container_list_roles(container_container_distribution_href, opts)



List roles assigned to this object.

### Example

```ruby
# load the gem
require 'pulp_container_client'
# setup authorization
PulpContainerClient.configure do |config|
  # Configure HTTP basic authorization: basicAuth
  config.username = 'YOUR USERNAME'
  config.password = 'YOUR PASSWORD'
end

api_instance = PulpContainerClient::DistributionsContainerApi.new
container_container_distribution_href = 'container_container_distribution_href_example' # String | 
opts = {
  fields: ['fields_example'], # Array<String> | A list of fields to include in the response.
  exclude_fields: ['exclude_fields_example'] # Array<String> | A list of fields to exclude from the response.
}

begin
  result = api_instance.distributions_container_container_list_roles(container_container_distribution_href, opts)
  p result
rescue PulpContainerClient::ApiError => e
  puts "Exception when calling DistributionsContainerApi->distributions_container_container_list_roles: #{e}"
end
```

### Parameters


Name | Type | Description  | Notes
------------- | ------------- | ------------- | -------------
 **container_container_distribution_href** | **String**|  | 
 **fields** | [**Array&lt;String&gt;**](String.md)| A list of fields to include in the response. | [optional] 
 **exclude_fields** | [**Array&lt;String&gt;**](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


## distributions_container_container_my_permissions

> MyPermissionsResponse distributions_container_container_my_permissions(container_container_distribution_href, opts)



List permissions available to the current user on this object.

### Example

```ruby
# load the gem
require 'pulp_container_client'
# setup authorization
PulpContainerClient.configure do |config|
  # Configure HTTP basic authorization: basicAuth
  config.username = 'YOUR USERNAME'
  config.password = 'YOUR PASSWORD'
end

api_instance = PulpContainerClient::DistributionsContainerApi.new
container_container_distribution_href = 'container_container_distribution_href_example' # String | 
opts = {
  fields: ['fields_example'], # Array<String> | A list of fields to include in the response.
  exclude_fields: ['exclude_fields_example'] # Array<String> | A list of fields to exclude from the response.
}

begin
  result = api_instance.distributions_container_container_my_permissions(container_container_distribution_href, opts)
  p result
rescue PulpContainerClient::ApiError => e
  puts "Exception when calling DistributionsContainerApi->distributions_container_container_my_permissions: #{e}"
end
```

### Parameters


Name | Type | Description  | Notes
------------- | ------------- | ------------- | -------------
 **container_container_distribution_href** | **String**|  | 
 **fields** | [**Array&lt;String&gt;**](String.md)| A list of fields to include in the response. | [optional] 
 **exclude_fields** | [**Array&lt;String&gt;**](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


## distributions_container_container_partial_update

> AsyncOperationResponse distributions_container_container_partial_update(container_container_distribution_href, patchedcontainer_container_distribution)

Update a container distribution

Trigger an asynchronous partial update task

### Example

```ruby
# load the gem
require 'pulp_container_client'
# setup authorization
PulpContainerClient.configure do |config|
  # Configure HTTP basic authorization: basicAuth
  config.username = 'YOUR USERNAME'
  config.password = 'YOUR PASSWORD'
end

api_instance = PulpContainerClient::DistributionsContainerApi.new
container_container_distribution_href = 'container_container_distribution_href_example' # String | 
patchedcontainer_container_distribution = PulpContainerClient::PatchedcontainerContainerDistribution.new # PatchedcontainerContainerDistribution | 

begin
  #Update a container distribution
  result = api_instance.distributions_container_container_partial_update(container_container_distribution_href, patchedcontainer_container_distribution)
  p result
rescue PulpContainerClient::ApiError => e
  puts "Exception when calling DistributionsContainerApi->distributions_container_container_partial_update: #{e}"
end
```

### Parameters


Name | Type | Description  | Notes
------------- | ------------- | ------------- | -------------
 **container_container_distribution_href** | **String**|  | 
 **patchedcontainer_container_distribution** | [**PatchedcontainerContainerDistribution**](PatchedcontainerContainerDistribution.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


## distributions_container_container_read

> ContainerContainerDistributionResponse distributions_container_container_read(container_container_distribution_href, opts)

Inspect a container distribution

The Container Distribution will serve the latest version of a Repository if ``repository`` is specified. The Container Distribution will serve a specific repository version if ``repository_version``. Note that **either** ``repository`` or ``repository_version`` can be set on a Container Distribution, but not both.

### Example

```ruby
# load the gem
require 'pulp_container_client'
# setup authorization
PulpContainerClient.configure do |config|
  # Configure HTTP basic authorization: basicAuth
  config.username = 'YOUR USERNAME'
  config.password = 'YOUR PASSWORD'
end

api_instance = PulpContainerClient::DistributionsContainerApi.new
container_container_distribution_href = 'container_container_distribution_href_example' # String | 
opts = {
  fields: ['fields_example'], # Array<String> | A list of fields to include in the response.
  exclude_fields: ['exclude_fields_example'] # Array<String> | A list of fields to exclude from the response.
}

begin
  #Inspect a container distribution
  result = api_instance.distributions_container_container_read(container_container_distribution_href, opts)
  p result
rescue PulpContainerClient::ApiError => e
  puts "Exception when calling DistributionsContainerApi->distributions_container_container_read: #{e}"
end
```

### Parameters


Name | Type | Description  | Notes
------------- | ------------- | ------------- | -------------
 **container_container_distribution_href** | **String**|  | 
 **fields** | [**Array&lt;String&gt;**](String.md)| A list of fields to include in the response. | [optional] 
 **exclude_fields** | [**Array&lt;String&gt;**](String.md)| A list of fields to exclude from the response. | [optional] 

### Return type

[**ContainerContainerDistributionResponse**](ContainerContainerDistributionResponse.md)

### Authorization

[basicAuth](../README.md#basicAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json


## distributions_container_container_remove_role

> NestedRoleResponse distributions_container_container_remove_role(container_container_distribution_href, nested_role)



Remove a role for this object from users/groups.

### Example

```ruby
# load the gem
require 'pulp_container_client'
# setup authorization
PulpContainerClient.configure do |config|
  # Configure HTTP basic authorization: basicAuth
  config.username = 'YOUR USERNAME'
  config.password = 'YOUR PASSWORD'
end

api_instance = PulpContainerClient::DistributionsContainerApi.new
container_container_distribution_href = 'container_container_distribution_href_example' # String | 
nested_role = PulpContainerClient::NestedRole.new # NestedRole | 

begin
  result = api_instance.distributions_container_container_remove_role(container_container_distribution_href, nested_role)
  p result
rescue PulpContainerClient::ApiError => e
  puts "Exception when calling DistributionsContainerApi->distributions_container_container_remove_role: #{e}"
end
```

### Parameters


Name | Type | Description  | Notes
------------- | ------------- | ------------- | -------------
 **container_container_distribution_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


## distributions_container_container_update

> AsyncOperationResponse distributions_container_container_update(container_container_distribution_href, container_container_distribution)

Update a container distribution

Trigger an asynchronous update task

### Example

```ruby
# load the gem
require 'pulp_container_client'
# setup authorization
PulpContainerClient.configure do |config|
  # Configure HTTP basic authorization: basicAuth
  config.username = 'YOUR USERNAME'
  config.password = 'YOUR PASSWORD'
end

api_instance = PulpContainerClient::DistributionsContainerApi.new
container_container_distribution_href = 'container_container_distribution_href_example' # String | 
container_container_distribution = PulpContainerClient::ContainerContainerDistribution.new # ContainerContainerDistribution | 

begin
  #Update a container distribution
  result = api_instance.distributions_container_container_update(container_container_distribution_href, container_container_distribution)
  p result
rescue PulpContainerClient::ApiError => e
  puts "Exception when calling DistributionsContainerApi->distributions_container_container_update: #{e}"
end
```

### Parameters


Name | Type | Description  | Notes
------------- | ------------- | ------------- | -------------
 **container_container_distribution_href** | **String**|  | 
 **container_container_distribution** | [**ContainerContainerDistribution**](ContainerContainerDistribution.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