thousandeyes-sdk-python/endpoint/labels_api/docs/ManageLabelsApi.md

labels_api.ManageLabelsApi

All URIs are relative to https://api.thousandeyes.com

Method	HTTP request	Description
endpoint_label_delete	DELETE /v7/endpoint/labels/{id}	Deletes label
endpoint_label_get	GET /v7/endpoint/labels/{id}	Retrieve label
endpoint_label_update	PATCH /v7/endpoint/labels/{id}	Update label
endpoint_labels_list	GET /v7/endpoint/labels	List labels
v7_endpoint_labels_post	POST /v7/endpoint/labels	Create label

endpoint_label_delete

endpoint_label_delete(id)

Deletes label

Deletes the label from your account.

Example

• Bearer Authentication (BearerAuth):

import time
import os
import labels_api
from labels_api.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.thousandeyes.com
# See configuration.py for a list of all supported configuration parameters.
configuration = labels_api.Configuration(
    host = "https://api.thousandeyes.com"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization: BearerAuth
configuration = labels_api.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)

# Enter a context with an instance of the API client
with labels_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = labels_api.ManageLabelsApi(api_client)
    id = 'id_example' # str | The unique identifier of the label to operate on.

    try:
        # Deletes label
        api_instance.endpoint_label_delete(id)
    except Exception as e:
        print("Exception when calling ManageLabelsApi->endpoint_label_delete: %s\n" % e)

Parameters

Name	Type	Description	Notes
id	str	The unique identifier of the label to operate on.

Return type

void (empty response body)

Authorization

BearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/json, application/problem+json

HTTP response details

Status code	Description	Response headers
204	No content	-
401	Unauthorized	-
403	Insufficient permissions to query endpoint	-
404	Not found	-
429	Exhausted rate limit for the organization	-

[Back to top] [Back to API list] [Back to Model list] [Back to README]

endpoint_label_get

V7EndpointLabelsPost201Response endpoint_label_get(id, expand=expand)

Retrieve label

Returns a single label using its ID.

Example

• Bearer Authentication (BearerAuth):

import time
import os
import labels_api
from labels_api.models.expand import Expand
from labels_api.models.v7_endpoint_labels_post201_response import V7EndpointLabelsPost201Response
from labels_api.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.thousandeyes.com
# See configuration.py for a list of all supported configuration parameters.
configuration = labels_api.Configuration(
    host = "https://api.thousandeyes.com"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization: BearerAuth
configuration = labels_api.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)

# Enter a context with an instance of the API client
with labels_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = labels_api.ManageLabelsApi(api_client)
    id = 'id_example' # str | The unique identifier of the label to operate on.
    expand = [labels_api.Expand()] # List[Expand] | This parameter is optional and determines whether to include additional details in the response. To specify multiple expansions, you can either separate the values with commas or specify the parameter multiple times. (optional)

    try:
        # Retrieve label
        api_response = api_instance.endpoint_label_get(id, expand=expand)
        print("The response of ManageLabelsApi->endpoint_label_get:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling ManageLabelsApi->endpoint_label_get: %s\n" % e)

Parameters

Name	Type	Description	Notes
id	str	The unique identifier of the label to operate on.
expand	**List[Expand]**	This parameter is optional and determines whether to include additional details in the response. To specify multiple expansions, you can either separate the values with commas or specify the parameter multiple times.	[optional]

Return type

V7EndpointLabelsPost201Response

Authorization

BearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/hal+json, application/problem+json

HTTP response details

Status code	Description	Response headers
200	OK	-
401	Unauthorized	-
403	Insufficient permissions to query endpoint	-
404	Not found	-
429	Exhausted rate limit for the organization	-

[Back to top] [Back to API list] [Back to Model list] [Back to README]

endpoint_label_update

V7EndpointLabelsPost201Response endpoint_label_update(id, label=label)

Update label

Updates a label using its ID.

Example

• Bearer Authentication (BearerAuth):

import time
import os
import labels_api
from labels_api.models.label import Label
from labels_api.models.v7_endpoint_labels_post201_response import V7EndpointLabelsPost201Response
from labels_api.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.thousandeyes.com
# See configuration.py for a list of all supported configuration parameters.
configuration = labels_api.Configuration(
    host = "https://api.thousandeyes.com"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization: BearerAuth
configuration = labels_api.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)

# Enter a context with an instance of the API client
with labels_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = labels_api.ManageLabelsApi(api_client)
    id = 'id_example' # str | The unique identifier of the label to operate on.
    label = labels_api.Label() # Label | Fields to change on the agent (optional)

    try:
        # Update label
        api_response = api_instance.endpoint_label_update(id, label=label)
        print("The response of ManageLabelsApi->endpoint_label_update:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling ManageLabelsApi->endpoint_label_update: %s\n" % e)

