Skip to main content

Open Telecom Client Tool

Project description

OTCclient
==========

[![Downloads](https://pypip.in/download/otcclient/badge.svg)](https://pypi.python.org/pypi/otcclient/)
[![License](https://pypip.in/license/otcclient/badge.svg)](https://pypi.python.org/pypi/otcclient/)


Open Telekom Cloud API tool
-----------------------------------------------

**#OTC #cloud #devops #IAAS #PAAS #DBAAS #BDAAS #container-services**

The purpose of the OTC Tool is to manage OTC cloud environments via the command line in a similar way to AWS CLI.
The OTC CLI provides a common interface to operation and DEVOPS teams to manage their cloud services.
On top of that, the language implementations (Python at the moment) are secure and relatively fast.

More at [OTC site](https://console.otc.t-systems.com/console/#/home)

OTC makes it easy to use the cloud environment. It exposes Native OpenStack APIs which are enhanced with extra
services and APIs from Huawei FusionSphere.


Documentation
-------------

[OTCclient Reference](https://docs.otc.t-systems.com/?locale=en-us)

Command line usage
-----

`````sh
$ sudo pip install python-otcclient
`````
or
`````sh
$ git clone https://github.com/OpenTelekomCloud/python-otcclient.git
`````

Usage
----------------

`````sh
OTC Tool Configuration Commands:
otc configure Configuring OTC client tool (mandatory in first use)
otc configure-proxy Configureing proxy settings ( ONLY https )
otc version Print OTC Client tool version
S3 Commands:
otc s3 ls List Buckets
otc s3 ls mybucket List Bucket files
otc s3api create-bucket --bucket mybucket Create New Bucket
otc.bat s3 cp s3://bucketname/filename.txt /localdir/filename.txt Download from bucket to local
otc.bat s3 cp /localdir/filename.txt s3://bucketname/filename.txt Upload file / directory to bucket
ECS Flavor & Image Commands:
otc ecs describe-flavors List avaliable flavors (VM templates)
otc ecs describe-images List image templates
VPC Commands:
otc ecs create-vpc --vpc-name myvpc --cidr 10.0.0.0/8 Crete new VPC
otc ecs describe-vpcs List VPCs
Subnet Commands:
otc ecs create-subnet --subnet-name subnettest --cidr 192.168.1.0/16 --gateway-ip 192.168.1.2 --primary-dns 8.8.8.8 --secondary-dns 8.8.4.4 --availability-zone eu-de-01 --vpc-name default-vpc Create new subnet for VPC
otc ecs describe-subnets --output json
Security Group Commands:
otc ecs create-security-group --group-name test2 --vpc-name default-vpc Create new security group
otc ecs describe-security-groups List existing security-groups
otc ecs authorize-security-group-ingress --group-name test2 --vpc-name default-vpc --protocol tcp --ethertype IPv4 --portmin 22 --portmax 25 Add new incomming rule to security-group
otc ecs authorize-security-group-egress --group-name test2 --vpc-name default-vpc --protocol tcp --ethertype IPv4 --portmin 7000 --portmax 7001 Add new outcomming rule to security-group
Keypair Commands:
otc ecs describe-key-pairs List key pairs
otc ecs create-key-pair --key-name mykeypair "ssh-rsa AA..." Create key pair
Instance Commands:
otc ecs describe-instances List VM instances
otc ecs describe-instances --instance-ids 097da903-ab95-44f3-bb5d-5fc08dfb6cc3 --output json Detailed information of specific VM instance (JSON)
otc ecs run-instances --count 1 --admin-pass yourpass123! --instance-type c1.medium --instance-name instancename --image-name Standard_CentOS_6.7_latest --subnet-name testsubnet --vpc-name testvpc --group-name testsecgroup Create new VM instance and START
otc ecs run-instances --count 1 --admin-pass yourpass123! --instance-type c1.medium --instance-name instancename --image-name Standard_CentOS_6.7_latest --subnet-name testsubnet --vpc-name testvpc --group-name testsecgroup --key-name testsshkeypair --file1 /otc/a=/otc/a
--associate-public-ip-address --wait-instance-running Create new VM instance with injected SSH keypair, with public ip, additional file injection, wait instance created and running
otc ecs describe-instances List VM instances
otc ecs stop-instances --instance-ids b6c602b1-06d0-4bdb-b764-5d43b47abc14 Stop VM instance
otc ecs start-instances --instance-ids b6c602b1-06d0-4bdb-b764-5d43b47abc14 Start VM instance
otc ecs reboot-instances --instance-ids b6c602b1-06d0-4bdb-b764-5d43b47abc14 Reboot VM instance
otc ecs delete-instances --instance-ids b6c602b1-06d0-4bdb-b764-5d43b47abc14 Delete VM instance (public ip + EVS also)
Backup Commands:
otc ecs create-snapshot --volume-id b197b8af-fe63-465f-97b6-5e5b89exxxx Create snapshot of volume
otc ecs describe-snapshots List backup volumes
otc ecs delete-snapshot --snapshot-id 0c942ff7-454e-xxxx Delete volume backup
Volume Commands:
otc ecs describe-volumes List volumes
otc ecs create-volume --volume-id b197b8af-fe63-465f-97b6-5e5b89exxx --snapshot-id 0c942ff7-454e-xxxx Create volume from snapshot
otc ecs create-volume --count 1 --volume-name myvolume --size 100 --volume-type SATA Create new Volume [type: SSD,SAS,SATA]
otc ecs attach-volume --instance-ids f344b625-6f73-44f8-ad56-9fcb05a523c4 --volume-id 8c0de9a7-9f61-4613-a68a-21f456cb7298 Attach volume to instance
otc ecs detach-volume --instance-ids f344b625-6f73-44f8-ad56-9fcb05a523c4 --volume-id 8c0de9a7-9f61-4613-a68a-21f456cb7298 Detach volume from instance
otc ecs delete-volume --volume-id 8c0de9a7-9f61-4613-a68a-21f456cb7298 Delete volume
Public Ip Commands:
otc otc ecs describe-addresses List public ip adresses
otc ecs allocate-address Allocate public ip address from public ip pool
otc ecs associate-address --public-ip 46.29.96.246 --network-interface-id b197b8af-fe63-465f-97b6-5e5b89exxx Assodicate public ip with Network Interface Id
`````

License
-------

**MIT**

The MIT License (MIT)

Copyright (c) 2016 OpenTelekomCloud

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Download
********


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-otcclient-0.3.65.zip (85.6 kB view details)

Uploaded Source

Built Distribution

python_otcclient-0.3.65-py2.py3-none-any.whl (110.8 kB view details)

Uploaded Python 2Python 3

File details

Details for the file python-otcclient-0.3.65.zip.

File metadata

  • Download URL: python-otcclient-0.3.65.zip
  • Upload date:
  • Size: 85.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.9.1 pkginfo/1.4.1 requests/2.18.1 setuptools/18.2 requests-toolbelt/0.8.0 tqdm/4.15.0 CPython/2.7.11

File hashes

Hashes for python-otcclient-0.3.65.zip
Algorithm Hash digest
SHA256 82a76649f6dab641fff1660dcd1ffb519c557da3a7d7ce3314f854baf42b839e
MD5 5c559bbc21c975a20c9fc0076b92ca50
BLAKE2b-256 0b41bfb0f15640d11a033be963a26874ff9034835d8c2cd68c82b236c8b23692

See more details on using hashes here.

File details

Details for the file python_otcclient-0.3.65-py2.py3-none-any.whl.

File metadata

  • Download URL: python_otcclient-0.3.65-py2.py3-none-any.whl
  • Upload date:
  • Size: 110.8 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.9.1 pkginfo/1.4.1 requests/2.18.1 setuptools/18.2 requests-toolbelt/0.8.0 tqdm/4.15.0 CPython/2.7.11

File hashes

Hashes for python_otcclient-0.3.65-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 89c861484fd1ca2cba9bea025c2f0c1e5a4a55edd20bd81ede57e8b8dbe2bda5
MD5 759d667cba0b7247190e3cb7a5729e0a
BLAKE2b-256 f2d74542310e53c8287c1cd876d1ac07f23f2e03e6f1e3b9132e6960bd36a806

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page