CMS/openapi-client-udm
2
0
Fork 0
Code Actions Packages
main
openapi-client-udm/docs/DnsTxtRecordApi.md
Adam Goldsmith 98daa460a6 Autogenerated using update_openapi_client from udm-rest-client 
Actual generator command:

```bash
java -jar openapi-generator-cli-5.4.0.jar generate -g python-legacy \
  --library asyncio \
  --package-name openapi_client_udm \
  --additional-properties=packageVersion=1.0.2 \
  -i udm_openapi.json \
  -o ./python
```
2023-11-27 20:21:43 -05:00

689 lines
45 KiB
Markdown
Raw Permalink Blame History

# openapi_client_udm.DnsTxtRecordApi
All URIs are relative to *https://ucs.sawtooth.claremontmakerspace.org/univention/udm*
Method | HTTP request | Description
------------- | ------------- | -------------
[**udm_dns_txt_record_object**](DnsTxtRecordApi.md#udm_dns_txt_record_object) | **GET** /dns/txt_record/{dn} | Get a representation of the TXT record object with all its properties, policies, options, metadata and references. Includes also instructions how to modify, remove or move the object.
[**udm_dns_txt_record_object_create**](DnsTxtRecordApi.md#udm_dns_txt_record_object_create) | **POST** /dns/txt_record/ | Create a new TXT record object
[**udm_dns_txt_record_object_modify**](DnsTxtRecordApi.md#udm_dns_txt_record_object_modify) | **PUT** /dns/txt_record/{dn} | Modify or move an TXT record object
[**udm_dns_txt_record_object_remove**](DnsTxtRecordApi.md#udm_dns_txt_record_object_remove) | **DELETE** /dns/txt_record/{dn} | Remove a TXT record object
[**udm_dns_txt_record_object_search**](DnsTxtRecordApi.md#udm_dns_txt_record_object_search) | **GET** /dns/txt_record/ | Search for TXT record objects
[**udm_dns_txt_record_object_template**](DnsTxtRecordApi.md#udm_dns_txt_record_object_template) | **GET** /dns/txt_record/add | Get a template for creating an TXT record object (contains all properties and their default values)
[**udm_dns_txt_record_object_update**](DnsTxtRecordApi.md#udm_dns_txt_record_object_update) | **PATCH** /dns/txt_record/{dn} | Modify an TXT record object (moving is currently not possible)
# **udm_dns_txt_record_object**
> DnsTxtRecord udm_dns_txt_record_object(dn, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
Get a representation of the TXT record object with all its properties, policies, options, metadata and references. Includes also instructions how to modify, remove or move the object.
### Example
* Basic Authentication (basic):
```python
from __future__ import print_function
import time
import openapi_client_udm
from openapi_client_udm.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ucs.sawtooth.claremontmakerspace.org/univention/udm
# See configuration.py for a list of all supported configuration parameters.
configuration = openapi_client_udm.Configuration(
host = "https://ucs.sawtooth.claremontmakerspace.org/univention/udm"
)
# 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 HTTP basic authorization: basic
configuration = openapi_client_udm.Configuration(
username = 'YOUR_USERNAME',
password = 'YOUR_PASSWORD'
)
# Enter a context with an instance of the API client
with openapi_client_udm.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = openapi_client_udm.DnsTxtRecordApi(api_client)
dn = 'dn_example' # str | The (urlencoded) LDAP Distinguished Name (DN).
user_agent = '' # str | The user agent. (optional)
accept_language = '' # str | The accepted response languages. (optional)
if_none_match = '' # str | Use request from cache by using the Etag entity tag if it matches. (optional)
if_modified_since = '' # str | Use request from cache by using the Last-Modified date if it matches. (optional)
x_request_id = '' # str | A request-ID used for logging and tracing. (optional)
try:
# Get a representation of the TXT record object with all its properties, policies, options, metadata and references. Includes also instructions how to modify, remove or move the object.
api_response = api_instance.udm_dns_txt_record_object(dn, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
pprint(api_response)
except ApiException as e:
print("Exception when calling DnsTxtRecordApi->udm_dns_txt_record_object: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**dn** | **str**| The (urlencoded) LDAP Distinguished Name (DN). |
**user_agent** | **str**| The user agent. | [optional]
**accept_language** | **str**| The accepted response languages. | [optional]
**if_none_match** | **str**| Use request from cache by using the Etag entity tag if it matches. | [optional]
**if_modified_since** | **str**| Use request from cache by using the Last-Modified date if it matches. | [optional]
**x_request_id** | **str**| A request-ID used for logging and tracing. | [optional]
### Return type
[**DnsTxtRecord**](DnsTxtRecord.md)
### Authorization
[basic](../README.md#basic)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json, application/hal+json, text/html
### HTTP response details
| Status code | Description | Response headers |
|-------------|-------------|------------------|
**400** | Bad request syntax. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**401** | Unauthorized. No Authorization provided or wrong credentials. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**403** | Forbidden (e.g. unsupported operation) | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**422** | Validation of input parameters failed. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**500** | Internal server errror. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**503** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**502** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**504** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**200** | Success | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Etag - <br> * Last-Modified - <br> |
**404** | Object not found. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
[[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)
# **udm_dns_txt_record_object_create**
> InlineResponse201 udm_dns_txt_record_object_create(dns_txt_record, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
Create a new TXT record object
### Example
* Basic Authentication (basic):
```python
from __future__ import print_function
import time
import openapi_client_udm
from openapi_client_udm.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ucs.sawtooth.claremontmakerspace.org/univention/udm
# See configuration.py for a list of all supported configuration parameters.
configuration = openapi_client_udm.Configuration(
host = "https://ucs.sawtooth.claremontmakerspace.org/univention/udm"
)
# 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 HTTP basic authorization: basic
configuration = openapi_client_udm.Configuration(
username = 'YOUR_USERNAME',
password = 'YOUR_PASSWORD'
)
# Enter a context with an instance of the API client
with openapi_client_udm.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = openapi_client_udm.DnsTxtRecordApi(api_client)
dns_txt_record = openapi_client_udm.DnsTxtRecord() # DnsTxtRecord |
user_agent = '' # str | The user agent. (optional)
accept_language = '' # str | The accepted response languages. (optional)
if_none_match = '' # str | Use request from cache by using the Etag entity tag if it matches. (optional)
if_modified_since = '' # str | Use request from cache by using the Last-Modified date if it matches. (optional)
x_request_id = '' # str | A request-ID used for logging and tracing. (optional)
try:
# Create a new TXT record object
api_response = api_instance.udm_dns_txt_record_object_create(dns_txt_record, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
pprint(api_response)
except ApiException as e:
print("Exception when calling DnsTxtRecordApi->udm_dns_txt_record_object_create: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**dns_txt_record** | [**DnsTxtRecord**](DnsTxtRecord.md)| |
**user_agent** | **str**| The user agent. | [optional]
**accept_language** | **str**| The accepted response languages. | [optional]
**if_none_match** | **str**| Use request from cache by using the Etag entity tag if it matches. | [optional]
**if_modified_since** | **str**| Use request from cache by using the Last-Modified date if it matches. | [optional]
**x_request_id** | **str**| A request-ID used for logging and tracing. | [optional]
### Return type
[**InlineResponse201**](InlineResponse201.md)
### Authorization
[basic](../README.md#basic)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json, application/hal+json, text/html
### HTTP response details
| Status code | Description | Response headers |
|-------------|-------------|------------------|
**400** | Bad request syntax. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**401** | Unauthorized. No Authorization provided or wrong credentials. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**403** | Forbidden (e.g. unsupported operation) | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**422** | Validation of input parameters failed. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**500** | Internal server errror. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**503** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**502** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**504** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**201** | Object created | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Etag - <br> * Last-Modified - <br> |
[[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)
# **udm_dns_txt_record_object_modify**
> InlineResponse201 udm_dns_txt_record_object_modify(dn, dns_txt_record, if_match=if_match, if_unmodified_since=if_unmodified_since, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
Modify or move an TXT record object
### Example
* Basic Authentication (basic):
```python
from __future__ import print_function
import time
import openapi_client_udm
from openapi_client_udm.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ucs.sawtooth.claremontmakerspace.org/univention/udm
# See configuration.py for a list of all supported configuration parameters.
configuration = openapi_client_udm.Configuration(
host = "https://ucs.sawtooth.claremontmakerspace.org/univention/udm"
)
# 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 HTTP basic authorization: basic
configuration = openapi_client_udm.Configuration(
username = 'YOUR_USERNAME',
password = 'YOUR_PASSWORD'
)
# Enter a context with an instance of the API client
with openapi_client_udm.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = openapi_client_udm.DnsTxtRecordApi(api_client)
dn = 'dn_example' # str | The (urlencoded) LDAP Distinguished Name (DN).
dns_txt_record = openapi_client_udm.DnsTxtRecord() # DnsTxtRecord |
if_match = '' # str | Provide entity tag to make a conditional request to not overwrite any values in a race condition. (optional)
if_unmodified_since = 'if_unmodified_since_example' # str | Provide last modified time to make a conditional request to not overwrite any values in a race condition. (optional)
user_agent = '' # str | The user agent. (optional)
accept_language = '' # str | The accepted response languages. (optional)
if_none_match = '' # str | Use request from cache by using the Etag entity tag if it matches. (optional)
if_modified_since = '' # str | Use request from cache by using the Last-Modified date if it matches. (optional)
x_request_id = '' # str | A request-ID used for logging and tracing. (optional)
try:
# Modify or move an TXT record object
api_response = api_instance.udm_dns_txt_record_object_modify(dn, dns_txt_record, if_match=if_match, if_unmodified_since=if_unmodified_since, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
pprint(api_response)
except ApiException as e:
print("Exception when calling DnsTxtRecordApi->udm_dns_txt_record_object_modify: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**dn** | **str**| The (urlencoded) LDAP Distinguished Name (DN). |
**dns_txt_record** | [**DnsTxtRecord**](DnsTxtRecord.md)| |
**if_match** | **str**| Provide entity tag to make a conditional request to not overwrite any values in a race condition. | [optional]
**if_unmodified_since** | **str**| Provide last modified time to make a conditional request to not overwrite any values in a race condition. | [optional]
**user_agent** | **str**| The user agent. | [optional]
**accept_language** | **str**| The accepted response languages. | [optional]
**if_none_match** | **str**| Use request from cache by using the Etag entity tag if it matches. | [optional]
**if_modified_since** | **str**| Use request from cache by using the Last-Modified date if it matches. | [optional]
**x_request_id** | **str**| A request-ID used for logging and tracing. | [optional]
### Return type
[**InlineResponse201**](InlineResponse201.md)
### Authorization
[basic](../README.md#basic)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json, application/hal+json, text/html
### HTTP response details
| Status code | Description | Response headers |
|-------------|-------------|------------------|
**400** | Bad request syntax. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**401** | Unauthorized. No Authorization provided or wrong credentials. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**403** | Forbidden (e.g. unsupported operation) | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**422** | Validation of input parameters failed. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**500** | Internal server errror. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**503** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**502** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**504** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**201** | Created: The object did not exist and has been created. Deprecated: a move operation started, expect 202 in the future! | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Etag - <br> * Last-Modified - <br> |
**202** | Accepted: asynchronous move or rename operation started. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Location - <br> |
**204** | Success. No response data. A link to the modified resource in the &#x60;Location&#x60; header. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Location - <br> * Etag - <br> * Last-Modified - <br> |
**404** | Object not found. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
[[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)
# **udm_dns_txt_record_object_remove**
> udm_dns_txt_record_object_remove(dn, cleanup=cleanup, recursive=recursive, if_match=if_match, if_unmodified_since=if_unmodified_since, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
Remove a TXT record object
### Example
* Basic Authentication (basic):
```python
from __future__ import print_function
import time
import openapi_client_udm
from openapi_client_udm.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ucs.sawtooth.claremontmakerspace.org/univention/udm
# See configuration.py for a list of all supported configuration parameters.
configuration = openapi_client_udm.Configuration(
host = "https://ucs.sawtooth.claremontmakerspace.org/univention/udm"
)
# 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 HTTP basic authorization: basic
configuration = openapi_client_udm.Configuration(
username = 'YOUR_USERNAME',
password = 'YOUR_PASSWORD'
)
# Enter a context with an instance of the API client
with openapi_client_udm.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = openapi_client_udm.DnsTxtRecordApi(api_client)
dn = 'dn_example' # str | The (urlencoded) LDAP Distinguished Name (DN).
cleanup = True # bool | Whether to perform a cleanup (e.g. of temporary objects, locks, etc). (optional) (default to True)
recursive = True # bool | Whether to remove referring objects (e.g. DNS or DHCP references). (optional) (default to True)
if_match = '' # str | Provide entity tag to make a conditional request to not overwrite any values in a race condition. (optional)
if_unmodified_since = 'if_unmodified_since_example' # str | Provide last modified time to make a conditional request to not overwrite any values in a race condition. (optional)
user_agent = '' # str | The user agent. (optional)
accept_language = '' # str | The accepted response languages. (optional)
if_none_match = '' # str | Use request from cache by using the Etag entity tag if it matches. (optional)
if_modified_since = '' # str | Use request from cache by using the Last-Modified date if it matches. (optional)
x_request_id = '' # str | A request-ID used for logging and tracing. (optional)
try:
# Remove a TXT record object
api_instance.udm_dns_txt_record_object_remove(dn, cleanup=cleanup, recursive=recursive, if_match=if_match, if_unmodified_since=if_unmodified_since, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
except ApiException as e:
print("Exception when calling DnsTxtRecordApi->udm_dns_txt_record_object_remove: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**dn** | **str**| The (urlencoded) LDAP Distinguished Name (DN). |
**cleanup** | **bool**| Whether to perform a cleanup (e.g. of temporary objects, locks, etc). | [optional] [default to True]
**recursive** | **bool**| Whether to remove referring objects (e.g. DNS or DHCP references). | [optional] [default to True]
**if_match** | **str**| Provide entity tag to make a conditional request to not overwrite any values in a race condition. | [optional]
**if_unmodified_since** | **str**| Provide last modified time to make a conditional request to not overwrite any values in a race condition. | [optional]
**user_agent** | **str**| The user agent. | [optional]
**accept_language** | **str**| The accepted response languages. | [optional]
**if_none_match** | **str**| Use request from cache by using the Etag entity tag if it matches. | [optional]
**if_modified_since** | **str**| Use request from cache by using the Last-Modified date if it matches. | [optional]
**x_request_id** | **str**| A request-ID used for logging and tracing. | [optional]
### Return type
void (empty response body)
### Authorization
[basic](../README.md#basic)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json, application/hal+json, text/html
### HTTP response details
| Status code | Description | Response headers |
|-------------|-------------|------------------|
**400** | Bad request syntax. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**401** | Unauthorized. No Authorization provided or wrong credentials. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**403** | Forbidden (e.g. unsupported operation) | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**422** | Validation of input parameters failed. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**500** | Internal server errror. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**503** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**502** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**504** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**204** | Object deleted | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**404** | Object not found. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
[[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)
# **udm_dns_txt_record_object_search**
> DnsTxtRecordList udm_dns_txt_record_object_search(filter=filter, position=position, scope=scope, query=query, hidden=hidden, properties=properties, limit=limit, page=page, dir=dir, by=by, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id, superordinate=superordinate)
Search for TXT record objects
Information about the object type and links to search for objects. The found objects are either referenced as HAL links or embedded via HAL embedded resources.
### Example
* Basic Authentication (basic):
```python
from __future__ import print_function
import time
import openapi_client_udm
from openapi_client_udm.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ucs.sawtooth.claremontmakerspace.org/univention/udm
# See configuration.py for a list of all supported configuration parameters.
configuration = openapi_client_udm.Configuration(
host = "https://ucs.sawtooth.claremontmakerspace.org/univention/udm"
)
# 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 HTTP basic authorization: basic
configuration = openapi_client_udm.Configuration(
username = 'YOUR_USERNAME',
password = 'YOUR_PASSWORD'
)
# Enter a context with an instance of the API client
with openapi_client_udm.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = openapi_client_udm.DnsTxtRecordApi(api_client)
filter = '' # str | A LDAP filter which may contain `UDM` property names instead of `LDAP` attribute names. (optional) (default to '')
position = 'null' # str | Position which is used as search base. (optional) (default to 'null')
scope = 'sub' # str | The LDAP search scope (sub, base, one). (optional) (default to 'sub')
query = None # dict(str, object) | The values to search for (propertyname and search filter value). Alternatively with `filter` a raw LDAP filter can be given. (optional)
hidden = True # bool | Include hidden/system objects in the response. (optional) (default to True)
properties = ["*"] # list[str] | The properties which should be returned, if not given all properties are returned. (optional) (default to ["*"])
limit = # int | **Broken/Experimental**: How many results should be shown per page. (optional)
page = 1 # int | **Broken/Experimental**: The search page, starting at one. (optional) (default to 1)
dir = 'ASC' # str | **Broken/Experimental**: The Sort direction (ASC or DESC). (optional) (default to 'ASC')
by = 'by_example' # str | **Broken/Experimental**: Sort the search result by the specified property. (optional)
user_agent = '' # str | The user agent. (optional)
accept_language = '' # str | The accepted response languages. (optional)
if_none_match = '' # str | Use request from cache by using the Etag entity tag if it matches. (optional)
if_modified_since = '' # str | Use request from cache by using the Last-Modified date if it matches. (optional)
x_request_id = '' # str | A request-ID used for logging and tracing. (optional)
superordinate = 'null' # str | The superordinate DN of the objects to find. `position` is sufficient. (optional) (default to 'null')
try:
# Search for TXT record objects
api_response = api_instance.udm_dns_txt_record_object_search(filter=filter, position=position, scope=scope, query=query, hidden=hidden, properties=properties, limit=limit, page=page, dir=dir, by=by, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id, superordinate=superordinate)
pprint(api_response)
except ApiException as e:
print("Exception when calling DnsTxtRecordApi->udm_dns_txt_record_object_search: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**filter** | **str**| A LDAP filter which may contain &#x60;UDM&#x60; property names instead of &#x60;LDAP&#x60; attribute names. | [optional] [default to &#39;&#39;]
**position** | **str**| Position which is used as search base. | [optional] [default to &#39;null&#39;]
**scope** | **str**| The LDAP search scope (sub, base, one). | [optional] [default to &#39;sub&#39;]
**query** | [**dict(str, object)**](object.md)| The values to search for (propertyname and search filter value). Alternatively with &#x60;filter&#x60; a raw LDAP filter can be given. | [optional]
**hidden** | **bool**| Include hidden/system objects in the response. | [optional] [default to True]
**properties** | [**list[str]**](str.md)| The properties which should be returned, if not given all properties are returned. | [optional] [default to [&quot;*&quot;]]
**limit** | **int**| **Broken/Experimental**: How many results should be shown per page. | [optional]
**page** | **int**| **Broken/Experimental**: The search page, starting at one. | [optional] [default to 1]
**dir** | **str**| **Broken/Experimental**: The Sort direction (ASC or DESC). | [optional] [default to &#39;ASC&#39;]
**by** | **str**| **Broken/Experimental**: Sort the search result by the specified property. | [optional]
**user_agent** | **str**| The user agent. | [optional]
**accept_language** | **str**| The accepted response languages. | [optional]
**if_none_match** | **str**| Use request from cache by using the Etag entity tag if it matches. | [optional]
**if_modified_since** | **str**| Use request from cache by using the Last-Modified date if it matches. | [optional]
**x_request_id** | **str**| A request-ID used for logging and tracing. | [optional]
**superordinate** | **str**| The superordinate DN of the objects to find. &#x60;position&#x60; is sufficient. | [optional] [default to &#39;null&#39;]
### Return type
[**DnsTxtRecordList**](DnsTxtRecordList.md)
### Authorization
[basic](../README.md#basic)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json, application/hal+json, text/html
### HTTP response details
| Status code | Description | Response headers |
|-------------|-------------|------------------|
**400** | Bad request syntax. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**401** | Unauthorized. No Authorization provided or wrong credentials. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**403** | Forbidden (e.g. unsupported operation) | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**422** | Validation of input parameters failed. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**500** | Internal server errror. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**503** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**502** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**504** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**200** | Successfull search (if query parameters were given) or a object type overview. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
[[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)
# **udm_dns_txt_record_object_template**
> DnsTxtRecord udm_dns_txt_record_object_template(position=position, superordinate=superordinate, template=template, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
Get a template for creating an TXT record object (contains all properties and their default values)
### Example
* Basic Authentication (basic):
```python
from __future__ import print_function
import time
import openapi_client_udm
from openapi_client_udm.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ucs.sawtooth.claremontmakerspace.org/univention/udm
# See configuration.py for a list of all supported configuration parameters.
configuration = openapi_client_udm.Configuration(
host = "https://ucs.sawtooth.claremontmakerspace.org/univention/udm"
)
# 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 HTTP basic authorization: basic
configuration = openapi_client_udm.Configuration(
username = 'YOUR_USERNAME',
password = 'YOUR_PASSWORD'
)
# Enter a context with an instance of the API client
with openapi_client_udm.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = openapi_client_udm.DnsTxtRecordApi(api_client)
position = 'null' # str | Position which is used as search base. (optional) (default to 'null')
superordinate = 'null' # str | The superordinate DN of the object to create. `position` is sufficient. (optional) (default to 'null')
template = 'null' # str | **Experimental**: A |UDM| template object. (optional) (default to 'null')
user_agent = '' # str | The user agent. (optional)
accept_language = '' # str | The accepted response languages. (optional)
if_none_match = '' # str | Use request from cache by using the Etag entity tag if it matches. (optional)
if_modified_since = '' # str | Use request from cache by using the Last-Modified date if it matches. (optional)
x_request_id = '' # str | A request-ID used for logging and tracing. (optional)
try:
# Get a template for creating an TXT record object (contains all properties and their default values)
api_response = api_instance.udm_dns_txt_record_object_template(position=position, superordinate=superordinate, template=template, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
pprint(api_response)
except ApiException as e:
print("Exception when calling DnsTxtRecordApi->udm_dns_txt_record_object_template: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**position** | **str**| Position which is used as search base. | [optional] [default to &#39;null&#39;]
**superordinate** | **str**| The superordinate DN of the object to create. &#x60;position&#x60; is sufficient. | [optional] [default to &#39;null&#39;]
**template** | **str**| **Experimental**: A |UDM| template object. | [optional] [default to &#39;null&#39;]
**user_agent** | **str**| The user agent. | [optional]
**accept_language** | **str**| The accepted response languages. | [optional]
**if_none_match** | **str**| Use request from cache by using the Etag entity tag if it matches. | [optional]
**if_modified_since** | **str**| Use request from cache by using the Last-Modified date if it matches. | [optional]
**x_request_id** | **str**| A request-ID used for logging and tracing. | [optional]
### Return type
[**DnsTxtRecord**](DnsTxtRecord.md)
### Authorization
[basic](../README.md#basic)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json, application/hal+json, text/html
### HTTP response details
| Status code | Description | Response headers |
|-------------|-------------|------------------|
**400** | Bad request syntax. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**401** | Unauthorized. No Authorization provided or wrong credentials. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**403** | Forbidden (e.g. unsupported operation) | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**422** | Validation of input parameters failed. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**500** | Internal server errror. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**503** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**502** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**504** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**200** | Successfully received a template suitable for creation of a new TXT record. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
[[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)
# **udm_dns_txt_record_object_update**
> udm_dns_txt_record_object_update(dn, dns_txt_record, if_match=if_match, if_unmodified_since=if_unmodified_since, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
Modify an TXT record object (moving is currently not possible)
### Example
* Basic Authentication (basic):
```python
from __future__ import print_function
import time
import openapi_client_udm
from openapi_client_udm.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ucs.sawtooth.claremontmakerspace.org/univention/udm
# See configuration.py for a list of all supported configuration parameters.
configuration = openapi_client_udm.Configuration(
host = "https://ucs.sawtooth.claremontmakerspace.org/univention/udm"
)
# 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 HTTP basic authorization: basic
configuration = openapi_client_udm.Configuration(
username = 'YOUR_USERNAME',
password = 'YOUR_PASSWORD'
)
# Enter a context with an instance of the API client
with openapi_client_udm.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = openapi_client_udm.DnsTxtRecordApi(api_client)
dn = 'dn_example' # str | The (urlencoded) LDAP Distinguished Name (DN).
dns_txt_record = openapi_client_udm.DnsTxtRecord() # DnsTxtRecord |
if_match = '' # str | Provide entity tag to make a conditional request to not overwrite any values in a race condition. (optional)
if_unmodified_since = 'if_unmodified_since_example' # str | Provide last modified time to make a conditional request to not overwrite any values in a race condition. (optional)
user_agent = '' # str | The user agent. (optional)
accept_language = '' # str | The accepted response languages. (optional)
if_none_match = '' # str | Use request from cache by using the Etag entity tag if it matches. (optional)
if_modified_since = '' # str | Use request from cache by using the Last-Modified date if it matches. (optional)
x_request_id = '' # str | A request-ID used for logging and tracing. (optional)
try:
# Modify an TXT record object (moving is currently not possible)
api_instance.udm_dns_txt_record_object_update(dn, dns_txt_record, if_match=if_match, if_unmodified_since=if_unmodified_since, user_agent=user_agent, accept_language=accept_language, if_none_match=if_none_match, if_modified_since=if_modified_since, x_request_id=x_request_id)
except ApiException as e:
print("Exception when calling DnsTxtRecordApi->udm_dns_txt_record_object_update: %s\n" % e)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**dn** | **str**| The (urlencoded) LDAP Distinguished Name (DN). |
**dns_txt_record** | [**DnsTxtRecord**](DnsTxtRecord.md)| |
**if_match** | **str**| Provide entity tag to make a conditional request to not overwrite any values in a race condition. | [optional]
**if_unmodified_since** | **str**| Provide last modified time to make a conditional request to not overwrite any values in a race condition. | [optional]
**user_agent** | **str**| The user agent. | [optional]
**accept_language** | **str**| The accepted response languages. | [optional]
**if_none_match** | **str**| Use request from cache by using the Etag entity tag if it matches. | [optional]
**if_modified_since** | **str**| Use request from cache by using the Last-Modified date if it matches. | [optional]
**x_request_id** | **str**| A request-ID used for logging and tracing. | [optional]
### Return type
void (empty response body)
### Authorization
[basic](../README.md#basic)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json, application/hal+json, text/html
### HTTP response details
| Status code | Description | Response headers |
|-------------|-------------|------------------|
**400** | Bad request syntax. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**401** | Unauthorized. No Authorization provided or wrong credentials. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**403** | Forbidden (e.g. unsupported operation) | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**422** | Validation of input parameters failed. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**500** | Internal server errror. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
**503** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**502** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**504** | (LDAP) Server not available. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Retry-After - <br> |
**204** | Success. No response data. A link to the modified resource in the &#x60;Location&#x60; header. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> * Location - <br> * Etag - <br> * Last-Modified - <br> |
**404** | Object not found. | * Cache-Control - <br> * Expires - <br> * Vary - <br> * Content-Language - <br> * Link - <br> * X-Request-Id - <br> |
[[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)
View Git Blame Copy Permalink