跳转到主要内容

TransIP API连接器

项目描述

Build Status Documentation Status

此库旨在实现TransIP API的Python版本。

快速开始

先决条件

  • 确保您在TransIP有账户

  • 启用 API (https://www.transip.nl/cp/mijn-account/#api)

  • 将您的IP列入白名单。

  • 生成新的密钥对。
    • 将私钥复制粘贴到文件中。

    • 将私钥放入名为 decrypted_key 的文件中,放在此 README.rst 文件旁边。

设置

您可以直接从PyPi获取库

$ pip install transip

示例

命令行解释器目前功能有限。默认情况下,它执行 getDomainNames() 调用,但使用“-u”选项也可以添加或更新 DNS 记录。当使用“-h”选项调用时,将显示所有可用选项。

$ transip-api
[example.com, example.org, example.net]

$ transip-api -h
usage: transip-api [-h] [-l LOGINNAME] [-s] [-a] [-u] [-d]
                   [--domain-name DOMAIN_NAME] [--entry-name ENTRY_NAME]
                   [--entry-expire ENTRY_EXPIRE] [--entry-type ENTRY_TYPE]
                   [--entry-content ENTRY_CONTENT] [--api-key PRIVATE_KEY_FILE]

optional arguments:
  -h, --help            show this help message and exit
  -l LOGINNAME, --login-name LOGINNAME
                        TransIP username
  -s, --show-dns-entries
                        show all DNS entries for a domain
  -a, --add-dns-entry   add an entry in the DNS
  -u, --update-dns-entry
                        update an entry in the DNS
  -d, --delete-dns-entry
                        delete an entry in the DNS
  --domain-name DOMAIN_NAME
                        domain name to use
  --entry-name ENTRY_NAME
                        name of the DNS entry
  --entry-expire ENTRY_EXPIRE
                        expire time of the DNS entry
  --entry-type ENTRY_TYPE
                        type of the DNS entry
  --entry-content ENTRY_CONTENT
                        content of the DNS entry
  --api-key PRIVATE_KEY_FILE
                        TransIP private key

添加/更新记录的示例

$ transip-api -l githubuser -u --api-key privatekey --domain-name example.com --entry-name testentry --entry-expire 86400 --entry-type A --entry-content 127.0.0.1
Request finished successfully.

文档

更详细的文档可以在 docs 目录中找到,或访问 https://transip-api.readthedocs.io/en/latest/

常见问题解答

问题

当使用库时,我遇到 SSL 错误,例如

urllib2.URLError: <urlopen error [Errno 1] _ssl.c:510: error:14077458:SSL routines:SSL23_GET_SERVER_HELLO:tlsv1 unrecognized name>

答案

suds 库对 SSL 的支持相当有限,这取决于 Python 版本。为了解决这个问题,可以使用 suds_requests 库,该库用 requests 库替换了 urllib2。此外,requests 库会自动池连接,这使得库的使用略快一些。要安装

pip install suds_requests

项目详情


下载文件

下载适用于您的平台的文件。如果您不确定该选择哪个,请了解更多关于 安装包 的信息。

源分布

transip-2.1.2.tar.gz (14.7 kB 查看哈希值)

上传时间

构建分布

transip-2.1.2-py2.py3-none-any.whl (15.9 kB 查看哈希值)

上传时间 Python 2 Python 3

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面