SDK for Java

The Oracle Cloud Infrastructure SDK for Java enables you to write code to manage Oracle Cloud Infrastructure resources.

This SDK 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.

Download: GitHub or Maven.


Cloud Shell: The SDK for Java is pre-configured with your credentials and ready to use immediately from within Cloud Shell. For more information on using the SDK for Java from within Cloud Shell, see SDK for Java Cloud Shell Quick Start.

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


To use the SDK for Java, you must have the following:

  • An Oracle Cloud Infrastructure account.
  • A user created in that account, in a group with a policy that grants the desired permissions. This can be a user for yourself, or another person/system that needs to call the API. For an example of how to set up a new user, group, compartment, and policy, see Adding Users. For a list of typical policies you may want to use, see Common Policies.
  • A key pair used for signing API requests, with the public key uploaded to Oracle. Only the user calling the API should be in possession of the private key. For more information, see Configuring the SDK.
  • Java 8, Java 11, or Java 17 (see Java Support Notes).
  • A TTL value of 60. For more information, see Configuring the SDK.

Java Support Notes

Java 17 Support
  • Versions 2.23.0 and later of the OCI SDK have been tested to run and compile with Java 17.

Java 11 Support

  • The OCI SDK for Java has been tested with Java version 11.
  • Java 8 is required to build the OCI SDK for Java from source, but once it's built you can use the OCI SDK for Java with Java version 11.
  • For OCI Java SDK versions before 1.27.0, you need to include the javax.bind and sun.bind dependencies, since Java 11 no longer includes Java EE and CORBA modules. For more information, see the JDK 11 Release Notes.

Services Supported

  • Account Management
  • AI Anomaly Detection
  • AI Language
  • AI Speech
  • AI Vision
  • Analytics Cloud
  • Announcements
  • API Gateway
  • Application Dependency Management
  • Application Management
  • Application Performance Monitoring
  • Audit
  • Autoscaling (Compute)
  • Bastion
  • Big Data Service
  • Blockchain Platform
  • Budgets
  • Build
  • Certificates
  • Classic Migration Service
  • Cloud Bridge
  • Cloud Guard
  • Cloud Migrations
  • Compute Instance Agent (Oracle Cloud Agent)
  • Console Dashboard
  • Container Engine for Kubernetes
  • Content Management
  • Core Services (Networking, Compute, Block Volume)
  • Data Catalog
  • Data Connectivity Management
  • Data Flow
  • Data Integration
  • Data Labeling
  • Data Science
  • Data Safe
  • Data Transfer
  • Database
  • Database Management
  • Database Migration
  • Database Tools
  • DevOps
  • Digital Assistant
  • Digital Media
  • Disaster Recovery
  • DNS
  • Email Delivery
  • Enterprise Manager Warehouse
  • Events
  • File Storage
  • Functions
  • Fusion Apps as a Service
  • Generic Artifacts
  • GoldenGate
  • Governance Rules
  • Health Checks
  • IAM
  • Integration Generation 2
  • Java Management
  • 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 Database
  • Network Firewall
  • Network Load Balancing
  • Network Monitoring
  • Networking Topology
  • NoSQL Database Cloud
  • Notifications
  • Object Storage
  • OCI Registry
  • OneSubscription
  • Operations Insights
  • Operator Access Control
  • Optimizer
  • Organizations
  • OS Management
  • Process Automation
  • Quotas
  • Resource Manager
  • Roving Edge Infrastructure
  • Search
  • Secret Management (for the Vault service)
  • Service Catalog
  • Service Connector Hub
  • Service Mesh
  • Source Code Management
  • Stack Monitoring
  • Streaming
  • Support Management
  • Threat Intelligence
  • Usage
  • Visual Builder
  • VMWare Solution
  • Vulnerability Scanning
  • Web Application Acceleration and Security
  • Work Requests (Compute, Database)