Documentation/ImageAnalysisApi.md
# thamos.swagger_client.ImageAnalysisApi
All URIs are relative to https://test.thoth-station.ninja/api/v1
Method | HTTP request | Description
------------- | ------------- | -------------
[**get_analyze**](ImageAnalysisApi.md#get_analyze) | **GET** /analyze/{analysis_id} | Retrieve an analyzer result
[**get_analyze_by_hash**](ImageAnalysisApi.md#get_analyze_by_hash) | **GET** /analyze/by-hash/{image_hash} | Retrieve an analyzer result
[**get_analyze_log**](ImageAnalysisApi.md#get_analyze_log) | **GET** /analyze/{analysis_id}/log | Show logs of an analysis
[**get_analyze_status**](ImageAnalysisApi.md#get_analyze_status) | **GET** /analyze/{analysis_id}/status | Show an analysis status
[**post_analyze**](ImageAnalysisApi.md#post_analyze) | **POST** /analyze | Analyze the given image asynchronously
[**post_image_metadata**](ImageAnalysisApi.md#post_image_metadata) | **POST** /image/metadata | Get metadata for the given image
# **get_analyze**
> AnalysisResultResponse get_analyze(analysis_id)
Retrieve an analyzer result
### Example
```python
from __future__ import print_function
import time
import thamos.swagger_client
from thamos.swagger_client.rest import ApiException
from pprint import pprint
# create an instance of the API class
api_instance = thamos.swagger_client.ImageAnalysisApi()
analysis_id = 'analysis_id_example' # str | An identifier of the requested analysis
try:
# Retrieve an analyzer result
api_response = api_instance.get_analyze(analysis_id)
pprint(api_response)
except ApiException as e:
print("Exception when calling ImageAnalysisApi->get_analyze: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**analysis_id** | **str**| An identifier of the requested analysis |
### Return type
[**AnalysisResultResponse**](AnalysisResultResponse.md)
### Authorization
No authorization required
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
# **get_analyze_by_hash**
> AnalysisResultResponse get_analyze_by_hash(image_hash)
Retrieve an analyzer result
### Example
```python
from __future__ import print_function
import time
import thamos.swagger_client
from thamos.swagger_client.rest import ApiException
from pprint import pprint
# create an instance of the API class
api_instance = thamos.swagger_client.ImageAnalysisApi()
image_hash = 'image_hash_example' # str | Image hash for identifying image (including hash type, now supported only \"sha256\")
try:
# Retrieve an analyzer result
api_response = api_instance.get_analyze_by_hash(image_hash)
pprint(api_response)
except ApiException as e:
print("Exception when calling ImageAnalysisApi->get_analyze_by_hash: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**image_hash** | **str**| Image hash for identifying image (including hash type, now supported only \"sha256\") |
### Return type
[**AnalysisResultResponse**](AnalysisResultResponse.md)
### Authorization
No authorization required
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
# **get_analyze_log**
> AnalysisLogResponse get_analyze_log(analysis_id)
Show logs of an analysis
### Example
```python
from __future__ import print_function
import time
import thamos.swagger_client
from thamos.swagger_client.rest import ApiException
from pprint import pprint
# create an instance of the API class
api_instance = thamos.swagger_client.ImageAnalysisApi()
analysis_id = 'analysis_id_example' # str | An identifier of the requested analysis
try:
# Show logs of an analysis
api_response = api_instance.get_analyze_log(analysis_id)
pprint(api_response)
except ApiException as e:
print("Exception when calling ImageAnalysisApi->get_analyze_log: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**analysis_id** | **str**| An identifier of the requested analysis |
### Return type
[**AnalysisLogResponse**](AnalysisLogResponse.md)
### Authorization
No authorization required
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
# **get_analyze_status**
> AnalysisStatusResponse get_analyze_status(analysis_id)
Show an analysis status
### Example
```python
from __future__ import print_function
import time
import thamos.swagger_client
from thamos.swagger_client.rest import ApiException
from pprint import pprint
# create an instance of the API class
api_instance = thamos.swagger_client.ImageAnalysisApi()
analysis_id = 'analysis_id_example' # str | An identifier of the requested analysis
try:
# Show an analysis status
api_response = api_instance.get_analyze_status(analysis_id)
pprint(api_response)
except ApiException as e:
print("Exception when calling ImageAnalysisApi->get_analyze_status: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**analysis_id** | **str**| An identifier of the requested analysis |
### Return type
[**AnalysisStatusResponse**](AnalysisStatusResponse.md)
### Authorization
No authorization required
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
# **post_analyze**
> AnalysisResponse post_analyze(image, registry_user=registry_user, registry_password=registry_password, environment_type=environment_type, origin=origin, debug=debug, verify_tls=verify_tls, force=force)
Analyze the given image asynchronously
### Example
```python
from __future__ import print_function
import time
import thamos.swagger_client
from thamos.swagger_client.rest import ApiException
from pprint import pprint
# create an instance of the API class
api_instance = thamos.swagger_client.ImageAnalysisApi()
image = 'image_example' # str | Name of an image - can also specify remote registry to pull image from
registry_user = 'registry_user_example' # str | Registry user to be used for pulling images from registry (optional)
registry_password = 'registry_password_example' # str | Registry password or token to be used for pulling images from registry (optional)
environment_type = 'runtime' # str | Type of environment (runtime or buildtime) which is being analyzed (optional) (default to runtime)
origin = 'origin_example' # str | A remote where the image is being used (optional)
debug = false # bool | Run the given analyzer in a verbose mode so developers can debug it (optional) (default to false)
verify_tls = true # bool | Verify TLS certificates of registry from where images are pulled from (optional) (default to true)
force = false # bool | Do not use cached results, always run the analysis (optional) (default to false)
try:
# Analyze the given image asynchronously
api_response = api_instance.post_analyze(image, registry_user=registry_user, registry_password=registry_password, environment_type=environment_type, origin=origin, debug=debug, verify_tls=verify_tls, force=force)
pprint(api_response)
except ApiException as e:
print("Exception when calling ImageAnalysisApi->post_analyze: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**image** | **str**| Name of an image - can also specify remote registry to pull image from |
**registry_user** | **str**| Registry user to be used for pulling images from registry | [optional]
**registry_password** | **str**| Registry password or token to be used for pulling images from registry | [optional]
**environment_type** | **str**| Type of environment (runtime or buildtime) which is being analyzed | [optional] [default to runtime]
**origin** | **str**| A remote where the image is being used | [optional]
**debug** | **bool**| Run the given analyzer in a verbose mode so developers can debug it | [optional] [default to false]
**verify_tls** | **bool**| Verify TLS certificates of registry from where images are pulled from | [optional] [default to true]
**force** | **bool**| Do not use cached results, always run the analysis | [optional] [default to false]
### Return type
[**AnalysisResponse**](AnalysisResponse.md)
### Authorization
No authorization required
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
# **post_image_metadata**
> ImageMetadataResponse post_image_metadata(image, registry_user=registry_user, registry_password=registry_password, verify_tls=verify_tls)
Get metadata for the given image
### Example
```python
from __future__ import print_function
import time
import thamos.swagger_client
from thamos.swagger_client.rest import ApiException
from pprint import pprint
# create an instance of the API class
api_instance = thamos.swagger_client.ImageAnalysisApi()
image = 'image_example' # str | Name of an image - can also specify remote registry to pull image from
registry_user = 'registry_user_example' # str | Registry user to be used for pulling images from registry (optional)
registry_password = 'registry_password_example' # str | Registry password or token to be used for pulling images from registry (optional)
verify_tls = true # bool | Verify TLS certificates of registry from where images are pulled from (optional) (default to true)
try:
# Get metadata for the given image
api_response = api_instance.post_image_metadata(image, registry_user=registry_user, registry_password=registry_password, verify_tls=verify_tls)
pprint(api_response)
except ApiException as e:
print("Exception when calling ImageAnalysisApi->post_image_metadata: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**image** | **str**| Name of an image - can also specify remote registry to pull image from |
**registry_user** | **str**| Registry user to be used for pulling images from registry | [optional]
**registry_password** | **str**| Registry password or token to be used for pulling images from registry | [optional]
**verify_tls** | **bool**| Verify TLS certificates of registry from where images are pulled from | [optional] [default to true]
### Return type
[**ImageMetadataResponse**](ImageMetadataResponse.md)
### Authorization
No authorization required
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)