kscore

A low-level interface to a growing number of KSC Web Services. Reference from botocore.

Documentation

安装

• pip 安装

  • pip install kscore

• github 安装

  • https://github.com/liuyichen/kscore 下载
  • python setup.py install

Credentials 配置

• 参考examples内示例

  • 配置文件: .kscore.cfg
  • 所在位置: '/etc/kscore.cfg' 或 './.kscore.cfg' 或 'C:\kscore.cfg'
  • 注意: 使用相对路径时，需与运行目录保持一致。

[Credentials]
ks_access_key_id=AKLTyW1V6ZWET7aIvdCeIH1cwQ
ks_secret_access_key=OEoTK4IgEBIq3rlFsbpcNDs87w513D6aOwdXxP6QHuvWlonSRYeKQyTzqc1XkUvpuQ==

• 或运行时配置

  • session.set_credentials(access_key_id, secret_access_key, session_token=None)

Service 使用

• create_client 方法

  service_name 服务，必须参数，例 iam

  region_name=None 大区，必须参数，全局服务可以为None

  api_version=None API版本，默认使用最近版本

  use_ssl=True 是否使用HTTPS，如接口支持情况下，优先使用

  verify=None 是否验证SSL证书

  endpoint_url=None

  ks_access_key_id=None

  ks_secret_access_key=None

  ks_session_token=None

• 已支持大区 region_name 参考data/endpoints.yaml

  cn-beijing-5 北京5区

  cn-beijing-6 北京6区

  cn-shanghai-2 上海2区

• IAM

from kscore.session import get_session

if __name__ == "__main__":
    s = get_session()

    client = s.create_client("iam", use_ssl=False)

    users = client.list_users()

• KEC

from kscore.session import get_session

if __name__ == "__main__":
    s = get_session()

    client = s.create_client("kec", "cn-beijing-6", use_ssl=False)

    client.[your method]()

• MONITOR

from kscore.session import get_session

if __name__ == "__main__":
    s = get_session()

    client = s.create_client("monitor", "cn-beijing-5", use_ssl=True)

    m=client.get_metric_statistics(InstanceID="6f582c78-5d49-438e-bf2d-db4345daf503",Namespace="eip",MetricName="qos.bps_in",StartTime="2016-08-16T17:09:00Z",EndTime="2016-08-16T23:56:00Z",Period="600",Aggregate="Average")

    print json.dumps(m,sort_keys=True,indent=4)

• 更多

欢迎补充

Data 更多服务配置

• 参考 https://github.com/liuyichen/kscore/issues

• ENDPOINT 配置

  • data\endpoints.yaml

version: n
partitions:
- partition:
  ...
  # REGION 列表
  regions:
    ...
# 服务列表
- service:
  ...

• SERVICE 配置

  • data\[service]\[version]\service-2.yaml

version: n
# API 配置
metadata:
  ...
# 操作方法
operations:
  ...
# 请求及返回的结构体
shapes:
  ...

• 请参考IAM,KEC等配置

  配置文件变更后请重新安装 python setup.py install

TESTS 测试

• 基本接口测试

testsacceptance> behave

• 各服务测试用例

tests>nosetests --with-xunit --cover-erase --with-coverage --cover-package kscore --cover-xml -v integration

Contact Information

群 号: 367780788 邮 箱: [email protected]