Releasing version 2.164.1

Releasing version 2.164.1

Author: oci-dex-release-bot

CHANGELOG.rst

@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`_.
 
+====================
+2.164.1 - 2025-12-09
+====================
+
+Added 
+----- 
+* Support for listing elastic pool cost savings in the Database service 
+* Support for OpenAI GPT-OSS model in the Generative AI Inference service 
+* Support for distributed tracing via opc-request-id 
+
 ====================
 2.164.0 - 2025-11-18
 ====================

docs/api/database.rst

@@ -308,6 +308,8 @@ Database
  oci.database.models.EnableExternalPluggableDatabaseStackMonitoringDetails
  oci.database.models.EnablePluggableDatabaseManagementDetails
  oci.database.models.EncryptionKeyLocationDetails
+ oci.database.models.EstimateCostSavingSummary
+ oci.database.models.EstimateCostSavingsSummaryCollection
  oci.database.models.EstimatedPatchingTime
  oci.database.models.ExadataDbSystemMigration
  oci.database.models.ExadataDbSystemMigrationSummary

docs/api/database/models/oci.database.models.EstimateCostSavingSummary.rst

@@ -0,0 +1,11 @@
+EstimateCostSavingSummary
+=========================
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: EstimateCostSavingSummary
+ :show-inheritance:
+ :special-members: __init__
+ :members:
+ :undoc-members:
+ :inherited-members:

docs/api/database/models/oci.database.models.EstimateCostSavingsSummaryCollection.rst

@@ -0,0 +1,11 @@
+EstimateCostSavingsSummaryCollection
+====================================
+
+.. currentmodule:: oci.database.models
+
+.. autoclass:: EstimateCostSavingsSummaryCollection
+ :show-inheritance:
+ :special-members: __init__
+ :members:
+ :undoc-members:
+ :inherited-members:

examples/publish_t2_metrics_example.py

@@ -0,0 +1,60 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates. All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+# This script gives an example on passing in a request model for an API to the pagination call.
+
+# !!! THIS EXAMPLE HAS INFORMATION ABOUT R1 AND IS INTENDED FOR INTERNAL CUSTOMERS. MASK DETAILS FOR PUBLIC VERSION !!!
+
+from datetime import datetime, timedelta, timezone
+
+from oci.auth.signers import InstancePrincipalsSecurityTokenSigner, OauthExchangeTokenSigner
+from oci.monitoring import MonitoringClient, models
+
+metrics_endpoint = "https://telemetry-ingestion.us-ashburn-1.oraclecloud.com"
+
+target_compartment = ""
+root_cert_path = ""
+
+instance_principal_signer = InstancePrincipalsSecurityTokenSigner(
+ federation_endpoint='https://auth.us-ashburn-1.oraclecloud.com/v1/x509')
+
+oauth_exchange_signer = OauthExchangeTokenSigner(instance_principal_signer,
+ scope=f"monitoring_write_urn-{target_compartment}:instance",
+ cert_bundle_verify=root_cert_path,
+ target_compartment=target_compartment,
+ oauth_token_endpoint="https://auth.region.oraclecloud.com}/v1/oauth2/scoped")
+
+monitoring = MonitoringClient({}, service_endpoint=metrics_endpoint, signer=oauth_exchange_signer)
+
+metric_data = [models.MetricDataDetails(
+ namespace="",
+ resource_group="",
+ compartment_id=target_compartment,
+ name="SDKTestMetric",
+ dimensions={
+ "resourceId": "exampleDimensionResource"
+ },
+ metadata={
+ "unit": "count",
+ },
+ datapoints=[
+ {
+ "timestamp": (
+ datetime.now(timezone.utc) - timedelta(minutes=5)
+ ).strftime('%Y-%m-%dT%H:%M:%S.000Z'),
+ "value": 15,
+ "count": 1
+ }
+ ]
+) for i in range(4)]
+print("Posting metric data....")
+
+post_metric_data_details = models.PostMetricDataDetails(
+ metric_data=metric_data,
+ batch_atomicity=models.PostMetricDataDetails.BATCH_ATOMICITY_ATOMIC
+)
+post_metric_result = monitoring.post_metric_data(post_metric_data_details)
+
+print("post metrics response status: ", post_metric_result.status)
+print("post metrics response data: ", post_metric_result.data)

examples/workload_identity_federation_signer_example.py

@@ -11,10 +11,10 @@
 
 # -----------------------------------------------------------------------------
 # Script usage:
-# python workload_identity_federation_signer_example.py <region> <resource_ocid> <oci_domain_id> <oci_client_id> <oci_client_secret>
+# python workload_identity_federation_signer_example.py <region> <resource_ocid> <oci_domain_url> <oci_client_id> <oci_client_secret>
 #
 # Example:
-# python workload_identity_federation_signer_example.py us-ashburn-1 ocid1.vaultsecret.oc1.iad.xxxxx domain_id client_id client_secret
+# python workload_identity_federation_signer_example.py us-ashburn-1 ocid1.vaultsecret.oc1.iad.xxxxx https://idcs-xxxxx.identity.oraclecloud.com client_id client_secret
 #
 # Notes:
 # - The second argument (<resource_ocid>) is shown as a secret OCID in the example,
@@ -24,12 +24,12 @@
 
 if len(sys.argv) != 6:
  raise RuntimeError(
- "Usage: python workload_identity_federation_signer_example.py <region> <resource_ocid> <oci_domain_id> <oci_client_id> <oci_client_secret>"
+ "Usage: python workload_identity_federation_signer_example.py <region> <resource_ocid> <oci_domain_url> <oci_client_id> <oci_client_secret>"
  )
 
 region = sys.argv[1]
 resource_ocid = sys.argv[2] # Can be secret_id, bucket_id, etc.
-oci_domain_id = sys.argv[3]
+oci_domain_url = sys.argv[3]
 oci_client_id = sys.argv[4]
 oci_client_secret = sys.argv[5]
 
@@ -62,7 +62,7 @@ def get_jwt():
 # -----------------------------------------------------------------------------
 # TokenExchangeSigner
 # -----------------------------------------------------------------------------
-signer = oci.auth.signers.TokenExchangeSigner(get_jwt, oci_domain_id, oci_client_id, oci_client_secret)
+signer = oci.auth.signers.TokenExchangeSigner(get_jwt, oci_domain_url, oci_client_id, oci_client_secret)
 
 # -----------------------------------------------------------------------------
 # Example: Use the resource OCID with SecretsClient

src/oci/auth/auth_utils.py

@@ -4,7 +4,10 @@
 
 import random
 import warnings
-from oci._vendor import six
+import oci
+from oci._vendor import six, requests
+from oci._vendor.requests import HTTPError
+from oci.regions import GET_REGION_URL, METADATA_AUTH_HEADERS
 
 
 def get_tenancy_id_from_certificate(cert):
@@ -50,3 +53,21 @@ def generate_unique_id():
  b = [random.randrange(256) for i in range(16)]
  hex_string = ''.join(format(x, '02x') for x in b)
  return hex_string
+
+
+def get_region_data_from_imds():
+ """
+ Response is of format
+ {
+ "realmdomaincomponent": "oraclecloud.com",
+ "realmkey": "oc1",
+ "regionidentifier": "us-phoenix-1",
+ "regionkey": "phx"
+ }
+ """
+ response = requests.get(GET_REGION_URL, timeout=(10, 60), headers=METADATA_AUTH_HEADERS)
+ try:
+ response.raise_for_status()
+ except HTTPError as e:
+ raise oci.exceptions.ServiceError(e.response.status_code, e.errno, e.response.headers, str(e))
+ return response.json()

src/oci/auth/signers/__init__.py

@@ -14,4 +14,5 @@
 from .ephemeral_resource_principals_v21_signer import EphemeralResourcePrincipalV21Signer # noqa: F401
 from .key_pair_signer import KeyPairSigner # noqa: F401
 from .nested_resource_principals_signer import NestedResourcePrincipals # noqa: F401
+from .oauth_exhange_token_signer import OauthExchangeTokenSigner # noqa: F401
 from .token_exchange_signer import TokenExchangeSigner # noqa: F401