# ACOS Client
## Table of Contents
1. [Supported Versions](#Supported-Versions)
2. [Installation for ACOSv4.1.4](#Installation-ACOSv4.1.4)
3. [Installation for ACOSv4.1.1](#Installation-ACOSv4.1.1)
4. [Example usage information](#Usage)
5. [Contributing & Testing](#Contributing)
6. [Issues and Inquiries](#Issues-and-Inquiries)
7. [Helpful Links](#Helpful-links)
## Supported Versions
```
| ACOS Version | AXAPI Version | ACOS Client Version | Status |
| 2.7.1† | 2 | >=0.1.0,<0.3.0 | end-of-life |
| 2.7.2 | 2 | >=0.1.0,<0.3.0 | end-of-life |
| 4.0.0 | 3 | >=1.4.6,<1.5.0 | end-of-life |
| 4.1.1 | 3 | >=1.5.0,<2.0.0 | end-of-life |
| 4.1.4 GR1-P2 | 3 | >=2.0.0,<2.4.0 | end-of-life |
| 4.1.4 | 3 | >=2.4.0 | end-of-life |
| 4.1.4 GR1-P5 | 3 | >=2.6.0 | Maintenance |
| 5.2.1 | 3 | >=2.6.0 | Maintenance |
| 5.2.1-p1 | 3 | >=2.7.0 | Maintenance |
| 5.2.1-p2 | 3 | >=2.9.0 | Maintenance |
| 5.2.1-p2 | 3 | >=2.9.1 | Maintenance |
| 5.2.1-p2 | 3 | >=2.10.0 | Maintenance |
```
†Works only when not using partitioning
## Installation
### Install using pip
```sh
$ pip install acos-client>=2.9.0
```
### Install from source
```sh
$ git clone https://github.com/a10networks/acos-client.git
$ cd acos-client
$ git checkout stable/stein
$ pip install -e .
```
## Usage
```python
c = acos_client.Client('somehost.example.com', acos_client.AXAPI_30, 'admin', 'password')
```
#### Example setting up an SLB:
```python
import acos_client as acos
c = acos.Client('1.2.3.4', acos.AXAPI_30, 'admin', 'password')
c.slb.server.create('s1', '1.1.1.1')
c.slb.server.create('s2', '1.1.1.2')
c.slb.service_group.create('pool1', c.slb.service_group.TCP, c.slb.service_group.ROUND_ROBIN)
c.slb.virtual_server.create('vip1', '1.1.1.3')
c.slb.hm.create('hm1', c.slb.hm.HTTP, 5, 5, 5, 'GET', '/', '200', 80)
c.slb.service_group.update('pool1', health_monitor='hm1')
c.slb.service_group.member.create('pool1', 's1', 80)
c.slb.service_group.member.create('pool1', 's2', 80)
```
## Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request
### Testing
This project uses [tox](https://pypi.python.org/pypi/tox) for testing. To run
the test suite simply:
```sh
$ sudo pip install tox # use pip2 if using Arch Linux
$ cd /path/to/acos_client
$ tox
```
## Issues and Inquiries
For all issues, please send an email to support@a10networks.com
## Helpful links
### Improved speed
pypy: [http://pypy.org/index.html](http://pypy.org/index.html)
### Old python versions
Deadsnakes github: [https://github.com/deadsnakes](https://github.com/deadsnakes)
Deadsnakes ppa: [https://launchpad.net/~deadsnakes/+archive/ubuntu/ppa](https://launchpad.net/~deadsnakes/+archive/ubuntu/ppa)
Raw data
{
"_id": null,
"home_page": "https://github.com/a10networks/acos-client",
"name": "acos-client",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "a10 axapi acos adc slb load balancer",
"author": "A10 Networks",
"author_email": "opensource@a10networks.com",
"download_url": "https://files.pythonhosted.org/packages/eb/28/1dd1d07d7723a9596e5eeeba2dc93096cb32f2350b6adc2edc832837afc9/acos-client-2.10.0.tar.gz",
"platform": null,
"description": "# ACOS Client\n\n## Table of Contents\n1. [Supported Versions](#Supported-Versions)\n\n2. [Installation for ACOSv4.1.4](#Installation-ACOSv4.1.4)\n\n3. [Installation for ACOSv4.1.1](#Installation-ACOSv4.1.1)\n\n4. [Example usage information](#Usage)\n\n5. [Contributing & Testing](#Contributing)\n\n6. [Issues and Inquiries](#Issues-and-Inquiries)\n\n7. [Helpful Links](#Helpful-links)\n\n\n## Supported Versions\n\n```\n| ACOS Version | AXAPI Version | ACOS Client Version | Status |\n| 2.7.1\u2020 | 2 | >=0.1.0,<0.3.0 | end-of-life |\n| 2.7.2 | 2 | >=0.1.0,<0.3.0 | end-of-life |\n| 4.0.0 | 3 | >=1.4.6,<1.5.0 | end-of-life |\n| 4.1.1 | 3 | >=1.5.0,<2.0.0 | end-of-life |\n| 4.1.4 GR1-P2 | 3 | >=2.0.0,<2.4.0 | end-of-life |\n| 4.1.4 | 3 | >=2.4.0 | end-of-life |\n| 4.1.4 GR1-P5 | 3 | >=2.6.0 | Maintenance |\n| 5.2.1 | 3 | >=2.6.0 | Maintenance |\n| 5.2.1-p1 | 3 | >=2.7.0 | Maintenance |\n| 5.2.1-p2 | 3 | >=2.9.0 | Maintenance |\n| 5.2.1-p2 | 3 | >=2.9.1 | Maintenance |\n| 5.2.1-p2 | 3 | >=2.10.0 | Maintenance |\n```\n\n\u2020Works only when not using partitioning\n\n## Installation\n\n### Install using pip\n\n```sh\n$ pip install acos-client>=2.9.0\n```\n\n### Install from source\n\n```sh\n$ git clone https://github.com/a10networks/acos-client.git\n$ cd acos-client\n$ git checkout stable/stein\n$ pip install -e . \n```\n\n## Usage\n\n```python\nc = acos_client.Client('somehost.example.com', acos_client.AXAPI_30, 'admin', 'password')\n```\n\n#### Example setting up an SLB:\n\n```python\nimport acos_client as acos\n\nc = acos.Client('1.2.3.4', acos.AXAPI_30, 'admin', 'password')\nc.slb.server.create('s1', '1.1.1.1')\nc.slb.server.create('s2', '1.1.1.2')\nc.slb.service_group.create('pool1', c.slb.service_group.TCP, c.slb.service_group.ROUND_ROBIN)\nc.slb.virtual_server.create('vip1', '1.1.1.3')\nc.slb.hm.create('hm1', c.slb.hm.HTTP, 5, 5, 5, 'GET', '/', '200', 80)\nc.slb.service_group.update('pool1', health_monitor='hm1')\nc.slb.service_group.member.create('pool1', 's1', 80)\nc.slb.service_group.member.create('pool1', 's2', 80)\n```\n\n## Contributing\n\n1. Fork it\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n\n### Testing\n\nThis project uses [tox](https://pypi.python.org/pypi/tox) for testing. To run\nthe test suite simply:\n\n```sh\n$ sudo pip install tox # use pip2 if using Arch Linux\n$ cd /path/to/acos_client\n$ tox\n```\n\n## Issues and Inquiries\nFor all issues, please send an email to support@a10networks.com \n\n\n## Helpful links\n\n### Improved speed\npypy: [http://pypy.org/index.html](http://pypy.org/index.html)\n\n### Old python versions\nDeadsnakes github: [https://github.com/deadsnakes](https://github.com/deadsnakes) \nDeadsnakes ppa: [https://launchpad.net/~deadsnakes/+archive/ubuntu/ppa](https://launchpad.net/~deadsnakes/+archive/ubuntu/ppa)\n\n\n",
"bugtrack_url": null,
"license": "Apache",
"summary": "A10 Networks ACOS API Client",
"version": "2.10.0",
"project_urls": {
"Homepage": "https://github.com/a10networks/acos-client"
},
"split_keywords": [
"a10",
"axapi",
"acos",
"adc",
"slb",
"load",
"balancer"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "111c0fb2f0a1df0c9feeb519adb221ebd9ae3869229b0a6b3b4c3d5af69f04b2",
"md5": "628145de56f2fbdaa8d822c9788866b2",
"sha256": "da7df735649ade9470e5e322b678ff4e1795008551a8d3fd9a95d4636a24cd6d"
},
"downloads": -1,
"filename": "acos_client-2.10.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "628145de56f2fbdaa8d822c9788866b2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 168401,
"upload_time": "2023-05-12T06:11:16",
"upload_time_iso_8601": "2023-05-12T06:11:16.854693Z",
"url": "https://files.pythonhosted.org/packages/11/1c/0fb2f0a1df0c9feeb519adb221ebd9ae3869229b0a6b3b4c3d5af69f04b2/acos_client-2.10.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "eb281dd1d07d7723a9596e5eeeba2dc93096cb32f2350b6adc2edc832837afc9",
"md5": "fbe82747a764e85b4bc62abb5e49144c",
"sha256": "c79b9871c04cef03305f08f65989ed912d5e4072dd3ee1f79868667d5ebef369"
},
"downloads": -1,
"filename": "acos-client-2.10.0.tar.gz",
"has_sig": false,
"md5_digest": "fbe82747a764e85b4bc62abb5e49144c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 78115,
"upload_time": "2023-05-12T06:15:30",
"upload_time_iso_8601": "2023-05-12T06:15:30.643198Z",
"url": "https://files.pythonhosted.org/packages/eb/28/1dd1d07d7723a9596e5eeeba2dc93096cb32f2350b6adc2edc832837afc9/acos-client-2.10.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-12 06:15:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "a10networks",
"github_project": "acos-client",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [],
"tox": true,
"lcname": "acos-client"
}
JSON
