Command Line Interface (CLI)

The CLI is a small-footprint tool that you can use on its own or with the Console to complete Oracle Cloud Infrastructure tasks. The CLI provides the same core functionality as the Console, plus additional commands. Some of these, such as the ability to run scripts, extend Console functionality.

Tip

Cloud Shell: The CLI is pre-configured with your credentials and ready to use immediately from within Cloud Shell. For more information on using the CLI from within Cloud Shell, see Getting Started with Cloud Shell.

Oracle Linux Cloud Developer image: The CLI is pre-installed on the Oracle Linux Cloud Developer platform image. For more information, see Oracle Linux Cloud Developer.

Oracle Autonomous Linux: The CLI is pre-installed on Oracle Autonomous Linux versions 7 and 8. For more information, See Oracle Autonomous Linux Image.

This CLI and sample is dual-licensed under the Universal Permissive License 1.0 and the Apache License 2.0; third-party content is separately licensed as described in the code.

The CLI is built on the Oracle Cloud Infrastructure SDK for Python and runs on Mac, Windows, or Linux. The Python code makes calls to Oracle Cloud Infrastructure APIs to provide the functionality implemented for the various services. These are REST APIs that use HTTPS requests and responses. For more information, see About the API.

Installation: See Quickstart.

Reference: You can get immediate help on any CLI command. To get started, run oci --help from the command line. You can also view the Command Line Reference. This reference is derived from the APIs and help text in the Python source code.

Requirements

To install and use the CLI, you must have:

Supported Python Versions and Operating Systems

This table lists the versions of Python supported by the CLI for each operating system:

Operating System Supported Python Versions for CLI
CentOS 7 3.6 to 3.9
CentOS 8 3.6 to 3.9
Oracle Autonomous Linux 7.9 3.6 to 3.9
Oracle Linux 7.8 3.6 to 3.9
Oracle Linux 7.9 3.6 to 3.9
Oracle Linux 8 3.6 to 3.11
Oracle Linux 9 3.7 to 3.11
Ubuntu 18.0.4 3.6 to 3.11
Ubuntu 20.0.4 3.6 to 3.11
Windows Desktop 10 & 11 3.6 to 3.11
Windows Server (2012/2016/2019) 3.6 to 3.11

Newer versions of Python may not be immediately supported. The CLI might work on unlisted operating systems, but we do not test them for compatibility.

If you use the CLI installer and do not have Python on your machine, the installer offers to automatically install Python for you. If you already have Python installed on your machine, you can use the python --version command to find out which version is installed.

Services Supported

  • Access Governance
  • AI Anomaly Detection
  • AI Language
  • AI Speech
  • AI Vision
  • Analytics Cloud
  • Announcements
  • API Gateway
  • Classic Migration Service
  • Application Dependency Management
  • Application Performance Monitoring
  • Audit
  • Autonomous Recovery
  • Autoscaling (Compute)
  • Bastion
  • Big Data Service
  • Blockchain Platform
  • Budgets
  • Build
  • Cache with Redis
  • Certificates
  • Cloud Bridge
  • Cloud Guard
  • Cloud Migrations
  • Compute Cloud@Customer
  • Compute Instance Agent (Oracle Cloud Agent)
  • Connector Hub
  • Container Engine for Kubernetes
  • Container Instances
  • Content Management
  • Core Services (Networking, Compute, Block Volume)
  • Data Connectivity Management
  • Database Migration
  • Data Catalog
  • Data Flow
  • Data Labeling
  • Data Integration
  • Data Labeling
  • Data Safe
  • Data Science
  • Data Transfer
  • Database
  • Database Management
  • Database Tools
  • DevOps
  • Digital Assistant
  • Digital Media
  • Disaster Recovery
  • DNS
  • Document Understanding
  • Email Delivery
  • Enterprise Manager Warehouse
  • Events
  • Exadata Fleet Update
  • File Storage
  • Functions
  • Fusion Apps as a Service
  • Generative AI
  • Generative AI Inference
  • Generic Artifacts
  • Globally Distributed Database
  • Golden Gate
  • Governance Rules
  • Health Checks
  • IAM
  • Identity Domains
  • Integration Generation 2
  • Java Management
  • Java Management Service Downloads
  • Key Management (for the Vault service)
  • License Manager
  • Limits
  • Load Balancer
  • Logging
  • Logging Analytics
  • Logging Search
  • Logging Ingestion
  • Managed Access
  • Management Agent Cloud
  • Management Dashboard
  • Marketplace
  • Monitoring
  • MySQL Heatwave
  • Network Firewall
  • Network Load Balancing
  • Network Monitoring
  • Networking Topology
  • NoSQL Database Cloud
  • Notifications
  • Object Storage
  • OCI Control Center
  • OCI Registry
  • OneSubscription
  • Operations Insights
  • Operator Access Control
  • Optimizer
  • Organizations
  • OS Management
  • OS Management Hub
  • PostgreSQL
  • Process Automation
  • Publisher
  • Queue Service
  • Quotas
  • Resource Manager
  • Search
  • Secret Management (for the Vault service)
  • Secret Retrieval (for the Vault service)
  • Secure Desktops
  • Service Catalog
  • Service Mesh
  • Source Code Management
  • Stack Monitoring
  • Streaming
  • Support Management
  • Threat Intelligence
  • Usage
  • Visual Builder
  • VMWare Solution
  • Web Application Acceleration and Security
  • Work Requests (Compute, Database)