Skip to main content

Distributions API

All URIs are relative to http://localhost:1000

MethodHTTP requestDescription
distributions_create_new_distributionPOST /distributions/create/distributions/create [POST]
distributions_delete_specific_distributionPOST /distributions/{distribution}/delete/distributions/{distribution}/delete [POST]
distributions_snapshotGET /distributions/distributions [GET]

distributions_create_new_distribution​

Distribution distributions_create_new_distribution(seeded_distribution=seeded_distribution)

/distributions/create [POST]

This will create a new distribution.

Example​

import pieces_os_client
from pieces_os_client.models.distribution import Distribution
from pieces_os_client.models.seeded_distribution import SeededDistribution
from pieces_os_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost:1000
# See configuration.py for a list of all supported configuration parameters.
configuration = pieces_os_client.Configuration(
host="http://localhost:1000"
)


# Enter a context with an instance of the API client
with pieces_os_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = pieces_os_client.DistributionsApi(api_client)
seeded_distribution = pieces_os_client.SeededDistribution() # SeededDistribution | (optional)

try:
# /distributions/create [POST]
api_response = api_instance.distributions_create_new_distribution(seeded_distribution=seeded_distribution)
print("The response of DistributionsApi->distributions_create_new_distribution:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling DistributionsApi->distributions_create_new_distribution: %s\n" % e)

Parameters​

NameTypeDescriptionNotes
seeded_distributionSeededDistribution[optional]

Return type​

Distribution

Authorization​

No authorization required

HTTP request headers​

  • Content-Type: application/json
  • Accept: application/json, text/plain

HTTP response details​

Status codeDescriptionResponse headers
200OK-
500Internal Server Error-

distributions_delete_specific_distribution​

distributions_delete_specific_distribution(distribution)

/distributions/{distribution}/delete [POST]

This will delete a specific distribution.

Example​

import pieces_os_client
from pieces_os_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost:1000
# See configuration.py for a list of all supported configuration parameters.
configuration = pieces_os_client.Configuration(
host="http://localhost:1000"
)


# Enter a context with an instance of the API client
with pieces_os_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = pieces_os_client.DistributionsApi(api_client)
distribution = 'distribution_example' # str | This is the uuid of a specific distribution.

try:
# /distributions/\{distribution\}/delete [POST]
api_instance.distributions_delete_specific_distribution(distribution)
except Exception as e:
print("Exception when calling DistributionsApi->distributions_delete_specific_distribution: %s\n" % e)

Parameters​

NameTypeDescriptionNotes
distributionstrThis is the uuid of a specific distribution.

Return type​

void (empty response body)

Authorization​

No authorization required

HTTP request headers​

  • Content-Type: Not defined
  • Accept: text/plain

HTTP response details​

Status codeDescriptionResponse headers
204No Content-
500Internal Server Error-

distributions_snapshot​

Distributions distributions_snapshot()

/distributions [GET]

This will get a specific snapshot of all our distributions.

Example​

import pieces_os_client
from pieces_os_client.models.distributions import Distributions
from pieces_os_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost:1000
# See configuration.py for a list of all supported configuration parameters.
configuration = pieces_os_client.Configuration(
host="http://localhost:1000"
)


# Enter a context with an instance of the API client
with pieces_os_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = pieces_os_client.DistributionsApi(api_client)

try:
# /distributions [GET]
api_response = api_instance.distributions_snapshot()
print("The response of DistributionsApi->distributions_snapshot:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling DistributionsApi->distributions_snapshot: %s\n" % e)

Parameters​

This endpoint does not need any parameters.

Return type​

Distributions

Authorization​

No authorization required

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, text/plain

HTTP response details​

Status codeDescriptionResponse headers
200OK-
500Internal Server Error-