Python SDK for Oracle Cloud Infrastructure
Clone or download
Latest commit 1e550ef Dec 13, 2018

README.rst

Oracle Cloud Infrastructure Python SDK

About

This is the Python SDK for Oracle Cloud Infrastructure. Python 2.7+ and 3.5+ are supported.

>>> import oci
# Set up config
>>> config = oci.config.from_file(
...     "~/.oci/config",
...     "DEFAULT")
# Create a service client
>>> identity = oci.identity.IdentityClient(config)
# Get the current user
>>> user = identity.get_user(config["user"]).data
>>> print(user)
{
  "compartment_id": "ocid1.tenancy.oc1...",
  "description": "Test user",
  "id": "ocid1.user.oc1...",
  "inactive_status": null,
  "lifecycle_state": "ACTIVE",
  "name": "test-user@corp.com",
  "time_created": "2016-08-30T23:46:44.680000+00:00"
}

The project is open source and maintained by Oracle Corp. The home page for the project is here.

Installation

It is highly recommended that a Python virtual environment be used when installing oci.

Please consult the Installing packages using pip and virtualenv guide from the Python Software Foundation for more information about virtual environments.

See the installation guide for installation troubleshooting and alternative install methods.

Once your virtual environment is active, oci can be installed using pip.

pip install oci

Development

See the development readme for information on how to make changes, run tests and build the documentation and wheel for the Python SDK.

Examples

Examples can be found here.

Documentation

Full documentation, including prerequisites and installation and configuration instructions, can be found here.

API reference can be found here.

A downloadable version of the documentation is include with in the release zip, which can be found here.

Help

See the “Questions or Feedback” section here.

Changes

See CHANGELOG.

Contributing

oci-python-sdk is an open source project. See CONTRIBUTING for details.

Oracle gratefully acknowledges the contributions to oci-python-sdk that have been made by the community.

Known Issues

You can find information on any known issues with the SDK here and under the “Issues” tab of this project's GitHub repository.

License

Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.

This SDK and sample is dual licensed under the Universal Permissive License 1.0 and the Apache License 2.0.

See LICENSE for more details.