Parameters

Name	Type	Description	Notes
id	str	The unique identifier of the label to operate on.
label	Label	Fields to change on the agent	[optional]

Return type

V7EndpointLabelsPost201Response

Authorization

BearerAuth

HTTP request headers

• Content-Type: application/json
• Accept: application/hal+json, application/problem+json

HTTP response details

Status code	Description	Response headers
200	OK	-
401	Unauthorized	-
403	Insufficient permissions to query endpoint	-
404	Not found	-
429	Exhausted rate limit for the organization	-

[Back to top] [Back to API list] [Back to Model list] [Back to README]

endpoint_labels_list

EndpointLabelsList200Response endpoint_labels_list(max=max, cursor=cursor, expand=expand)

List labels

Example

• Bearer Authentication (BearerAuth):

import time
import os
import labels_api
from labels_api.models.endpoint_labels_list200_response import EndpointLabelsList200Response
from labels_api.models.expand import Expand
from labels_api.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.thousandeyes.com
# See configuration.py for a list of all supported configuration parameters.
configuration = labels_api.Configuration(
    host = "https://api.thousandeyes.com"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization: BearerAuth
configuration = labels_api.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)

# Enter a context with an instance of the API client
with labels_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = labels_api.ManageLabelsApi(api_client)
    max = 5 # float | (Optional) Maximum number of objects to return. (optional)
    cursor = 'cursor_example' # str | (Optional) Opaque cursor used for pagination. Clients should use `_links` instead of this parameter. (optional)
    expand = [labels_api.Expand()] # List[Expand] | This parameter is optional and determines whether to include additional details in the response. To specify multiple expansions, you can either separate the values with commas or specify the parameter multiple times. (optional)

    try:
        # List labels
        api_response = api_instance.endpoint_labels_list(max=max, cursor=cursor, expand=expand)
        print("The response of ManageLabelsApi->endpoint_labels_list:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling ManageLabelsApi->endpoint_labels_list: %s\n" % e)

Parameters

Name	Type	Description	Notes
max	float	(Optional) Maximum number of objects to return.	[optional]
cursor	str	(Optional) Opaque cursor used for pagination. Clients should use `_links` instead of this parameter.	[optional]
expand	**List[Expand]**	This parameter is optional and determines whether to include additional details in the response. To specify multiple expansions, you can either separate the values with commas or specify the parameter multiple times.	[optional]

Return type

EndpointLabelsList200Response

Authorization

BearerAuth

HTTP request headers

• Content-Type: Not defined
• Accept: application/hal+json, application/problem+json

HTTP response details

Status code	Description	Response headers
200	OK	-
401	Unauthorized	-
403	Insufficient permissions to query endpoint	-
429	Exhausted rate limit for the organization	-

[Back to top] [Back to API list] [Back to Model list] [Back to README]

v7_endpoint_labels_post

V7EndpointLabelsPost201Response v7_endpoint_labels_post(v7_endpoint_labels_post_request=v7_endpoint_labels_post_request)

Create label

Example

• Bearer Authentication (BearerAuth):

import time
import os
import labels_api
from labels_api.models.v7_endpoint_labels_post201_response import V7EndpointLabelsPost201Response
from labels_api.models.v7_endpoint_labels_post_request import V7EndpointLabelsPostRequest
from labels_api.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.thousandeyes.com
# See configuration.py for a list of all supported configuration parameters.
configuration = labels_api.Configuration(
    host = "https://api.thousandeyes.com"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization: BearerAuth
configuration = labels_api.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)

# Enter a context with an instance of the API client
with labels_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = labels_api.ManageLabelsApi(api_client)
    v7_endpoint_labels_post_request = labels_api.V7EndpointLabelsPostRequest() # V7EndpointLabelsPostRequest | Label settings (optional)

    try:
        # Create label
        api_response = api_instance.v7_endpoint_labels_post(v7_endpoint_labels_post_request=v7_endpoint_labels_post_request)
        print("The response of ManageLabelsApi->v7_endpoint_labels_post:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling ManageLabelsApi->v7_endpoint_labels_post: %s\n" % e)

Parameters

Name	Type	Description	Notes
v7_endpoint_labels_post_request	V7EndpointLabelsPostRequest	Label settings	[optional]

Return type

V7EndpointLabelsPost201Response

Authorization

BearerAuth

HTTP request headers

• Content-Type: application/json
• Accept: application/hal+json, application/problem+json

HTTP response details

Status code	Description	Response headers
201	created	* Location -
401	Unauthorized	-
403	Insufficient permissions to query endpoint	-
429	Exhausted rate limit for the organization	-

[Back to top] [Back to API list] [Back to Model list] [Back to README]