| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, |
| software distributed under the License is distributed on an |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| KIND, either express or implied. See the License for the |
| specific language governing permissions and limitations |
| under the License. |
| --> |
| |
| # Apache Airflow Python Client.VariableApi |
| |
| All URIs are relative to */api/v1* |
| |
| Method | HTTP request | Description |
| ------------- | ------------- | ------------- |
| [**delete_variable**](VariableApi.md#delete_variable) | **DELETE** /variables/{variable_key} | Delete a variable |
| [**get_variable**](VariableApi.md#get_variable) | **GET** /variables/{variable_key} | Get a variable |
| [**get_variables**](VariableApi.md#get_variables) | **GET** /variables | List variables |
| [**patch_variable**](VariableApi.md#patch_variable) | **PATCH** /variables/{variable_key} | Update a variable |
| [**post_variables**](VariableApi.md#post_variables) | **POST** /variables | Create a variable |
| |
| |
| # **delete_variable** |
| > delete_variable(variable_key) |
| |
| Delete a variable |
| |
| ### Example |
| |
| * Basic Authentication (Basic): |
| |
| ```python |
| import time |
| import airflow_client.client |
| from airflow_client.client.api import variable_api |
| from airflow_client.client.model.error import Error |
| from pprint import pprint |
| # Defining the host is optional and defaults to /api/v1 |
| # See configuration.py for a list of all supported configuration parameters. |
| configuration = client.Configuration( |
| host = "/api/v1" |
| ) |
| |
| # 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 = client.Configuration( |
| username = 'YOUR_USERNAME', |
| password = 'YOUR_PASSWORD' |
| ) |
| |
| # Enter a context with an instance of the API client |
| with client.ApiClient(configuration) as api_client: |
| # Create an instance of the API class |
| api_instance = variable_api.VariableApi(api_client) |
| variable_key = "variable_key_example" # str | The variable Key. |
| |
| # example passing only required values which don't have defaults set |
| try: |
| # Delete a variable |
| api_instance.delete_variable(variable_key) |
| except client.ApiException as e: |
| print("Exception when calling VariableApi->delete_variable: %s\n" % e) |
| ``` |
| |
| |
| ### Parameters |
| |
| Name | Type | Description | Notes |
| ------------- | ------------- | ------------- | ------------- |
| **variable_key** | **str**| The variable Key. | |
| |
| ### Return type |
| |
| void (empty response body) |
| |
| ### Authorization |
| |
| [Basic](../README.md#Basic), [Kerberos](../README.md#Kerberos) |
| |
| ### HTTP request headers |
| |
| - **Content-Type**: Not defined |
| - **Accept**: application/json |
| |
| |
| ### HTTP response details |
| |
| | Status code | Description | Response headers | |
| |-------------|-------------|------------------| |
| **204** | Success. | - | |
| **400** | Client specified an invalid argument. | - | |
| **401** | Request not authenticated due to missing, invalid, authentication info. | - | |
| **403** | Client does not have sufficient permission. | - | |
| **404** | A specified resource is not found. | - | |
| |
| [[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_variable** |
| > Variable get_variable(variable_key) |
| |
| Get a variable |
| |
| Get a variable by key. |
| |
| ### Example |
| |
| * Basic Authentication (Basic): |
| |
| ```python |
| import time |
| import airflow_client.client |
| from airflow_client.client.api import variable_api |
| from airflow_client.client.model.variable import Variable |
| from airflow_client.client.model.error import Error |
| from pprint import pprint |
| # Defining the host is optional and defaults to /api/v1 |
| # See configuration.py for a list of all supported configuration parameters. |
| configuration = client.Configuration( |
| host = "/api/v1" |
| ) |
| |
| # 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 = client.Configuration( |
| username = 'YOUR_USERNAME', |
| password = 'YOUR_PASSWORD' |
| ) |
| |
| # Enter a context with an instance of the API client |
| with client.ApiClient(configuration) as api_client: |
| # Create an instance of the API class |
| api_instance = variable_api.VariableApi(api_client) |
| variable_key = "variable_key_example" # str | The variable Key. |
| |
| # example passing only required values which don't have defaults set |
| try: |
| # Get a variable |
| api_response = api_instance.get_variable(variable_key) |
| pprint(api_response) |
| except client.ApiException as e: |
| print("Exception when calling VariableApi->get_variable: %s\n" % e) |
| ``` |
| |
| |
| ### Parameters |
| |
| Name | Type | Description | Notes |
| ------------- | ------------- | ------------- | ------------- |
| **variable_key** | **str**| The variable Key. | |
| |
| ### Return type |
| |
| [**Variable**](Variable.md) |
| |
| ### Authorization |
| |
| [Basic](../README.md#Basic), [Kerberos](../README.md#Kerberos) |
| |
| ### HTTP request headers |
| |
| - **Content-Type**: Not defined |
| - **Accept**: application/json |
| |
| |
| ### HTTP response details |
| |
| | Status code | Description | Response headers | |
| |-------------|-------------|------------------| |
| **200** | Success. | - | |
| **401** | Request not authenticated due to missing, invalid, authentication info. | - | |
| **403** | Client does not have sufficient permission. | - | |
| **404** | A specified resource is not found. | - | |
| |
| [[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_variables** |
| > VariableCollection get_variables() |
| |
| List variables |
| |
| The collection does not contain data. To get data, you must get a single entity. |
| |
| ### Example |
| |
| * Basic Authentication (Basic): |
| |
| ```python |
| import time |
| import airflow_client.client |
| from airflow_client.client.api import variable_api |
| from airflow_client.client.model.variable_collection import VariableCollection |
| from airflow_client.client.model.error import Error |
| from pprint import pprint |
| # Defining the host is optional and defaults to /api/v1 |
| # See configuration.py for a list of all supported configuration parameters. |
| configuration = client.Configuration( |
| host = "/api/v1" |
| ) |
| |
| # 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 = client.Configuration( |
| username = 'YOUR_USERNAME', |
| password = 'YOUR_PASSWORD' |
| ) |
| |
| # Enter a context with an instance of the API client |
| with client.ApiClient(configuration) as api_client: |
| # Create an instance of the API class |
| api_instance = variable_api.VariableApi(api_client) |
| limit = 100 # int | The numbers of items to return. (optional) if omitted the server will use the default value of 100 |
| offset = 0 # int | The number of items to skip before starting to collect the result set. (optional) |
| order_by = "order_by_example" # str | The name of the field to order the results by. Prefix a field name with `-` to reverse the sort order. *New in version 2.1.0* (optional) |
| |
| # example passing only required values which don't have defaults set |
| # and optional values |
| try: |
| # List variables |
| api_response = api_instance.get_variables(limit=limit, offset=offset, order_by=order_by) |
| pprint(api_response) |
| except client.ApiException as e: |
| print("Exception when calling VariableApi->get_variables: %s\n" % e) |
| ``` |
| |
| |
| ### Parameters |
| |
| Name | Type | Description | Notes |
| ------------- | ------------- | ------------- | ------------- |
| **limit** | **int**| The numbers of items to return. | [optional] if omitted the server will use the default value of 100 |
| **offset** | **int**| The number of items to skip before starting to collect the result set. | [optional] |
| **order_by** | **str**| The name of the field to order the results by. Prefix a field name with `-` to reverse the sort order. *New in version 2.1.0* | [optional] |
| |
| ### Return type |
| |
| [**VariableCollection**](VariableCollection.md) |
| |
| ### Authorization |
| |
| [Basic](../README.md#Basic), [Kerberos](../README.md#Kerberos) |
| |
| ### HTTP request headers |
| |
| - **Content-Type**: Not defined |
| - **Accept**: application/json |
| |
| |
| ### HTTP response details |
| |
| | Status code | Description | Response headers | |
| |-------------|-------------|------------------| |
| **200** | Success. | - | |
| **401** | Request not authenticated due to missing, invalid, authentication info. | - | |
| **403** | Client does not have sufficient permission. | - | |
| |
| [[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) |
| |
| # **patch_variable** |
| > Variable patch_variable(variable_key, variable) |
| |
| Update a variable |
| |
| Update a variable by key. |
| |
| ### Example |
| |
| * Basic Authentication (Basic): |
| |
| ```python |
| import time |
| import airflow_client.client |
| from airflow_client.client.api import variable_api |
| from airflow_client.client.model.variable import Variable |
| from airflow_client.client.model.error import Error |
| from pprint import pprint |
| # Defining the host is optional and defaults to /api/v1 |
| # See configuration.py for a list of all supported configuration parameters. |
| configuration = client.Configuration( |
| host = "/api/v1" |
| ) |
| |
| # 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 = client.Configuration( |
| username = 'YOUR_USERNAME', |
| password = 'YOUR_PASSWORD' |
| ) |
| |
| # Enter a context with an instance of the API client |
| with client.ApiClient(configuration) as api_client: |
| # Create an instance of the API class |
| api_instance = variable_api.VariableApi(api_client) |
| variable_key = "variable_key_example" # str | The variable Key. |
| variable = Variable(None) # Variable | |
| update_mask = [ |
| "update_mask_example", |
| ] # [str] | The fields to update on the resource. If absent or empty, all modifiable fields are updated. A comma-separated list of fully qualified names of fields. (optional) |
| |
| # example passing only required values which don't have defaults set |
| try: |
| # Update a variable |
| api_response = api_instance.patch_variable(variable_key, variable) |
| pprint(api_response) |
| except client.ApiException as e: |
| print("Exception when calling VariableApi->patch_variable: %s\n" % e) |
| |
| # example passing only required values which don't have defaults set |
| # and optional values |
| try: |
| # Update a variable |
| api_response = api_instance.patch_variable(variable_key, variable, update_mask=update_mask) |
| pprint(api_response) |
| except client.ApiException as e: |
| print("Exception when calling VariableApi->patch_variable: %s\n" % e) |
| ``` |
| |
| |
| ### Parameters |
| |
| Name | Type | Description | Notes |
| ------------- | ------------- | ------------- | ------------- |
| **variable_key** | **str**| The variable Key. | |
| **variable** | [**Variable**](Variable.md)| | |
| **update_mask** | **[str]**| The fields to update on the resource. If absent or empty, all modifiable fields are updated. A comma-separated list of fully qualified names of fields. | [optional] |
| |
| ### Return type |
| |
| [**Variable**](Variable.md) |
| |
| ### Authorization |
| |
| [Basic](../README.md#Basic), [Kerberos](../README.md#Kerberos) |
| |
| ### HTTP request headers |
| |
| - **Content-Type**: application/json |
| - **Accept**: application/json |
| |
| |
| ### HTTP response details |
| |
| | Status code | Description | Response headers | |
| |-------------|-------------|------------------| |
| **200** | Success. | - | |
| **400** | Client specified an invalid argument. | - | |
| **401** | Request not authenticated due to missing, invalid, authentication info. | - | |
| **403** | Client does not have sufficient permission. | - | |
| **404** | A specified resource is not found. | - | |
| |
| [[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_variables** |
| > Variable post_variables(variable) |
| |
| Create a variable |
| |
| ### Example |
| |
| * Basic Authentication (Basic): |
| |
| ```python |
| import time |
| import airflow_client.client |
| from airflow_client.client.api import variable_api |
| from airflow_client.client.model.variable import Variable |
| from airflow_client.client.model.error import Error |
| from pprint import pprint |
| # Defining the host is optional and defaults to /api/v1 |
| # See configuration.py for a list of all supported configuration parameters. |
| configuration = client.Configuration( |
| host = "/api/v1" |
| ) |
| |
| # 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 = client.Configuration( |
| username = 'YOUR_USERNAME', |
| password = 'YOUR_PASSWORD' |
| ) |
| |
| # Enter a context with an instance of the API client |
| with client.ApiClient(configuration) as api_client: |
| # Create an instance of the API class |
| api_instance = variable_api.VariableApi(api_client) |
| variable = Variable(None) # Variable | |
| |
| # example passing only required values which don't have defaults set |
| try: |
| # Create a variable |
| api_response = api_instance.post_variables(variable) |
| pprint(api_response) |
| except client.ApiException as e: |
| print("Exception when calling VariableApi->post_variables: %s\n" % e) |
| ``` |
| |
| |
| ### Parameters |
| |
| Name | Type | Description | Notes |
| ------------- | ------------- | ------------- | ------------- |
| **variable** | [**Variable**](Variable.md)| | |
| |
| ### Return type |
| |
| [**Variable**](Variable.md) |
| |
| ### Authorization |
| |
| [Basic](../README.md#Basic), [Kerberos](../README.md#Kerberos) |
| |
| ### HTTP request headers |
| |
| - **Content-Type**: application/json |
| - **Accept**: application/json |
| |
| |
| ### HTTP response details |
| |
| | Status code | Description | Response headers | |
| |-------------|-------------|------------------| |
| **200** | Success. | - | |
| **400** | Client specified an invalid argument. | - | |
| **401** | Request not authenticated due to missing, invalid, authentication info. | - | |
| **403** | Client does not have sufficient permission. | - | |
| |
| [[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) |
| |