oci 2.149.0__py3-none-any.whl → 2.149.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (498) hide show
  1. oci/__init__.py +2 -2
  2. oci/access_governance_cp/access_governance_cp_client.py +8 -8
  3. oci/adm/application_dependency_management_client.py +36 -36
  4. oci/ai_anomaly_detection/anomaly_detection_client.py +36 -36
  5. oci/ai_document/ai_service_document_client.py +26 -26
  6. oci/ai_language/ai_service_language_client.py +44 -44
  7. oci/ai_speech/ai_service_speech_client.py +19 -19
  8. oci/ai_vision/ai_service_vision_client.py +28 -28
  9. oci/analytics/analytics_client.py +24 -24
  10. oci/announcements_service/announcement_client.py +5 -5
  11. oci/announcements_service/announcement_subscription_client.py +9 -9
  12. oci/announcements_service/announcements_preferences_client.py +4 -4
  13. oci/announcements_service/service_client.py +1 -1
  14. oci/apigateway/api_gateway_client.py +21 -21
  15. oci/apigateway/deployment_client.py +6 -6
  16. oci/apigateway/gateway_client.py +6 -6
  17. oci/apigateway/subscribers_client.py +6 -6
  18. oci/apigateway/usage_plans_client.py +6 -6
  19. oci/apigateway/work_requests_client.py +5 -5
  20. oci/apm_config/config_client.py +340 -9
  21. oci/apm_config/models/__init__.py +22 -0
  22. oci/apm_config/models/apdex_rules_summary.py +7 -0
  23. oci/apm_config/models/config_summary.py +35 -2
  24. oci/apm_config/models/copy_configuration_details.py +86 -0
  25. oci/apm_config/models/export_configuration_details.py +76 -0
  26. oci/apm_config/models/export_configuration_response_details.py +70 -0
  27. oci/apm_config/models/export_import_apdex_rules_summary.py +128 -0
  28. oci/apm_config/models/export_import_config_summary.py +226 -0
  29. oci/apm_config/models/export_import_metric_group_summary.py +232 -0
  30. oci/apm_config/models/export_import_options_summary.py +194 -0
  31. oci/apm_config/models/export_import_span_filter_summary.py +163 -0
  32. oci/apm_config/models/import_configuration_details.py +113 -0
  33. oci/apm_config/models/import_configuration_failed_item_summary.py +193 -0
  34. oci/apm_config/models/import_configuration_failed_items_collection.py +70 -0
  35. oci/apm_config/models/metric_group_summary.py +7 -0
  36. oci/apm_config/models/options_summary.py +7 -0
  37. oci/apm_config/models/span_filter_summary.py +7 -0
  38. oci/apm_control_plane/apm_domain_client.py +14 -14
  39. oci/apm_synthetics/apm_synthetic_client.py +28 -28
  40. oci/apm_traces/attributes_client.py +8 -8
  41. oci/apm_traces/query_client.py +2 -2
  42. oci/apm_traces/trace_client.py +4 -4
  43. oci/appmgmt_control/appmgmt_control_client.py +8 -8
  44. oci/artifacts/artifacts_client.py +32 -32
  45. oci/audit/audit_client.py +3 -3
  46. oci/autoscaling/auto_scaling_client.py +11 -11
  47. oci/bastion/bastion_client.py +15 -15
  48. oci/bds/bds_client.py +84 -84
  49. oci/blockchain/blockchain_platform_client.py +27 -27
  50. oci/budget/budget_client.py +10 -10
  51. oci/capacity_management/capacity_management_client.py +32 -32
  52. oci/certificates/certificates_client.py +5 -5
  53. oci/certificates_management/certificates_management_client.py +32 -32
  54. oci/cims/incident_client.py +6 -6
  55. oci/cloud_bridge/common_client.py +5 -5
  56. oci/cloud_bridge/discovery_client.py +15 -15
  57. oci/cloud_bridge/inventory_client.py +16 -16
  58. oci/cloud_bridge/ocb_agent_svc_client.py +23 -23
  59. oci/cloud_guard/cloud_guard_client.py +155 -155
  60. oci/cloud_migrations/migration_client.py +43 -43
  61. oci/cluster_placement_groups/cluster_placement_groups_cp_client.py +13 -13
  62. oci/compute_cloud_at_customer/compute_cloud_at_customer_client.py +12 -12
  63. oci/compute_instance_agent/compute_instance_agent_client.py +6 -6
  64. oci/compute_instance_agent/plugin_client.py +2 -2
  65. oci/compute_instance_agent/pluginconfig_client.py +1 -1
  66. oci/container_engine/container_engine_client.py +44 -44
  67. oci/container_instances/container_instance_client.py +18 -18
  68. oci/core/blockstorage_client.py +60 -60
  69. oci/core/compute_client.py +633 -113
  70. oci/core/compute_client_composite_operations.py +82 -0
  71. oci/core/compute_management_client.py +32 -32
  72. oci/core/models/__init__.py +10 -0
  73. oci/core/models/change_compute_host_compartment_details.py +76 -0
  74. oci/core/models/compute_host.py +826 -0
  75. oci/core/models/compute_host_collection.py +70 -0
  76. oci/core/models/compute_host_summary.py +720 -0
  77. oci/core/models/update_compute_host_details.py +154 -0
  78. oci/core/virtual_network_client.py +258 -258
  79. oci/dashboard_service/dashboard_client.py +6 -6
  80. oci/dashboard_service/dashboard_group_client.py +6 -6
  81. oci/data_catalog/data_catalog_client.py +149 -149
  82. oci/data_flow/data_flow_client.py +45 -45
  83. oci/data_integration/data_integration_client.py +163 -163
  84. oci/data_labeling_service/data_labeling_management_client.py +17 -17
  85. oci/data_labeling_service_dataplane/data_labeling_client.py +15 -15
  86. oci/data_safe/data_safe_client.py +317 -317
  87. oci/data_science/data_science_client.py +7469 -3597
  88. oci/data_science/data_science_client_composite_operations.py +981 -105
  89. oci/data_science/models/__init__.py +118 -0
  90. oci/data_science/models/application_component.py +193 -0
  91. oci/data_science/models/auth_configuration.py +115 -0
  92. oci/data_science/models/change_ml_application_compartment_details.py +76 -0
  93. oci/data_science/models/change_ml_application_implementation_compartment_details.py +70 -0
  94. oci/data_science/models/change_ml_application_instance_compartment_details.py +76 -0
  95. oci/data_science/models/change_ml_application_instance_view_compartment_details.py +76 -0
  96. oci/data_science/models/configuration_property.py +101 -0
  97. oci/data_science/models/configuration_property_schema.py +276 -0
  98. oci/data_science/models/create_auth_configuration_details.py +95 -0
  99. oci/data_science/models/create_iam_auth_configuration_create_details.py +48 -0
  100. oci/data_science/models/create_idcs_auth_configuration_details.py +79 -0
  101. oci/data_science/models/create_idcs_custom_service_auth_configuration_details.py +203 -0
  102. oci/data_science/models/create_ml_application_details.py +206 -0
  103. oci/data_science/models/create_ml_application_implementation_details.py +264 -0
  104. oci/data_science/models/create_ml_application_instance_details.py +326 -0
  105. oci/data_science/models/data_flow_application_application_component.py +94 -0
  106. oci/data_science/models/data_science_job_application_component.py +94 -0
  107. oci/data_science/models/data_science_model_application_component.py +94 -0
  108. oci/data_science/models/data_science_model_deployment_instance_component.py +125 -0
  109. oci/data_science/models/data_science_pipeline_application_component.py +94 -0
  110. oci/data_science/models/data_science_schedule_instance_component.py +94 -0
  111. oci/data_science/models/disable_ml_application_instance_view_trigger_details.py +70 -0
  112. oci/data_science/models/enable_ml_application_instance_view_trigger_details.py +70 -0
  113. oci/data_science/models/generic_oci_resource_application_component.py +125 -0
  114. oci/data_science/models/generic_oci_resource_instance_component.py +125 -0
  115. oci/data_science/models/iam_auth_configuration.py +49 -0
  116. oci/data_science/models/idcs_auth_configuration.py +111 -0
  117. oci/data_science/models/idcs_custom_service_auth_configuration.py +204 -0
  118. oci/data_science/models/implementation_log_details.py +140 -0
  119. oci/data_science/models/implementation_logging.py +120 -0
  120. oci/data_science/models/instance_component.py +201 -0
  121. oci/data_science/models/ml_application.py +410 -0
  122. oci/data_science/models/ml_application_collection.py +70 -0
  123. oci/data_science/models/ml_application_implementation.py +666 -0
  124. oci/data_science/models/ml_application_implementation_collection.py +70 -0
  125. oci/data_science/models/ml_application_implementation_summary.py +487 -0
  126. oci/data_science/models/ml_application_implementation_version.py +600 -0
  127. oci/data_science/models/ml_application_implementation_version_collection.py +70 -0
  128. oci/data_science/models/ml_application_implementation_version_summary.py +487 -0
  129. oci/data_science/models/ml_application_instance.py +736 -0
  130. oci/data_science/models/ml_application_instance_collection.py +70 -0
  131. oci/data_science/models/ml_application_instance_internal_trigger.py +125 -0
  132. oci/data_science/models/ml_application_instance_summary.py +456 -0
  133. oci/data_science/models/ml_application_instance_view.py +829 -0
  134. oci/data_science/models/ml_application_instance_view_collection.py +70 -0
  135. oci/data_science/models/ml_application_instance_view_summary.py +580 -0
  136. oci/data_science/models/ml_application_package_argument_details.py +210 -0
  137. oci/data_science/models/ml_application_package_arguments.py +70 -0
  138. oci/data_science/models/ml_application_summary.py +332 -0
  139. oci/data_science/models/object_storage_bucket_instance_component.py +125 -0
  140. oci/data_science/models/object_storage_object_instance_component.py +156 -0
  141. oci/data_science/models/prediction_endpoint_details.py +101 -0
  142. oci/data_science/models/prediction_uri.py +101 -0
  143. oci/data_science/models/trigger_ml_application_instance_flow_details.py +70 -0
  144. oci/data_science/models/update_ml_application_details.py +144 -0
  145. oci/data_science/models/update_ml_application_implementation_details.py +171 -0
  146. oci/data_science/models/update_ml_application_implementation_version_details.py +113 -0
  147. oci/data_science/models/update_ml_application_instance_details.py +206 -0
  148. oci/data_science/models/update_ml_application_instance_view_details.py +113 -0
  149. oci/data_science/models/work_request.py +59 -3
  150. oci/data_science/models/work_request_summary.py +59 -3
  151. oci/database/database_client.py +414 -414
  152. oci/database_management/db_management_client.py +228 -228
  153. oci/database_management/diagnosability_client.py +4 -4
  154. oci/database_management/managed_my_sql_databases_client.py +9 -9
  155. oci/database_management/perfhub_client.py +1 -1
  156. oci/database_management/sql_tuning_client.py +17 -17
  157. oci/database_migration/database_migration_client.py +42 -42
  158. oci/database_tools/database_tools_client.py +23 -23
  159. oci/dblm/db_life_cycle_management_client.py +12 -12
  160. oci/delegate_access_control/delegate_access_control_client.py +26 -26
  161. oci/delegate_access_control/work_request_client.py +4 -4
  162. oci/demand_signal/occ_demand_signal_client.py +7 -7
  163. oci/desktops/desktop_service_client.py +21 -21
  164. oci/devops/devops_client.py +141 -141
  165. oci/disaster_recovery/disaster_recovery_client.py +31 -31
  166. oci/dns/dns_client.py +54 -54
  167. oci/dts/appliance_export_job_client.py +6 -6
  168. oci/dts/shipping_vendors_client.py +1 -1
  169. oci/dts/transfer_appliance_client.py +8 -8
  170. oci/dts/transfer_appliance_entitlement_client.py +3 -3
  171. oci/dts/transfer_device_client.py +5 -5
  172. oci/dts/transfer_job_client.py +6 -6
  173. oci/dts/transfer_package_client.py +7 -7
  174. oci/em_warehouse/em_warehouse_client.py +13 -13
  175. oci/email/email_client.py +31 -31
  176. oci/email_data_plane/email_dp_client.py +1 -1
  177. oci/events/events_client.py +6 -6
  178. oci/file_storage/file_storage_client.py +74 -74
  179. oci/fleet_apps_management/fleet_apps_management_admin_client.py +25 -25
  180. oci/fleet_apps_management/fleet_apps_management_client.py +35 -35
  181. oci/fleet_apps_management/fleet_apps_management_maintenance_window_client.py +5 -5
  182. oci/fleet_apps_management/fleet_apps_management_operations_client.py +26 -26
  183. oci/fleet_apps_management/fleet_apps_management_runbooks_client.py +12 -12
  184. oci/fleet_software_update/fleet_software_update_client.py +46 -46
  185. oci/functions/functions_invoke_client.py +1 -1
  186. oci/functions/functions_management_client.py +16 -16
  187. oci/fusion_apps/fusion_applications_client.py +41 -41
  188. oci/generative_ai/generative_ai_client.py +22 -22
  189. oci/generative_ai_agent/generative_ai_agent_client.py +711 -111
  190. oci/generative_ai_agent/generative_ai_agent_client_composite_operations.py +132 -0
  191. oci/generative_ai_agent/models/__init__.py +66 -0
  192. oci/generative_ai_agent/models/agent.py +29 -2
  193. oci/generative_ai_agent/models/agent_endpoint.py +143 -0
  194. oci/generative_ai_agent/models/agent_endpoint_summary.py +143 -0
  195. oci/generative_ai_agent/models/agent_summary.py +29 -2
  196. oci/generative_ai_agent/models/api_schema_inline_input_location.py +80 -0
  197. oci/generative_ai_agent/models/api_schema_input_location.py +113 -0
  198. oci/generative_ai_agent/models/api_schema_object_storage_input_location.py +142 -0
  199. oci/generative_ai_agent/models/content_moderation_guardrail_config.py +141 -0
  200. oci/generative_ai_agent/models/create_agent_details.py +29 -2
  201. oci/generative_ai_agent/models/create_agent_endpoint_details.py +143 -0
  202. oci/generative_ai_agent/models/create_data_source_details.py +31 -0
  203. oci/generative_ai_agent/models/create_tool_details.py +307 -0
  204. oci/generative_ai_agent/models/data_source.py +31 -0
  205. oci/generative_ai_agent/models/function.py +134 -0
  206. oci/generative_ai_agent/models/function_calling_tool_config.py +76 -0
  207. oci/generative_ai_agent/models/guardrail_config.py +120 -0
  208. oci/generative_ai_agent/models/http_endpoint_auth_config.py +137 -0
  209. oci/generative_ai_agent/models/http_endpoint_delegated_bearer_auth_config.py +50 -0
  210. oci/generative_ai_agent/models/http_endpoint_idcs_auth_config.py +76 -0
  211. oci/generative_ai_agent/models/http_endpoint_no_auth_config.py +49 -0
  212. oci/generative_ai_agent/models/http_endpoint_oci_resource_principal_auth_config.py +49 -0
  213. oci/generative_ai_agent/models/http_endpoint_tool_config.py +134 -0
  214. oci/generative_ai_agent/models/human_input_config.py +70 -0
  215. oci/generative_ai_agent/models/idcs_secret.py +2 -1
  216. oci/generative_ai_agent/models/inline_input_location.py +80 -0
  217. oci/generative_ai_agent/models/input_location.py +113 -0
  218. oci/generative_ai_agent/models/knowledge_base_config.py +74 -0
  219. oci/generative_ai_agent/models/llm_config.py +66 -0
  220. oci/generative_ai_agent/models/llm_customization.py +70 -0
  221. oci/generative_ai_agent/models/object_storage_input_location.py +142 -0
  222. oci/generative_ai_agent/models/object_storage_prefix.py +2 -2
  223. oci/generative_ai_agent/models/object_storage_prefix_output_location.py +142 -0
  224. oci/generative_ai_agent/models/output_config.py +97 -0
  225. oci/generative_ai_agent/models/output_location.py +99 -0
  226. oci/generative_ai_agent/models/personally_identifiable_information_guardrail_config.py +141 -0
  227. oci/generative_ai_agent/models/prompt_injection_guardrail_config.py +90 -0
  228. oci/generative_ai_agent/models/rag_tool_config.py +107 -0
  229. oci/generative_ai_agent/models/sql_tool_config.py +341 -0
  230. oci/generative_ai_agent/models/tool.py +522 -0
  231. oci/generative_ai_agent/models/tool_collection.py +70 -0
  232. oci/generative_ai_agent/models/tool_config.py +133 -0
  233. oci/generative_ai_agent/models/tool_summary.py +486 -0
  234. oci/generative_ai_agent/models/update_agent_details.py +29 -2
  235. oci/generative_ai_agent/models/update_agent_endpoint_details.py +143 -0
  236. oci/generative_ai_agent/models/update_data_source_details.py +31 -0
  237. oci/generative_ai_agent/models/update_tool_details.py +241 -0
  238. oci/generative_ai_agent/models/work_request.py +19 -3
  239. oci/generative_ai_agent/models/work_request_summary.py +19 -3
  240. oci/generative_ai_agent_runtime/generative_ai_agent_runtime_client.py +128 -6
  241. oci/generative_ai_agent_runtime/models/__init__.py +24 -0
  242. oci/generative_ai_agent_runtime/models/chat_details.py +65 -3
  243. oci/generative_ai_agent_runtime/models/chat_result.py +95 -2
  244. oci/generative_ai_agent_runtime/models/citation.py +34 -3
  245. oci/generative_ai_agent_runtime/models/function_call.py +101 -0
  246. oci/generative_ai_agent_runtime/models/function_calling_performed_action.py +87 -0
  247. oci/generative_ai_agent_runtime/models/function_calling_required_action.py +83 -0
  248. oci/generative_ai_agent_runtime/models/human_approval_performed_action.py +103 -0
  249. oci/generative_ai_agent_runtime/models/knowledge_base_metadata_summary.py +262 -0
  250. oci/generative_ai_agent_runtime/models/knowledge_base_metadata_value.py +101 -0
  251. oci/generative_ai_agent_runtime/models/message_content.py +33 -2
  252. oci/generative_ai_agent_runtime/models/metadata_filter.py +101 -0
  253. oci/generative_ai_agent_runtime/models/paragraph.py +132 -0
  254. oci/generative_ai_agent_runtime/models/paragraph_citation.py +97 -0
  255. oci/generative_ai_agent_runtime/models/performed_action.py +138 -0
  256. oci/generative_ai_agent_runtime/models/required_action.py +134 -0
  257. oci/generative_ai_agent_runtime/models/retrieve_metadata_details.py +70 -0
  258. oci/generative_ai_inference/generative_ai_inference_client.py +5 -5
  259. oci/generic_artifacts_content/generic_artifacts_content_client.py +3 -3
  260. oci/globally_distributed_database/sharded_database_service_client.py +30 -30
  261. oci/golden_gate/golden_gate_client.py +84 -84
  262. oci/governance_rules_control_plane/governance_rule_client.py +15 -15
  263. oci/governance_rules_control_plane/work_request_client.py +5 -5
  264. oci/healthchecks/health_checks_client.py +17 -17
  265. oci/identity/identity_client.py +145 -145
  266. oci/identity_data_plane/dataplane_client.py +2 -2
  267. oci/identity_domains/identity_domains_client.py +311 -311
  268. oci/integration/integration_instance_client.py +19 -19
  269. oci/jms/java_management_service_client.py +79 -79
  270. oci/jms_java_downloads/java_download_client.py +25 -25
  271. oci/key_management/ekm_client.py +5 -5
  272. oci/key_management/kms_crypto_client.py +6 -6
  273. oci/key_management/kms_hsm_cluster_client.py +12 -12
  274. oci/key_management/kms_management_client.py +21 -21
  275. oci/key_management/kms_vault_client.py +14 -14
  276. oci/license_manager/license_manager_client.py +18 -18
  277. oci/limits/limits_client.py +4 -4
  278. oci/limits/quotas_client.py +7 -7
  279. oci/load_balancer/load_balancer_client.py +61 -61
  280. oci/lockbox/lockbox_client.py +24 -24
  281. oci/log_analytics/log_analytics_client.py +193 -193
  282. oci/logging/logging_management_client.py +30 -30
  283. oci/loggingingestion/logging_client.py +1 -1
  284. oci/loggingsearch/log_search_client.py +1 -1
  285. oci/lustre_file_storage/__init__.py +14 -0
  286. oci/lustre_file_storage/lustre_file_storage_client.py +1536 -0
  287. oci/lustre_file_storage/lustre_file_storage_client_composite_operations.py +202 -0
  288. oci/lustre_file_storage/models/__init__.py +44 -0
  289. oci/lustre_file_storage/models/change_lustre_file_system_compartment_details.py +74 -0
  290. oci/lustre_file_storage/models/create_lustre_file_system_details.py +559 -0
  291. oci/lustre_file_storage/models/lustre_file_system.py +986 -0
  292. oci/lustre_file_storage/models/lustre_file_system_collection.py +70 -0
  293. oci/lustre_file_storage/models/lustre_file_system_summary.py +921 -0
  294. oci/lustre_file_storage/models/maintenance_window.py +141 -0
  295. oci/lustre_file_storage/models/root_squash_configuration.py +193 -0
  296. oci/lustre_file_storage/models/update_lustre_file_system_details.py +327 -0
  297. oci/lustre_file_storage/models/work_request.py +449 -0
  298. oci/lustre_file_storage/models/work_request_error.py +144 -0
  299. oci/lustre_file_storage/models/work_request_error_collection.py +70 -0
  300. oci/lustre_file_storage/models/work_request_log_entry.py +107 -0
  301. oci/lustre_file_storage/models/work_request_log_entry_collection.py +70 -0
  302. oci/lustre_file_storage/models/work_request_resource.py +205 -0
  303. oci/lustre_file_storage/models/work_request_summary.py +447 -0
  304. oci/lustre_file_storage/models/work_request_summary_collection.py +70 -0
  305. oci/management_agent/management_agent_client.py +28 -28
  306. oci/management_dashboard/dashx_apis_client.py +14 -14
  307. oci/marketplace/account_client.py +2 -2
  308. oci/marketplace/marketplace_client.py +30 -30
  309. oci/marketplace_private_offer/attachment_client.py +5 -5
  310. oci/marketplace_private_offer/offer_client.py +6 -6
  311. oci/marketplace_publisher/attachment_client.py +5 -5
  312. oci/marketplace_publisher/marketplace_publisher_client.py +71 -71
  313. oci/marketplace_publisher/offer_client.py +6 -6
  314. oci/media_services/media_services_client.py +60 -60
  315. oci/media_services/media_stream_client.py +2 -2
  316. oci/mngdmac/mac_device_client.py +6 -6
  317. oci/mngdmac/mac_order_client.py +22 -22
  318. oci/monitoring/monitoring_client.py +18 -18
  319. oci/mysql/channels_client.py +7 -7
  320. oci/mysql/db_backups_client.py +7 -7
  321. oci/mysql/db_system_client.py +17 -17
  322. oci/mysql/mysqlaas_client.py +7 -7
  323. oci/mysql/replicas_client.py +5 -5
  324. oci/mysql/work_requests_client.py +4 -4
  325. oci/network_firewall/network_firewall_client.py +86 -86
  326. oci/network_load_balancer/network_load_balancer_client.py +35 -35
  327. oci/nosql/nosql_client.py +24 -24
  328. oci/object_storage/object_storage_client.py +55 -55
  329. oci/oce/oce_instance_client.py +10 -10
  330. oci/oci_control_center/occ_metrics_client.py +3 -3
  331. oci/ocvp/cluster_client.py +5 -5
  332. oci/ocvp/esxi_host_client.py +8 -8
  333. oci/ocvp/sddc_client.py +14 -14
  334. oci/ocvp/work_request_client.py +4 -4
  335. oci/oda/management_client.py +59 -59
  336. oci/oda/oda_client.py +17 -17
  337. oci/oda/odapackage_client.py +7 -7
  338. oci/onesubscription/billing_schedule_client.py +1 -1
  339. oci/onesubscription/commitment_client.py +2 -2
  340. oci/onesubscription/computed_usage_client.py +3 -3
  341. oci/onesubscription/invoice_summary_client.py +2 -2
  342. oci/onesubscription/organization_subscription_client.py +1 -1
  343. oci/onesubscription/ratecard_client.py +1 -1
  344. oci/onesubscription/subscribed_service_client.py +2 -2
  345. oci/onesubscription/subscription_client.py +1 -1
  346. oci/ons/notification_control_plane_client.py +6 -6
  347. oci/ons/notification_data_plane_client.py +10 -10
  348. oci/opa/opa_instance_client.py +13 -13
  349. oci/opensearch/opensearch_cluster_backup_client.py +4 -4
  350. oci/opensearch/opensearch_cluster_client.py +16 -16
  351. oci/opensearch/opensearch_cluster_pipeline_client.py +5 -5
  352. oci/operator_access_control/access_requests_client.py +10 -10
  353. oci/operator_access_control/operator_actions_client.py +2 -2
  354. oci/operator_access_control/operator_control_assignment_client.py +8 -8
  355. oci/operator_access_control/operator_control_client.py +6 -6
  356. oci/opsi/models/create_operations_insights_warehouse_details.py +33 -2
  357. oci/opsi/models/operations_insights_warehouse.py +49 -2
  358. oci/opsi/models/operations_insights_warehouse_summary.py +33 -2
  359. oci/opsi/models/sql_plan_line.py +66 -0
  360. oci/opsi/models/update_operations_insights_warehouse_details.py +33 -2
  361. oci/opsi/operations_insights_client.py +181 -181
  362. oci/optimizer/optimizer_client.py +26 -26
  363. oci/os_management/event_client.py +8 -8
  364. oci/os_management/os_management_client.py +69 -69
  365. oci/os_management_hub/event_client.py +8 -8
  366. oci/os_management_hub/lifecycle_environment_client.py +13 -13
  367. oci/os_management_hub/managed_instance_client.py +33 -33
  368. oci/os_management_hub/managed_instance_group_client.py +26 -26
  369. oci/os_management_hub/management_station_client.py +10 -10
  370. oci/os_management_hub/onboarding_client.py +13 -13
  371. oci/os_management_hub/reporting_managed_instance_client.py +3 -3
  372. oci/os_management_hub/scheduled_job_client.py +7 -7
  373. oci/os_management_hub/software_source_client.py +33 -33
  374. oci/os_management_hub/work_request_client.py +5 -5
  375. oci/osp_gateway/address_rule_service_client.py +1 -1
  376. oci/osp_gateway/address_service_client.py +2 -2
  377. oci/osp_gateway/invoice_service_client.py +5 -5
  378. oci/osp_gateway/subscription_service_client.py +5 -5
  379. oci/osub_billing_schedule/billing_schedule_client.py +1 -1
  380. oci/osub_organization_subscription/organization_subscription_client.py +1 -1
  381. oci/osub_subscription/commitment_client.py +2 -2
  382. oci/osub_subscription/ratecard_client.py +1 -1
  383. oci/osub_subscription/subscription_client.py +1 -1
  384. oci/osub_usage/computed_usage_client.py +3 -3
  385. oci/psql/postgresql_client.py +34 -34
  386. oci/queue/queue_admin_client.py +11 -11
  387. oci/queue/queue_client.py +8 -8
  388. oci/recovery/database_recovery_client.py +26 -26
  389. oci/redis/redis_cluster_client.py +12 -12
  390. oci/resource_manager/resource_manager_client.py +52 -52
  391. oci/resource_scheduler/schedule_client.py +13 -13
  392. oci/resource_search/resource_search_client.py +3 -3
  393. oci/rover/rover_bundle_client.py +8 -8
  394. oci/rover/rover_cluster_client.py +8 -8
  395. oci/rover/rover_entitlement_client.py +6 -6
  396. oci/rover/rover_node_client.py +15 -15
  397. oci/rover/shape_client.py +1 -1
  398. oci/rover/work_requests_client.py +5 -5
  399. oci/sch/connector_plugins_client.py +2 -2
  400. oci/sch/models/functions_target_details.py +4 -0
  401. oci/sch/models/log_source.py +4 -6
  402. oci/sch/models/monitoring_target_details.py +0 -4
  403. oci/sch/models/notifications_target_details.py +0 -2
  404. oci/sch/models/plugin_source_details.py +4 -4
  405. oci/sch/models/service_connector.py +37 -0
  406. oci/sch/service_connector_client.py +12 -12
  407. oci/secrets/secrets_client.py +3 -3
  408. oci/security_attribute/security_attribute_client.py +18 -18
  409. oci/service_catalog/service_catalog_client.py +26 -26
  410. oci/service_manager_proxy/service_manager_proxy_client.py +2 -2
  411. oci/service_mesh/service_mesh_client.py +48 -48
  412. oci/stack_monitoring/models/__init__.py +44 -0
  413. oci/stack_monitoring/models/additional_configuration_details.py +70 -0
  414. oci/stack_monitoring/models/agent_extension_handler_configuration.py +277 -0
  415. oci/stack_monitoring/models/agent_extension_handler_configuration_property.py +101 -0
  416. oci/stack_monitoring/models/agent_extension_handler_metric_mapping_details.py +165 -0
  417. oci/stack_monitoring/models/agent_receiver_properties.py +70 -0
  418. oci/stack_monitoring/models/associated_monitored_resource.py +14 -6
  419. oci/stack_monitoring/models/associated_resources_summary.py +14 -6
  420. oci/stack_monitoring/models/auto_promote_config_details.py +1 -1
  421. oci/stack_monitoring/models/availability_metrics_details.py +101 -0
  422. oci/stack_monitoring/models/collectd_resource_name_configuration_details.py +132 -0
  423. oci/stack_monitoring/models/compute_auto_activate_plugin_config_details.py +146 -0
  424. oci/stack_monitoring/models/compute_auto_activate_plugin_config_summary.py +142 -0
  425. oci/stack_monitoring/models/config.py +19 -3
  426. oci/stack_monitoring/models/config_summary.py +8 -0
  427. oci/stack_monitoring/models/create_compute_auto_activate_plugin_config_details.py +107 -0
  428. oci/stack_monitoring/models/create_config_details.py +8 -0
  429. oci/stack_monitoring/models/create_maintenance_window_details.py +68 -2
  430. oci/stack_monitoring/models/create_monitored_resource_type_details.py +9 -5
  431. oci/stack_monitoring/models/create_onboard_config_details.py +259 -0
  432. oci/stack_monitoring/models/dynamic_group_details.py +148 -0
  433. oci/stack_monitoring/models/group_details.py +132 -0
  434. oci/stack_monitoring/models/import_oci_telemetry_resources_task_details.py +18 -6
  435. oci/stack_monitoring/models/license_auto_assign_config_details.py +1 -1
  436. oci/stack_monitoring/models/license_enterprise_extensibility_config_details.py +1 -1
  437. oci/stack_monitoring/models/maintenance_window.py +108 -5
  438. oci/stack_monitoring/models/maintenance_window_summary.py +7 -3
  439. oci/stack_monitoring/models/metric_name_configuration_details.py +101 -0
  440. oci/stack_monitoring/models/monitored_resource.py +14 -6
  441. oci/stack_monitoring/models/monitored_resource_member_summary.py +14 -6
  442. oci/stack_monitoring/models/monitored_resource_summary.py +14 -6
  443. oci/stack_monitoring/models/monitored_resource_task.py +31 -0
  444. oci/stack_monitoring/models/monitored_resource_task_details.py +19 -3
  445. oci/stack_monitoring/models/monitored_resource_task_summary.py +31 -0
  446. oci/stack_monitoring/models/monitored_resource_type.py +129 -5
  447. oci/stack_monitoring/models/monitored_resource_type_summary.py +94 -5
  448. oci/stack_monitoring/models/onboard_config_details.py +296 -0
  449. oci/stack_monitoring/models/onboard_config_summary.py +174 -0
  450. oci/stack_monitoring/models/resource_type_config_details.py +124 -0
  451. oci/stack_monitoring/models/search_monitored_resources_details.py +14 -6
  452. oci/stack_monitoring/models/telegraf_resource_name_configuration_details.py +132 -0
  453. oci/stack_monitoring/models/update_agent_receiver_task_details.py +190 -0
  454. oci/stack_monitoring/models/update_compute_auto_activate_plugin_config_details.py +100 -0
  455. oci/stack_monitoring/models/update_config_details.py +8 -0
  456. oci/stack_monitoring/models/update_maintenance_window_details.py +68 -2
  457. oci/stack_monitoring/models/update_monitored_resource_type_details.py +7 -3
  458. oci/stack_monitoring/models/update_onboard_config_details.py +252 -0
  459. oci/stack_monitoring/models/update_resource_type_config_task_details.py +133 -0
  460. oci/stack_monitoring/models/work_request.py +11 -3
  461. oci/stack_monitoring/models/work_request_summary.py +11 -3
  462. oci/stack_monitoring/stack_monitoring_client.py +121 -93
  463. oci/streaming/stream_admin_client.py +18 -18
  464. oci/streaming/stream_client.py +8 -8
  465. oci/tenant_manager_control_plane/domain_client.py +5 -5
  466. oci/tenant_manager_control_plane/domain_governance_client.py +5 -5
  467. oci/tenant_manager_control_plane/governance_client.py +2 -2
  468. oci/tenant_manager_control_plane/link_client.py +3 -3
  469. oci/tenant_manager_control_plane/orders_client.py +2 -2
  470. oci/tenant_manager_control_plane/organization_client.py +10 -10
  471. oci/tenant_manager_control_plane/recipient_invitation_client.py +5 -5
  472. oci/tenant_manager_control_plane/sender_invitation_client.py +5 -5
  473. oci/tenant_manager_control_plane/subscription_client.py +11 -11
  474. oci/tenant_manager_control_plane/work_request_client.py +4 -4
  475. oci/threat_intelligence/threatintel_client.py +5 -5
  476. oci/usage/resources_client.py +2 -2
  477. oci/usage/rewards_client.py +6 -6
  478. oci/usage/usagelimits_client.py +1 -1
  479. oci/usage_api/usageapi_client.py +33 -33
  480. oci/vault/vaults_client.py +13 -13
  481. oci/vbs_inst/vbs_instance_client.py +10 -10
  482. oci/version.py +1 -1
  483. oci/visual_builder/vb_instance_client.py +14 -14
  484. oci/vn_monitoring/vn_monitoring_client.py +12 -12
  485. oci/vulnerability_scanning/vulnerability_scanning_client.py +58 -58
  486. oci/waa/waa_client.py +13 -13
  487. oci/waa/work_request_client.py +4 -4
  488. oci/waas/redirect_client.py +6 -6
  489. oci/waas/waas_client.py +66 -66
  490. oci/waf/waf_client.py +24 -24
  491. oci/work_requests/work_request_client.py +4 -4
  492. oci/zpr/zpr_client.py +15 -15
  493. {oci-2.149.0.dist-info → oci-2.149.2.dist-info}/METADATA +1 -1
  494. {oci-2.149.0.dist-info → oci-2.149.2.dist-info}/RECORD +498 -336
  495. {oci-2.149.0.dist-info → oci-2.149.2.dist-info}/LICENSE.txt +0 -0
  496. {oci-2.149.0.dist-info → oci-2.149.2.dist-info}/THIRD_PARTY_LICENSES.txt +0 -0
  497. {oci-2.149.0.dist-info → oci-2.149.2.dist-info}/WHEEL +0 -0
  498. {oci-2.149.0.dist-info → oci-2.149.2.dist-info}/top_level.txt +0 -0
@@ -162,7 +162,7 @@ class GenerativeAiAgentClient(object):
162
162
  :rtype: :class:`~oci.response.Response`
163
163
 
164
164
  :example:
165
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/cancel_work_request.py.html>`__ to see an example of how to use cancel_work_request API.
165
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/cancel_work_request.py.html>`__ to see an example of how to use cancel_work_request API.
166
166
  """
167
167
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
168
168
  required_arguments = ['workRequestId']
@@ -284,7 +284,7 @@ class GenerativeAiAgentClient(object):
284
284
  :rtype: :class:`~oci.response.Response`
285
285
 
286
286
  :example:
287
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/change_agent_compartment.py.html>`__ to see an example of how to use change_agent_compartment API.
287
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/change_agent_compartment.py.html>`__ to see an example of how to use change_agent_compartment API.
288
288
  """
289
289
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
290
290
  required_arguments = ['agentId']
@@ -411,7 +411,7 @@ class GenerativeAiAgentClient(object):
411
411
  :rtype: :class:`~oci.response.Response`
412
412
 
413
413
  :example:
414
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/change_agent_endpoint_compartment.py.html>`__ to see an example of how to use change_agent_endpoint_compartment API.
414
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/change_agent_endpoint_compartment.py.html>`__ to see an example of how to use change_agent_endpoint_compartment API.
415
415
  """
416
416
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
417
417
  required_arguments = ['agentEndpointId']
@@ -538,7 +538,7 @@ class GenerativeAiAgentClient(object):
538
538
  :rtype: :class:`~oci.response.Response`
539
539
 
540
540
  :example:
541
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/change_knowledge_base_compartment.py.html>`__ to see an example of how to use change_knowledge_base_compartment API.
541
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/change_knowledge_base_compartment.py.html>`__ to see an example of how to use change_knowledge_base_compartment API.
542
542
  """
543
543
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
544
544
  required_arguments = ['knowledgeBaseId']
@@ -651,7 +651,7 @@ class GenerativeAiAgentClient(object):
651
651
  :rtype: :class:`~oci.response.Response`
652
652
 
653
653
  :example:
654
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/create_agent.py.html>`__ to see an example of how to use create_agent API.
654
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/create_agent.py.html>`__ to see an example of how to use create_agent API.
655
655
  """
656
656
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
657
657
  required_arguments = []
@@ -752,7 +752,7 @@ class GenerativeAiAgentClient(object):
752
752
  :rtype: :class:`~oci.response.Response`
753
753
 
754
754
  :example:
755
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/create_agent_endpoint.py.html>`__ to see an example of how to use create_agent_endpoint API.
755
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/create_agent_endpoint.py.html>`__ to see an example of how to use create_agent_endpoint API.
756
756
  """
757
757
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
758
758
  required_arguments = []
@@ -853,7 +853,7 @@ class GenerativeAiAgentClient(object):
853
853
  :rtype: :class:`~oci.response.Response`
854
854
 
855
855
  :example:
856
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/create_data_ingestion_job.py.html>`__ to see an example of how to use create_data_ingestion_job API.
856
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/create_data_ingestion_job.py.html>`__ to see an example of how to use create_data_ingestion_job API.
857
857
  """
858
858
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
859
859
  required_arguments = []
@@ -954,7 +954,7 @@ class GenerativeAiAgentClient(object):
954
954
  :rtype: :class:`~oci.response.Response`
955
955
 
956
956
  :example:
957
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/create_data_source.py.html>`__ to see an example of how to use create_data_source API.
957
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/create_data_source.py.html>`__ to see an example of how to use create_data_source API.
958
958
  """
959
959
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
960
960
  required_arguments = []
@@ -1055,7 +1055,7 @@ class GenerativeAiAgentClient(object):
1055
1055
  :rtype: :class:`~oci.response.Response`
1056
1056
 
1057
1057
  :example:
1058
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/create_knowledge_base.py.html>`__ to see an example of how to use create_knowledge_base API.
1058
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/create_knowledge_base.py.html>`__ to see an example of how to use create_knowledge_base API.
1059
1059
  """
1060
1060
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1061
1061
  required_arguments = []
@@ -1119,6 +1119,107 @@ class GenerativeAiAgentClient(object):
1119
1119
  api_reference_link=api_reference_link,
1120
1120
  required_arguments=required_arguments)
1121
1121
 
1122
+ def create_tool(self, create_tool_details, **kwargs):
1123
+ """
1124
+ Creates a tool.
1125
+
1126
+
1127
+ :param oci.generative_ai_agent.models.CreateToolDetails create_tool_details: (required)
1128
+ Details for the new tool.
1129
+
1130
+ :param str opc_retry_token: (optional)
1131
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
1132
+ server error without risk of running that same action again. Retry tokens expire after 24
1133
+ hours, but can be invalidated before then due to conflicting operations. For example, if a resource
1134
+ has been deleted and removed from the system, then a retry of the original creation request
1135
+ might be rejected.
1136
+
1137
+ :param str opc_request_id: (optional)
1138
+ Unique Oracle-assigned identifier for the request. If you need to contact
1139
+ Oracle about a particular request, please provide the request ID.
1140
+ The only valid characters for request IDs are letters, numbers,
1141
+ underscore, and dash.
1142
+
1143
+ :param obj retry_strategy: (optional)
1144
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1145
+
1146
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
1147
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1148
+
1149
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1150
+
1151
+ :param bool allow_control_chars: (optional)
1152
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1153
+ By default, the response will not allow control characters in strings
1154
+
1155
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.Tool`
1156
+ :rtype: :class:`~oci.response.Response`
1157
+
1158
+ :example:
1159
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/create_tool.py.html>`__ to see an example of how to use create_tool API.
1160
+ """
1161
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1162
+ required_arguments = []
1163
+ resource_path = "/tools"
1164
+ method = "POST"
1165
+ operation_name = "create_tool"
1166
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/Tool/CreateTool"
1167
+
1168
+ # Don't accept unknown kwargs
1169
+ expected_kwargs = [
1170
+ "allow_control_chars",
1171
+ "retry_strategy",
1172
+ "opc_retry_token",
1173
+ "opc_request_id"
1174
+ ]
1175
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1176
+ if extra_kwargs:
1177
+ raise ValueError(
1178
+ f"create_tool got unknown kwargs: {extra_kwargs!r}")
1179
+
1180
+ header_params = {
1181
+ "accept": "application/json",
1182
+ "content-type": "application/json",
1183
+ "opc-retry-token": kwargs.get("opc_retry_token", missing),
1184
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1185
+ }
1186
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1187
+
1188
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1189
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1190
+ client_retry_strategy=self.retry_strategy
1191
+ )
1192
+ if retry_strategy is None:
1193
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
1194
+
1195
+ if retry_strategy:
1196
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1197
+ self.base_client.add_opc_retry_token_if_needed(header_params)
1198
+ self.base_client.add_opc_client_retries_header(header_params)
1199
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1200
+ return retry_strategy.make_retrying_call(
1201
+ self.base_client.call_api,
1202
+ resource_path=resource_path,
1203
+ method=method,
1204
+ header_params=header_params,
1205
+ body=create_tool_details,
1206
+ response_type="Tool",
1207
+ allow_control_chars=kwargs.get('allow_control_chars'),
1208
+ operation_name=operation_name,
1209
+ api_reference_link=api_reference_link,
1210
+ required_arguments=required_arguments)
1211
+ else:
1212
+ return self.base_client.call_api(
1213
+ resource_path=resource_path,
1214
+ method=method,
1215
+ header_params=header_params,
1216
+ body=create_tool_details,
1217
+ response_type="Tool",
1218
+ allow_control_chars=kwargs.get('allow_control_chars'),
1219
+ operation_name=operation_name,
1220
+ api_reference_link=api_reference_link,
1221
+ required_arguments=required_arguments)
1222
+
1122
1223
  def delete_agent(self, agent_id, **kwargs):
1123
1224
  """
1124
1225
  Deletes an agent.
@@ -1157,7 +1258,7 @@ class GenerativeAiAgentClient(object):
1157
1258
  :rtype: :class:`~oci.response.Response`
1158
1259
 
1159
1260
  :example:
1160
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/delete_agent.py.html>`__ to see an example of how to use delete_agent API.
1261
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/delete_agent.py.html>`__ to see an example of how to use delete_agent API.
1161
1262
  """
1162
1263
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1163
1264
  required_arguments = ['agentId']
@@ -1266,7 +1367,7 @@ class GenerativeAiAgentClient(object):
1266
1367
  :rtype: :class:`~oci.response.Response`
1267
1368
 
1268
1369
  :example:
1269
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/delete_agent_endpoint.py.html>`__ to see an example of how to use delete_agent_endpoint API.
1370
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/delete_agent_endpoint.py.html>`__ to see an example of how to use delete_agent_endpoint API.
1270
1371
  """
1271
1372
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1272
1373
  required_arguments = ['agentEndpointId']
@@ -1375,7 +1476,7 @@ class GenerativeAiAgentClient(object):
1375
1476
  :rtype: :class:`~oci.response.Response`
1376
1477
 
1377
1478
  :example:
1378
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/delete_data_ingestion_job.py.html>`__ to see an example of how to use delete_data_ingestion_job API.
1479
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/delete_data_ingestion_job.py.html>`__ to see an example of how to use delete_data_ingestion_job API.
1379
1480
  """
1380
1481
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1381
1482
  required_arguments = ['dataIngestionJobId']
@@ -1484,7 +1585,7 @@ class GenerativeAiAgentClient(object):
1484
1585
  :rtype: :class:`~oci.response.Response`
1485
1586
 
1486
1587
  :example:
1487
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/delete_data_source.py.html>`__ to see an example of how to use delete_data_source API.
1588
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/delete_data_source.py.html>`__ to see an example of how to use delete_data_source API.
1488
1589
  """
1489
1590
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1490
1591
  required_arguments = ['dataSourceId']
@@ -1593,7 +1694,7 @@ class GenerativeAiAgentClient(object):
1593
1694
  :rtype: :class:`~oci.response.Response`
1594
1695
 
1595
1696
  :example:
1596
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/delete_knowledge_base.py.html>`__ to see an example of how to use delete_knowledge_base API.
1697
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/delete_knowledge_base.py.html>`__ to see an example of how to use delete_knowledge_base API.
1597
1698
  """
1598
1699
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1599
1700
  required_arguments = ['knowledgeBaseId']
@@ -1664,6 +1765,115 @@ class GenerativeAiAgentClient(object):
1664
1765
  api_reference_link=api_reference_link,
1665
1766
  required_arguments=required_arguments)
1666
1767
 
1768
+ def delete_tool(self, tool_id, **kwargs):
1769
+ """
1770
+ Deletes a tool.
1771
+
1772
+
1773
+ :param str tool_id: (required)
1774
+ The `OCID`__ of the Tool.
1775
+
1776
+ __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
1777
+
1778
+ :param str if_match: (optional)
1779
+ For optimistic concurrency control. In the PUT or DELETE call for a resource, set the
1780
+ `if-match` parameter to the value of the etag from a previous GET or POST response for
1781
+ that resource. The resource will be updated or deleted only if the etag you provide
1782
+ matches the resource's current etag value.
1783
+
1784
+ :param str opc_request_id: (optional)
1785
+ Unique Oracle-assigned identifier for the request. If you need to contact
1786
+ Oracle about a particular request, please provide the request ID.
1787
+ The only valid characters for request IDs are letters, numbers,
1788
+ underscore, and dash.
1789
+
1790
+ :param obj retry_strategy: (optional)
1791
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1792
+
1793
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
1794
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1795
+
1796
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1797
+
1798
+ :param bool allow_control_chars: (optional)
1799
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1800
+ By default, the response will not allow control characters in strings
1801
+
1802
+ :return: A :class:`~oci.response.Response` object with data of type None
1803
+ :rtype: :class:`~oci.response.Response`
1804
+
1805
+ :example:
1806
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/delete_tool.py.html>`__ to see an example of how to use delete_tool API.
1807
+ """
1808
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1809
+ required_arguments = ['toolId']
1810
+ resource_path = "/tools/{toolId}"
1811
+ method = "DELETE"
1812
+ operation_name = "delete_tool"
1813
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/Tool/DeleteTool"
1814
+
1815
+ # Don't accept unknown kwargs
1816
+ expected_kwargs = [
1817
+ "allow_control_chars",
1818
+ "retry_strategy",
1819
+ "if_match",
1820
+ "opc_request_id"
1821
+ ]
1822
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1823
+ if extra_kwargs:
1824
+ raise ValueError(
1825
+ f"delete_tool got unknown kwargs: {extra_kwargs!r}")
1826
+
1827
+ path_params = {
1828
+ "toolId": tool_id
1829
+ }
1830
+
1831
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
1832
+
1833
+ for (k, v) in six.iteritems(path_params):
1834
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
1835
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
1836
+
1837
+ header_params = {
1838
+ "accept": "application/json",
1839
+ "content-type": "application/json",
1840
+ "if-match": kwargs.get("if_match", missing),
1841
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1842
+ }
1843
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1844
+
1845
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1846
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1847
+ client_retry_strategy=self.retry_strategy
1848
+ )
1849
+ if retry_strategy is None:
1850
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
1851
+
1852
+ if retry_strategy:
1853
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1854
+ self.base_client.add_opc_client_retries_header(header_params)
1855
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1856
+ return retry_strategy.make_retrying_call(
1857
+ self.base_client.call_api,
1858
+ resource_path=resource_path,
1859
+ method=method,
1860
+ path_params=path_params,
1861
+ header_params=header_params,
1862
+ allow_control_chars=kwargs.get('allow_control_chars'),
1863
+ operation_name=operation_name,
1864
+ api_reference_link=api_reference_link,
1865
+ required_arguments=required_arguments)
1866
+ else:
1867
+ return self.base_client.call_api(
1868
+ resource_path=resource_path,
1869
+ method=method,
1870
+ path_params=path_params,
1871
+ header_params=header_params,
1872
+ allow_control_chars=kwargs.get('allow_control_chars'),
1873
+ operation_name=operation_name,
1874
+ api_reference_link=api_reference_link,
1875
+ required_arguments=required_arguments)
1876
+
1667
1877
  def get_agent(self, agent_id, **kwargs):
1668
1878
  """
1669
1879
  Gets information about an agent.
@@ -1696,7 +1906,7 @@ class GenerativeAiAgentClient(object):
1696
1906
  :rtype: :class:`~oci.response.Response`
1697
1907
 
1698
1908
  :example:
1699
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/get_agent.py.html>`__ to see an example of how to use get_agent API.
1909
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/get_agent.py.html>`__ to see an example of how to use get_agent API.
1700
1910
  """
1701
1911
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1702
1912
  required_arguments = ['agentId']
@@ -1799,7 +2009,7 @@ class GenerativeAiAgentClient(object):
1799
2009
  :rtype: :class:`~oci.response.Response`
1800
2010
 
1801
2011
  :example:
1802
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/get_agent_endpoint.py.html>`__ to see an example of how to use get_agent_endpoint API.
2012
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/get_agent_endpoint.py.html>`__ to see an example of how to use get_agent_endpoint API.
1803
2013
  """
1804
2014
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1805
2015
  required_arguments = ['agentEndpointId']
@@ -1902,7 +2112,7 @@ class GenerativeAiAgentClient(object):
1902
2112
  :rtype: :class:`~oci.response.Response`
1903
2113
 
1904
2114
  :example:
1905
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/get_data_ingestion_job.py.html>`__ to see an example of how to use get_data_ingestion_job API.
2115
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/get_data_ingestion_job.py.html>`__ to see an example of how to use get_data_ingestion_job API.
1906
2116
  """
1907
2117
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1908
2118
  required_arguments = ['dataIngestionJobId']
@@ -2005,7 +2215,7 @@ class GenerativeAiAgentClient(object):
2005
2215
  :rtype: :class:`~oci.response.Response`
2006
2216
 
2007
2217
  :example:
2008
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/get_data_ingestion_job_log_content.py.html>`__ to see an example of how to use get_data_ingestion_job_log_content API.
2218
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/get_data_ingestion_job_log_content.py.html>`__ to see an example of how to use get_data_ingestion_job_log_content API.
2009
2219
  """
2010
2220
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2011
2221
  required_arguments = ['dataIngestionJobId']
@@ -2108,7 +2318,7 @@ class GenerativeAiAgentClient(object):
2108
2318
  :rtype: :class:`~oci.response.Response`
2109
2319
 
2110
2320
  :example:
2111
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/get_data_source.py.html>`__ to see an example of how to use get_data_source API.
2321
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/get_data_source.py.html>`__ to see an example of how to use get_data_source API.
2112
2322
  """
2113
2323
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2114
2324
  required_arguments = ['dataSourceId']
@@ -2211,7 +2421,7 @@ class GenerativeAiAgentClient(object):
2211
2421
  :rtype: :class:`~oci.response.Response`
2212
2422
 
2213
2423
  :example:
2214
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/get_knowledge_base.py.html>`__ to see an example of how to use get_knowledge_base API.
2424
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/get_knowledge_base.py.html>`__ to see an example of how to use get_knowledge_base API.
2215
2425
  """
2216
2426
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2217
2427
  required_arguments = ['knowledgeBaseId']
@@ -2282,6 +2492,109 @@ class GenerativeAiAgentClient(object):
2282
2492
  api_reference_link=api_reference_link,
2283
2493
  required_arguments=required_arguments)
2284
2494
 
2495
+ def get_tool(self, tool_id, **kwargs):
2496
+ """
2497
+ Gets information about a tool.
2498
+
2499
+
2500
+ :param str tool_id: (required)
2501
+ The `OCID`__ of the Tool.
2502
+
2503
+ __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
2504
+
2505
+ :param str opc_request_id: (optional)
2506
+ Unique Oracle-assigned identifier for the request. If you need to contact
2507
+ Oracle about a particular request, please provide the request ID.
2508
+ The only valid characters for request IDs are letters, numbers,
2509
+ underscore, and dash.
2510
+
2511
+ :param obj retry_strategy: (optional)
2512
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
2513
+
2514
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
2515
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
2516
+
2517
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
2518
+
2519
+ :param bool allow_control_chars: (optional)
2520
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2521
+ By default, the response will not allow control characters in strings
2522
+
2523
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.Tool`
2524
+ :rtype: :class:`~oci.response.Response`
2525
+
2526
+ :example:
2527
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/get_tool.py.html>`__ to see an example of how to use get_tool API.
2528
+ """
2529
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2530
+ required_arguments = ['toolId']
2531
+ resource_path = "/tools/{toolId}"
2532
+ method = "GET"
2533
+ operation_name = "get_tool"
2534
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/Tool/GetTool"
2535
+
2536
+ # Don't accept unknown kwargs
2537
+ expected_kwargs = [
2538
+ "allow_control_chars",
2539
+ "retry_strategy",
2540
+ "opc_request_id"
2541
+ ]
2542
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2543
+ if extra_kwargs:
2544
+ raise ValueError(
2545
+ f"get_tool got unknown kwargs: {extra_kwargs!r}")
2546
+
2547
+ path_params = {
2548
+ "toolId": tool_id
2549
+ }
2550
+
2551
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
2552
+
2553
+ for (k, v) in six.iteritems(path_params):
2554
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
2555
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
2556
+
2557
+ header_params = {
2558
+ "accept": "application/json",
2559
+ "content-type": "application/json",
2560
+ "opc-request-id": kwargs.get("opc_request_id", missing)
2561
+ }
2562
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
2563
+
2564
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
2565
+ operation_retry_strategy=kwargs.get('retry_strategy'),
2566
+ client_retry_strategy=self.retry_strategy
2567
+ )
2568
+ if retry_strategy is None:
2569
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
2570
+
2571
+ if retry_strategy:
2572
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
2573
+ self.base_client.add_opc_client_retries_header(header_params)
2574
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
2575
+ return retry_strategy.make_retrying_call(
2576
+ self.base_client.call_api,
2577
+ resource_path=resource_path,
2578
+ method=method,
2579
+ path_params=path_params,
2580
+ header_params=header_params,
2581
+ response_type="Tool",
2582
+ allow_control_chars=kwargs.get('allow_control_chars'),
2583
+ operation_name=operation_name,
2584
+ api_reference_link=api_reference_link,
2585
+ required_arguments=required_arguments)
2586
+ else:
2587
+ return self.base_client.call_api(
2588
+ resource_path=resource_path,
2589
+ method=method,
2590
+ path_params=path_params,
2591
+ header_params=header_params,
2592
+ response_type="Tool",
2593
+ allow_control_chars=kwargs.get('allow_control_chars'),
2594
+ operation_name=operation_name,
2595
+ api_reference_link=api_reference_link,
2596
+ required_arguments=required_arguments)
2597
+
2285
2598
  def get_work_request(self, work_request_id, **kwargs):
2286
2599
  """
2287
2600
  Gets the details of a work request.
@@ -2314,7 +2627,7 @@ class GenerativeAiAgentClient(object):
2314
2627
  :rtype: :class:`~oci.response.Response`
2315
2628
 
2316
2629
  :example:
2317
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/get_work_request.py.html>`__ to see an example of how to use get_work_request API.
2630
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/get_work_request.py.html>`__ to see an example of how to use get_work_request API.
2318
2631
  """
2319
2632
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2320
2633
  required_arguments = ['workRequestId']
@@ -2340,9 +2653,182 @@ class GenerativeAiAgentClient(object):
2340
2653
 
2341
2654
  path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
2342
2655
 
2343
- for (k, v) in six.iteritems(path_params):
2344
- if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
2345
- raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
2656
+ for (k, v) in six.iteritems(path_params):
2657
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
2658
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
2659
+
2660
+ header_params = {
2661
+ "accept": "application/json",
2662
+ "content-type": "application/json",
2663
+ "opc-request-id": kwargs.get("opc_request_id", missing)
2664
+ }
2665
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
2666
+
2667
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
2668
+ operation_retry_strategy=kwargs.get('retry_strategy'),
2669
+ client_retry_strategy=self.retry_strategy
2670
+ )
2671
+ if retry_strategy is None:
2672
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
2673
+
2674
+ if retry_strategy:
2675
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
2676
+ self.base_client.add_opc_client_retries_header(header_params)
2677
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
2678
+ return retry_strategy.make_retrying_call(
2679
+ self.base_client.call_api,
2680
+ resource_path=resource_path,
2681
+ method=method,
2682
+ path_params=path_params,
2683
+ header_params=header_params,
2684
+ response_type="WorkRequest",
2685
+ allow_control_chars=kwargs.get('allow_control_chars'),
2686
+ operation_name=operation_name,
2687
+ api_reference_link=api_reference_link,
2688
+ required_arguments=required_arguments)
2689
+ else:
2690
+ return self.base_client.call_api(
2691
+ resource_path=resource_path,
2692
+ method=method,
2693
+ path_params=path_params,
2694
+ header_params=header_params,
2695
+ response_type="WorkRequest",
2696
+ allow_control_chars=kwargs.get('allow_control_chars'),
2697
+ operation_name=operation_name,
2698
+ api_reference_link=api_reference_link,
2699
+ required_arguments=required_arguments)
2700
+
2701
+ def list_agent_endpoints(self, **kwargs):
2702
+ """
2703
+ Gets a list of endpoints.
2704
+
2705
+
2706
+ :param str compartment_id: (optional)
2707
+ The `OCID`__ of the compartment in which to list resources.
2708
+
2709
+ __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
2710
+
2711
+ :param str agent_id: (optional)
2712
+ The `OCID`__ of the agent.
2713
+
2714
+ __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
2715
+
2716
+ :param str lifecycle_state: (optional)
2717
+ A filter to return only resources that match the given lifecycle state. The
2718
+ state value is case-insensitive.
2719
+
2720
+ Allowed values are: "CREATING", "UPDATING", "ACTIVE", "DELETING", "DELETED", "FAILED"
2721
+
2722
+ :param str display_name: (optional)
2723
+ A filter to return only resources that match the given display name exactly.
2724
+
2725
+ :param int limit: (optional)
2726
+ For list pagination. The maximum number of results per page, or items to return in a
2727
+ paginated \"List\" call. For important details about how pagination works, see
2728
+ `List Pagination`__.
2729
+
2730
+ __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine
2731
+
2732
+ :param str page: (optional)
2733
+ For list pagination. The value of the opc-next-page response header from the previous
2734
+ \"List\" call. For important details about how pagination works, see
2735
+ `List Pagination`__.
2736
+
2737
+ __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine
2738
+
2739
+ :param str sort_order: (optional)
2740
+ The sort order to use, either ascending (`ASC`) or descending (`DESC`).
2741
+
2742
+ Allowed values are: "ASC", "DESC"
2743
+
2744
+ :param str sort_by: (optional)
2745
+ The field to sort by. You can provide only one sort order. Default order for `timeCreated`
2746
+ is descending. Default order for `displayName` is ascending.
2747
+
2748
+ Allowed values are: "timeCreated", "displayName"
2749
+
2750
+ :param str opc_request_id: (optional)
2751
+ Unique Oracle-assigned identifier for the request. If you need to contact
2752
+ Oracle about a particular request, please provide the request ID.
2753
+ The only valid characters for request IDs are letters, numbers,
2754
+ underscore, and dash.
2755
+
2756
+ :param obj retry_strategy: (optional)
2757
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
2758
+
2759
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
2760
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
2761
+
2762
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
2763
+
2764
+ :param bool allow_control_chars: (optional)
2765
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2766
+ By default, the response will not allow control characters in strings
2767
+
2768
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.AgentEndpointCollection`
2769
+ :rtype: :class:`~oci.response.Response`
2770
+
2771
+ :example:
2772
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/list_agent_endpoints.py.html>`__ to see an example of how to use list_agent_endpoints API.
2773
+ """
2774
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2775
+ required_arguments = []
2776
+ resource_path = "/agentEndpoints"
2777
+ method = "GET"
2778
+ operation_name = "list_agent_endpoints"
2779
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/AgentEndpoint/ListAgentEndpoints"
2780
+
2781
+ # Don't accept unknown kwargs
2782
+ expected_kwargs = [
2783
+ "allow_control_chars",
2784
+ "retry_strategy",
2785
+ "compartment_id",
2786
+ "agent_id",
2787
+ "lifecycle_state",
2788
+ "display_name",
2789
+ "limit",
2790
+ "page",
2791
+ "sort_order",
2792
+ "sort_by",
2793
+ "opc_request_id"
2794
+ ]
2795
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2796
+ if extra_kwargs:
2797
+ raise ValueError(
2798
+ f"list_agent_endpoints got unknown kwargs: {extra_kwargs!r}")
2799
+
2800
+ if 'lifecycle_state' in kwargs:
2801
+ lifecycle_state_allowed_values = ["CREATING", "UPDATING", "ACTIVE", "DELETING", "DELETED", "FAILED"]
2802
+ if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values:
2803
+ raise ValueError(
2804
+ f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }"
2805
+ )
2806
+
2807
+ if 'sort_order' in kwargs:
2808
+ sort_order_allowed_values = ["ASC", "DESC"]
2809
+ if kwargs['sort_order'] not in sort_order_allowed_values:
2810
+ raise ValueError(
2811
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
2812
+ )
2813
+
2814
+ if 'sort_by' in kwargs:
2815
+ sort_by_allowed_values = ["timeCreated", "displayName"]
2816
+ if kwargs['sort_by'] not in sort_by_allowed_values:
2817
+ raise ValueError(
2818
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
2819
+ )
2820
+
2821
+ query_params = {
2822
+ "compartmentId": kwargs.get("compartment_id", missing),
2823
+ "agentId": kwargs.get("agent_id", missing),
2824
+ "lifecycleState": kwargs.get("lifecycle_state", missing),
2825
+ "displayName": kwargs.get("display_name", missing),
2826
+ "limit": kwargs.get("limit", missing),
2827
+ "page": kwargs.get("page", missing),
2828
+ "sortOrder": kwargs.get("sort_order", missing),
2829
+ "sortBy": kwargs.get("sort_by", missing)
2830
+ }
2831
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
2346
2832
 
2347
2833
  header_params = {
2348
2834
  "accept": "application/json",
@@ -2366,9 +2852,9 @@ class GenerativeAiAgentClient(object):
2366
2852
  self.base_client.call_api,
2367
2853
  resource_path=resource_path,
2368
2854
  method=method,
2369
- path_params=path_params,
2855
+ query_params=query_params,
2370
2856
  header_params=header_params,
2371
- response_type="WorkRequest",
2857
+ response_type="AgentEndpointCollection",
2372
2858
  allow_control_chars=kwargs.get('allow_control_chars'),
2373
2859
  operation_name=operation_name,
2374
2860
  api_reference_link=api_reference_link,
@@ -2377,17 +2863,17 @@ class GenerativeAiAgentClient(object):
2377
2863
  return self.base_client.call_api(
2378
2864
  resource_path=resource_path,
2379
2865
  method=method,
2380
- path_params=path_params,
2866
+ query_params=query_params,
2381
2867
  header_params=header_params,
2382
- response_type="WorkRequest",
2868
+ response_type="AgentEndpointCollection",
2383
2869
  allow_control_chars=kwargs.get('allow_control_chars'),
2384
2870
  operation_name=operation_name,
2385
2871
  api_reference_link=api_reference_link,
2386
2872
  required_arguments=required_arguments)
2387
2873
 
2388
- def list_agent_endpoints(self, **kwargs):
2874
+ def list_agents(self, **kwargs):
2389
2875
  """
2390
- Gets a list of endpoints.
2876
+ Gets a list of agents.
2391
2877
 
2392
2878
 
2393
2879
  :param str compartment_id: (optional)
@@ -2395,11 +2881,6 @@ class GenerativeAiAgentClient(object):
2395
2881
 
2396
2882
  __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
2397
2883
 
2398
- :param str agent_id: (optional)
2399
- The `OCID`__ of the agent.
2400
-
2401
- __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
2402
-
2403
2884
  :param str lifecycle_state: (optional)
2404
2885
  A filter to return only resources that match the given lifecycle state. The
2405
2886
  state value is case-insensitive.
@@ -2452,25 +2933,24 @@ class GenerativeAiAgentClient(object):
2452
2933
  allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2453
2934
  By default, the response will not allow control characters in strings
2454
2935
 
2455
- :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.AgentEndpointCollection`
2936
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.AgentCollection`
2456
2937
  :rtype: :class:`~oci.response.Response`
2457
2938
 
2458
2939
  :example:
2459
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/list_agent_endpoints.py.html>`__ to see an example of how to use list_agent_endpoints API.
2940
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/list_agents.py.html>`__ to see an example of how to use list_agents API.
2460
2941
  """
2461
2942
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2462
2943
  required_arguments = []
2463
- resource_path = "/agentEndpoints"
2944
+ resource_path = "/agents"
2464
2945
  method = "GET"
2465
- operation_name = "list_agent_endpoints"
2466
- api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/AgentEndpoint/ListAgentEndpoints"
2946
+ operation_name = "list_agents"
2947
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/Agent/ListAgents"
2467
2948
 
2468
2949
  # Don't accept unknown kwargs
2469
2950
  expected_kwargs = [
2470
2951
  "allow_control_chars",
2471
2952
  "retry_strategy",
2472
2953
  "compartment_id",
2473
- "agent_id",
2474
2954
  "lifecycle_state",
2475
2955
  "display_name",
2476
2956
  "limit",
@@ -2482,7 +2962,7 @@ class GenerativeAiAgentClient(object):
2482
2962
  extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2483
2963
  if extra_kwargs:
2484
2964
  raise ValueError(
2485
- f"list_agent_endpoints got unknown kwargs: {extra_kwargs!r}")
2965
+ f"list_agents got unknown kwargs: {extra_kwargs!r}")
2486
2966
 
2487
2967
  if 'lifecycle_state' in kwargs:
2488
2968
  lifecycle_state_allowed_values = ["CREATING", "UPDATING", "ACTIVE", "DELETING", "DELETED", "FAILED"]
@@ -2507,7 +2987,6 @@ class GenerativeAiAgentClient(object):
2507
2987
 
2508
2988
  query_params = {
2509
2989
  "compartmentId": kwargs.get("compartment_id", missing),
2510
- "agentId": kwargs.get("agent_id", missing),
2511
2990
  "lifecycleState": kwargs.get("lifecycle_state", missing),
2512
2991
  "displayName": kwargs.get("display_name", missing),
2513
2992
  "limit": kwargs.get("limit", missing),
@@ -2541,7 +3020,7 @@ class GenerativeAiAgentClient(object):
2541
3020
  method=method,
2542
3021
  query_params=query_params,
2543
3022
  header_params=header_params,
2544
- response_type="AgentEndpointCollection",
3023
+ response_type="AgentCollection",
2545
3024
  allow_control_chars=kwargs.get('allow_control_chars'),
2546
3025
  operation_name=operation_name,
2547
3026
  api_reference_link=api_reference_link,
@@ -2552,15 +3031,15 @@ class GenerativeAiAgentClient(object):
2552
3031
  method=method,
2553
3032
  query_params=query_params,
2554
3033
  header_params=header_params,
2555
- response_type="AgentEndpointCollection",
3034
+ response_type="AgentCollection",
2556
3035
  allow_control_chars=kwargs.get('allow_control_chars'),
2557
3036
  operation_name=operation_name,
2558
3037
  api_reference_link=api_reference_link,
2559
3038
  required_arguments=required_arguments)
2560
3039
 
2561
- def list_agents(self, **kwargs):
3040
+ def list_data_ingestion_jobs(self, **kwargs):
2562
3041
  """
2563
- Gets a list of agents.
3042
+ Gets a list of data ingestion jobs.
2564
3043
 
2565
3044
 
2566
3045
  :param str compartment_id: (optional)
@@ -2568,11 +3047,16 @@ class GenerativeAiAgentClient(object):
2568
3047
 
2569
3048
  __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
2570
3049
 
3050
+ :param str data_source_id: (optional)
3051
+ The `OCID`__ of the data source.
3052
+
3053
+ __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
3054
+
2571
3055
  :param str lifecycle_state: (optional)
2572
3056
  A filter to return only resources that match the given lifecycle state. The
2573
3057
  state value is case-insensitive.
2574
3058
 
2575
- Allowed values are: "CREATING", "UPDATING", "ACTIVE", "DELETING", "DELETED", "FAILED"
3059
+ Allowed values are: "ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "DELETING", "DELETED"
2576
3060
 
2577
3061
  :param str display_name: (optional)
2578
3062
  A filter to return only resources that match the given display name exactly.
@@ -2620,24 +3104,25 @@ class GenerativeAiAgentClient(object):
2620
3104
  allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2621
3105
  By default, the response will not allow control characters in strings
2622
3106
 
2623
- :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.AgentCollection`
3107
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.DataIngestionJobCollection`
2624
3108
  :rtype: :class:`~oci.response.Response`
2625
3109
 
2626
3110
  :example:
2627
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/list_agents.py.html>`__ to see an example of how to use list_agents API.
3111
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/list_data_ingestion_jobs.py.html>`__ to see an example of how to use list_data_ingestion_jobs API.
2628
3112
  """
2629
3113
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2630
3114
  required_arguments = []
2631
- resource_path = "/agents"
3115
+ resource_path = "/dataIngestionJobs"
2632
3116
  method = "GET"
2633
- operation_name = "list_agents"
2634
- api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/Agent/ListAgents"
3117
+ operation_name = "list_data_ingestion_jobs"
3118
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/DataIngestionJob/ListDataIngestionJobs"
2635
3119
 
2636
3120
  # Don't accept unknown kwargs
2637
3121
  expected_kwargs = [
2638
3122
  "allow_control_chars",
2639
3123
  "retry_strategy",
2640
3124
  "compartment_id",
3125
+ "data_source_id",
2641
3126
  "lifecycle_state",
2642
3127
  "display_name",
2643
3128
  "limit",
@@ -2649,10 +3134,10 @@ class GenerativeAiAgentClient(object):
2649
3134
  extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2650
3135
  if extra_kwargs:
2651
3136
  raise ValueError(
2652
- f"list_agents got unknown kwargs: {extra_kwargs!r}")
3137
+ f"list_data_ingestion_jobs got unknown kwargs: {extra_kwargs!r}")
2653
3138
 
2654
3139
  if 'lifecycle_state' in kwargs:
2655
- lifecycle_state_allowed_values = ["CREATING", "UPDATING", "ACTIVE", "DELETING", "DELETED", "FAILED"]
3140
+ lifecycle_state_allowed_values = ["ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "DELETING", "DELETED"]
2656
3141
  if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values:
2657
3142
  raise ValueError(
2658
3143
  f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }"
@@ -2674,6 +3159,7 @@ class GenerativeAiAgentClient(object):
2674
3159
 
2675
3160
  query_params = {
2676
3161
  "compartmentId": kwargs.get("compartment_id", missing),
3162
+ "dataSourceId": kwargs.get("data_source_id", missing),
2677
3163
  "lifecycleState": kwargs.get("lifecycle_state", missing),
2678
3164
  "displayName": kwargs.get("display_name", missing),
2679
3165
  "limit": kwargs.get("limit", missing),
@@ -2707,7 +3193,7 @@ class GenerativeAiAgentClient(object):
2707
3193
  method=method,
2708
3194
  query_params=query_params,
2709
3195
  header_params=header_params,
2710
- response_type="AgentCollection",
3196
+ response_type="DataIngestionJobCollection",
2711
3197
  allow_control_chars=kwargs.get('allow_control_chars'),
2712
3198
  operation_name=operation_name,
2713
3199
  api_reference_link=api_reference_link,
@@ -2718,15 +3204,15 @@ class GenerativeAiAgentClient(object):
2718
3204
  method=method,
2719
3205
  query_params=query_params,
2720
3206
  header_params=header_params,
2721
- response_type="AgentCollection",
3207
+ response_type="DataIngestionJobCollection",
2722
3208
  allow_control_chars=kwargs.get('allow_control_chars'),
2723
3209
  operation_name=operation_name,
2724
3210
  api_reference_link=api_reference_link,
2725
3211
  required_arguments=required_arguments)
2726
3212
 
2727
- def list_data_ingestion_jobs(self, **kwargs):
3213
+ def list_data_sources(self, **kwargs):
2728
3214
  """
2729
- Gets a list of data ingestion jobs.
3215
+ Gets a list of data sources.
2730
3216
 
2731
3217
 
2732
3218
  :param str compartment_id: (optional)
@@ -2734,8 +3220,8 @@ class GenerativeAiAgentClient(object):
2734
3220
 
2735
3221
  __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
2736
3222
 
2737
- :param str data_source_id: (optional)
2738
- The `OCID`__ of the data source.
3223
+ :param str knowledge_base_id: (optional)
3224
+ The `OCID`__ of the knowledge base.
2739
3225
 
2740
3226
  __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
2741
3227
 
@@ -2743,7 +3229,7 @@ class GenerativeAiAgentClient(object):
2743
3229
  A filter to return only resources that match the given lifecycle state. The
2744
3230
  state value is case-insensitive.
2745
3231
 
2746
- Allowed values are: "ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "DELETING", "DELETED"
3232
+ Allowed values are: "CREATING", "ACTIVE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED"
2747
3233
 
2748
3234
  :param str display_name: (optional)
2749
3235
  A filter to return only resources that match the given display name exactly.
@@ -2791,25 +3277,25 @@ class GenerativeAiAgentClient(object):
2791
3277
  allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2792
3278
  By default, the response will not allow control characters in strings
2793
3279
 
2794
- :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.DataIngestionJobCollection`
3280
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.DataSourceCollection`
2795
3281
  :rtype: :class:`~oci.response.Response`
2796
3282
 
2797
3283
  :example:
2798
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/list_data_ingestion_jobs.py.html>`__ to see an example of how to use list_data_ingestion_jobs API.
3284
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/list_data_sources.py.html>`__ to see an example of how to use list_data_sources API.
2799
3285
  """
2800
3286
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2801
3287
  required_arguments = []
2802
- resource_path = "/dataIngestionJobs"
3288
+ resource_path = "/dataSources"
2803
3289
  method = "GET"
2804
- operation_name = "list_data_ingestion_jobs"
2805
- api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/DataIngestionJob/ListDataIngestionJobs"
3290
+ operation_name = "list_data_sources"
3291
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/DataSource/ListDataSources"
2806
3292
 
2807
3293
  # Don't accept unknown kwargs
2808
3294
  expected_kwargs = [
2809
3295
  "allow_control_chars",
2810
3296
  "retry_strategy",
2811
3297
  "compartment_id",
2812
- "data_source_id",
3298
+ "knowledge_base_id",
2813
3299
  "lifecycle_state",
2814
3300
  "display_name",
2815
3301
  "limit",
@@ -2821,10 +3307,10 @@ class GenerativeAiAgentClient(object):
2821
3307
  extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2822
3308
  if extra_kwargs:
2823
3309
  raise ValueError(
2824
- f"list_data_ingestion_jobs got unknown kwargs: {extra_kwargs!r}")
3310
+ f"list_data_sources got unknown kwargs: {extra_kwargs!r}")
2825
3311
 
2826
3312
  if 'lifecycle_state' in kwargs:
2827
- lifecycle_state_allowed_values = ["ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "DELETING", "DELETED"]
3313
+ lifecycle_state_allowed_values = ["CREATING", "ACTIVE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED"]
2828
3314
  if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values:
2829
3315
  raise ValueError(
2830
3316
  f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }"
@@ -2846,7 +3332,7 @@ class GenerativeAiAgentClient(object):
2846
3332
 
2847
3333
  query_params = {
2848
3334
  "compartmentId": kwargs.get("compartment_id", missing),
2849
- "dataSourceId": kwargs.get("data_source_id", missing),
3335
+ "knowledgeBaseId": kwargs.get("knowledge_base_id", missing),
2850
3336
  "lifecycleState": kwargs.get("lifecycle_state", missing),
2851
3337
  "displayName": kwargs.get("display_name", missing),
2852
3338
  "limit": kwargs.get("limit", missing),
@@ -2880,7 +3366,7 @@ class GenerativeAiAgentClient(object):
2880
3366
  method=method,
2881
3367
  query_params=query_params,
2882
3368
  header_params=header_params,
2883
- response_type="DataIngestionJobCollection",
3369
+ response_type="DataSourceCollection",
2884
3370
  allow_control_chars=kwargs.get('allow_control_chars'),
2885
3371
  operation_name=operation_name,
2886
3372
  api_reference_link=api_reference_link,
@@ -2891,15 +3377,15 @@ class GenerativeAiAgentClient(object):
2891
3377
  method=method,
2892
3378
  query_params=query_params,
2893
3379
  header_params=header_params,
2894
- response_type="DataIngestionJobCollection",
3380
+ response_type="DataSourceCollection",
2895
3381
  allow_control_chars=kwargs.get('allow_control_chars'),
2896
3382
  operation_name=operation_name,
2897
3383
  api_reference_link=api_reference_link,
2898
3384
  required_arguments=required_arguments)
2899
3385
 
2900
- def list_data_sources(self, **kwargs):
3386
+ def list_knowledge_bases(self, **kwargs):
2901
3387
  """
2902
- Gets a list of data sources.
3388
+ Gets a list of knowledge bases.
2903
3389
 
2904
3390
 
2905
3391
  :param str compartment_id: (optional)
@@ -2907,16 +3393,11 @@ class GenerativeAiAgentClient(object):
2907
3393
 
2908
3394
  __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
2909
3395
 
2910
- :param str knowledge_base_id: (optional)
2911
- The `OCID`__ of the knowledge base.
2912
-
2913
- __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
2914
-
2915
3396
  :param str lifecycle_state: (optional)
2916
3397
  A filter to return only resources that match the given lifecycle state. The
2917
3398
  state value is case-insensitive.
2918
3399
 
2919
- Allowed values are: "CREATING", "ACTIVE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED"
3400
+ Allowed values are: "CREATING", "UPDATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", "FAILED"
2920
3401
 
2921
3402
  :param str display_name: (optional)
2922
3403
  A filter to return only resources that match the given display name exactly.
@@ -2964,25 +3445,24 @@ class GenerativeAiAgentClient(object):
2964
3445
  allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2965
3446
  By default, the response will not allow control characters in strings
2966
3447
 
2967
- :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.DataSourceCollection`
3448
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.KnowledgeBaseCollection`
2968
3449
  :rtype: :class:`~oci.response.Response`
2969
3450
 
2970
3451
  :example:
2971
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/list_data_sources.py.html>`__ to see an example of how to use list_data_sources API.
3452
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/list_knowledge_bases.py.html>`__ to see an example of how to use list_knowledge_bases API.
2972
3453
  """
2973
3454
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2974
3455
  required_arguments = []
2975
- resource_path = "/dataSources"
3456
+ resource_path = "/knowledgeBases"
2976
3457
  method = "GET"
2977
- operation_name = "list_data_sources"
2978
- api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/DataSource/ListDataSources"
3458
+ operation_name = "list_knowledge_bases"
3459
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/KnowledgeBase/ListKnowledgeBases"
2979
3460
 
2980
3461
  # Don't accept unknown kwargs
2981
3462
  expected_kwargs = [
2982
3463
  "allow_control_chars",
2983
3464
  "retry_strategy",
2984
3465
  "compartment_id",
2985
- "knowledge_base_id",
2986
3466
  "lifecycle_state",
2987
3467
  "display_name",
2988
3468
  "limit",
@@ -2994,10 +3474,10 @@ class GenerativeAiAgentClient(object):
2994
3474
  extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2995
3475
  if extra_kwargs:
2996
3476
  raise ValueError(
2997
- f"list_data_sources got unknown kwargs: {extra_kwargs!r}")
3477
+ f"list_knowledge_bases got unknown kwargs: {extra_kwargs!r}")
2998
3478
 
2999
3479
  if 'lifecycle_state' in kwargs:
3000
- lifecycle_state_allowed_values = ["CREATING", "ACTIVE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED"]
3480
+ lifecycle_state_allowed_values = ["CREATING", "UPDATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", "FAILED"]
3001
3481
  if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values:
3002
3482
  raise ValueError(
3003
3483
  f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }"
@@ -3019,7 +3499,6 @@ class GenerativeAiAgentClient(object):
3019
3499
 
3020
3500
  query_params = {
3021
3501
  "compartmentId": kwargs.get("compartment_id", missing),
3022
- "knowledgeBaseId": kwargs.get("knowledge_base_id", missing),
3023
3502
  "lifecycleState": kwargs.get("lifecycle_state", missing),
3024
3503
  "displayName": kwargs.get("display_name", missing),
3025
3504
  "limit": kwargs.get("limit", missing),
@@ -3053,7 +3532,7 @@ class GenerativeAiAgentClient(object):
3053
3532
  method=method,
3054
3533
  query_params=query_params,
3055
3534
  header_params=header_params,
3056
- response_type="DataSourceCollection",
3535
+ response_type="KnowledgeBaseCollection",
3057
3536
  allow_control_chars=kwargs.get('allow_control_chars'),
3058
3537
  operation_name=operation_name,
3059
3538
  api_reference_link=api_reference_link,
@@ -3064,15 +3543,15 @@ class GenerativeAiAgentClient(object):
3064
3543
  method=method,
3065
3544
  query_params=query_params,
3066
3545
  header_params=header_params,
3067
- response_type="DataSourceCollection",
3546
+ response_type="KnowledgeBaseCollection",
3068
3547
  allow_control_chars=kwargs.get('allow_control_chars'),
3069
3548
  operation_name=operation_name,
3070
3549
  api_reference_link=api_reference_link,
3071
3550
  required_arguments=required_arguments)
3072
3551
 
3073
- def list_knowledge_bases(self, **kwargs):
3552
+ def list_tools(self, **kwargs):
3074
3553
  """
3075
- Gets a list of knowledge bases.
3554
+ Gets a list of tools.
3076
3555
 
3077
3556
 
3078
3557
  :param str compartment_id: (optional)
@@ -3084,11 +3563,16 @@ class GenerativeAiAgentClient(object):
3084
3563
  A filter to return only resources that match the given lifecycle state. The
3085
3564
  state value is case-insensitive.
3086
3565
 
3087
- Allowed values are: "CREATING", "UPDATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", "FAILED"
3566
+ Allowed values are: "CREATING", "UPDATING", "ACTIVE", "DELETING", "DELETED", "FAILED"
3088
3567
 
3089
3568
  :param str display_name: (optional)
3090
3569
  A filter to return only resources that match the given display name exactly.
3091
3570
 
3571
+ :param str agent_id: (optional)
3572
+ The `OCID`__ of the agent.
3573
+
3574
+ __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
3575
+
3092
3576
  :param int limit: (optional)
3093
3577
  For list pagination. The maximum number of results per page, or items to return in a
3094
3578
  paginated \"List\" call. For important details about how pagination works, see
@@ -3132,18 +3616,18 @@ class GenerativeAiAgentClient(object):
3132
3616
  allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
3133
3617
  By default, the response will not allow control characters in strings
3134
3618
 
3135
- :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.KnowledgeBaseCollection`
3619
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.generative_ai_agent.models.ToolCollection`
3136
3620
  :rtype: :class:`~oci.response.Response`
3137
3621
 
3138
3622
  :example:
3139
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/list_knowledge_bases.py.html>`__ to see an example of how to use list_knowledge_bases API.
3623
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/list_tools.py.html>`__ to see an example of how to use list_tools API.
3140
3624
  """
3141
3625
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3142
3626
  required_arguments = []
3143
- resource_path = "/knowledgeBases"
3627
+ resource_path = "/tools"
3144
3628
  method = "GET"
3145
- operation_name = "list_knowledge_bases"
3146
- api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/KnowledgeBase/ListKnowledgeBases"
3629
+ operation_name = "list_tools"
3630
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/Tool/ListTools"
3147
3631
 
3148
3632
  # Don't accept unknown kwargs
3149
3633
  expected_kwargs = [
@@ -3152,6 +3636,7 @@ class GenerativeAiAgentClient(object):
3152
3636
  "compartment_id",
3153
3637
  "lifecycle_state",
3154
3638
  "display_name",
3639
+ "agent_id",
3155
3640
  "limit",
3156
3641
  "page",
3157
3642
  "sort_order",
@@ -3161,10 +3646,10 @@ class GenerativeAiAgentClient(object):
3161
3646
  extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
3162
3647
  if extra_kwargs:
3163
3648
  raise ValueError(
3164
- f"list_knowledge_bases got unknown kwargs: {extra_kwargs!r}")
3649
+ f"list_tools got unknown kwargs: {extra_kwargs!r}")
3165
3650
 
3166
3651
  if 'lifecycle_state' in kwargs:
3167
- lifecycle_state_allowed_values = ["CREATING", "UPDATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", "FAILED"]
3652
+ lifecycle_state_allowed_values = ["CREATING", "UPDATING", "ACTIVE", "DELETING", "DELETED", "FAILED"]
3168
3653
  if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values:
3169
3654
  raise ValueError(
3170
3655
  f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }"
@@ -3188,6 +3673,7 @@ class GenerativeAiAgentClient(object):
3188
3673
  "compartmentId": kwargs.get("compartment_id", missing),
3189
3674
  "lifecycleState": kwargs.get("lifecycle_state", missing),
3190
3675
  "displayName": kwargs.get("display_name", missing),
3676
+ "agentId": kwargs.get("agent_id", missing),
3191
3677
  "limit": kwargs.get("limit", missing),
3192
3678
  "page": kwargs.get("page", missing),
3193
3679
  "sortOrder": kwargs.get("sort_order", missing),
@@ -3219,7 +3705,7 @@ class GenerativeAiAgentClient(object):
3219
3705
  method=method,
3220
3706
  query_params=query_params,
3221
3707
  header_params=header_params,
3222
- response_type="KnowledgeBaseCollection",
3708
+ response_type="ToolCollection",
3223
3709
  allow_control_chars=kwargs.get('allow_control_chars'),
3224
3710
  operation_name=operation_name,
3225
3711
  api_reference_link=api_reference_link,
@@ -3230,7 +3716,7 @@ class GenerativeAiAgentClient(object):
3230
3716
  method=method,
3231
3717
  query_params=query_params,
3232
3718
  header_params=header_params,
3233
- response_type="KnowledgeBaseCollection",
3719
+ response_type="ToolCollection",
3234
3720
  allow_control_chars=kwargs.get('allow_control_chars'),
3235
3721
  operation_name=operation_name,
3236
3722
  api_reference_link=api_reference_link,
@@ -3292,7 +3778,7 @@ class GenerativeAiAgentClient(object):
3292
3778
  :rtype: :class:`~oci.response.Response`
3293
3779
 
3294
3780
  :example:
3295
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/list_work_request_errors.py.html>`__ to see an example of how to use list_work_request_errors API.
3781
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/list_work_request_errors.py.html>`__ to see an example of how to use list_work_request_errors API.
3296
3782
  """
3297
3783
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3298
3784
  required_arguments = ['workRequestId']
@@ -3447,7 +3933,7 @@ class GenerativeAiAgentClient(object):
3447
3933
  :rtype: :class:`~oci.response.Response`
3448
3934
 
3449
3935
  :example:
3450
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/list_work_request_logs.py.html>`__ to see an example of how to use list_work_request_logs API.
3936
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/list_work_request_logs.py.html>`__ to see an example of how to use list_work_request_logs API.
3451
3937
  """
3452
3938
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3453
3939
  required_arguments = ['workRequestId']
@@ -3617,7 +4103,7 @@ class GenerativeAiAgentClient(object):
3617
4103
  :rtype: :class:`~oci.response.Response`
3618
4104
 
3619
4105
  :example:
3620
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/list_work_requests.py.html>`__ to see an example of how to use list_work_requests API.
4106
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/list_work_requests.py.html>`__ to see an example of how to use list_work_requests API.
3621
4107
  """
3622
4108
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3623
4109
  required_arguments = []
@@ -3760,7 +4246,7 @@ class GenerativeAiAgentClient(object):
3760
4246
  :rtype: :class:`~oci.response.Response`
3761
4247
 
3762
4248
  :example:
3763
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/update_agent.py.html>`__ to see an example of how to use update_agent API.
4249
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/update_agent.py.html>`__ to see an example of how to use update_agent API.
3764
4250
  """
3765
4251
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3766
4252
  required_arguments = ['agentId']
@@ -3874,7 +4360,7 @@ class GenerativeAiAgentClient(object):
3874
4360
  :rtype: :class:`~oci.response.Response`
3875
4361
 
3876
4362
  :example:
3877
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/update_agent_endpoint.py.html>`__ to see an example of how to use update_agent_endpoint API.
4363
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/update_agent_endpoint.py.html>`__ to see an example of how to use update_agent_endpoint API.
3878
4364
  """
3879
4365
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3880
4366
  required_arguments = ['agentEndpointId']
@@ -3988,7 +4474,7 @@ class GenerativeAiAgentClient(object):
3988
4474
  :rtype: :class:`~oci.response.Response`
3989
4475
 
3990
4476
  :example:
3991
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/update_data_source.py.html>`__ to see an example of how to use update_data_source API.
4477
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/update_data_source.py.html>`__ to see an example of how to use update_data_source API.
3992
4478
  """
3993
4479
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3994
4480
  required_arguments = ['dataSourceId']
@@ -4102,7 +4588,7 @@ class GenerativeAiAgentClient(object):
4102
4588
  :rtype: :class:`~oci.response.Response`
4103
4589
 
4104
4590
  :example:
4105
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.0/generativeaiagent/update_knowledge_base.py.html>`__ to see an example of how to use update_knowledge_base API.
4591
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/update_knowledge_base.py.html>`__ to see an example of how to use update_knowledge_base API.
4106
4592
  """
4107
4593
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
4108
4594
  required_arguments = ['knowledgeBaseId']
@@ -4174,3 +4660,117 @@ class GenerativeAiAgentClient(object):
4174
4660
  operation_name=operation_name,
4175
4661
  api_reference_link=api_reference_link,
4176
4662
  required_arguments=required_arguments)
4663
+
4664
+ def update_tool(self, tool_id, update_tool_details, **kwargs):
4665
+ """
4666
+ Updates a tool.
4667
+
4668
+
4669
+ :param str tool_id: (required)
4670
+ The `OCID`__ of the Tool.
4671
+
4672
+ __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
4673
+
4674
+ :param oci.generative_ai_agent.models.UpdateToolDetails update_tool_details: (required)
4675
+ The information to be updated.
4676
+
4677
+ :param str if_match: (optional)
4678
+ For optimistic concurrency control. In the PUT or DELETE call for a resource, set the
4679
+ `if-match` parameter to the value of the etag from a previous GET or POST response for
4680
+ that resource. The resource will be updated or deleted only if the etag you provide
4681
+ matches the resource's current etag value.
4682
+
4683
+ :param str opc_request_id: (optional)
4684
+ Unique Oracle-assigned identifier for the request. If you need to contact
4685
+ Oracle about a particular request, please provide the request ID.
4686
+ The only valid characters for request IDs are letters, numbers,
4687
+ underscore, and dash.
4688
+
4689
+ :param obj retry_strategy: (optional)
4690
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
4691
+
4692
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
4693
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
4694
+
4695
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
4696
+
4697
+ :param bool allow_control_chars: (optional)
4698
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
4699
+ By default, the response will not allow control characters in strings
4700
+
4701
+ :return: A :class:`~oci.response.Response` object with data of type None
4702
+ :rtype: :class:`~oci.response.Response`
4703
+
4704
+ :example:
4705
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.149.2/generativeaiagent/update_tool.py.html>`__ to see an example of how to use update_tool API.
4706
+ """
4707
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
4708
+ required_arguments = ['toolId']
4709
+ resource_path = "/tools/{toolId}"
4710
+ method = "PUT"
4711
+ operation_name = "update_tool"
4712
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/generative-ai-agents/20240531/Tool/UpdateTool"
4713
+
4714
+ # Don't accept unknown kwargs
4715
+ expected_kwargs = [
4716
+ "allow_control_chars",
4717
+ "retry_strategy",
4718
+ "if_match",
4719
+ "opc_request_id"
4720
+ ]
4721
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
4722
+ if extra_kwargs:
4723
+ raise ValueError(
4724
+ f"update_tool got unknown kwargs: {extra_kwargs!r}")
4725
+
4726
+ path_params = {
4727
+ "toolId": tool_id
4728
+ }
4729
+
4730
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
4731
+
4732
+ for (k, v) in six.iteritems(path_params):
4733
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
4734
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
4735
+
4736
+ header_params = {
4737
+ "accept": "application/json",
4738
+ "content-type": "application/json",
4739
+ "if-match": kwargs.get("if_match", missing),
4740
+ "opc-request-id": kwargs.get("opc_request_id", missing)
4741
+ }
4742
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
4743
+
4744
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
4745
+ operation_retry_strategy=kwargs.get('retry_strategy'),
4746
+ client_retry_strategy=self.retry_strategy
4747
+ )
4748
+ if retry_strategy is None:
4749
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
4750
+
4751
+ if retry_strategy:
4752
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
4753
+ self.base_client.add_opc_client_retries_header(header_params)
4754
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
4755
+ return retry_strategy.make_retrying_call(
4756
+ self.base_client.call_api,
4757
+ resource_path=resource_path,
4758
+ method=method,
4759
+ path_params=path_params,
4760
+ header_params=header_params,
4761
+ body=update_tool_details,
4762
+ allow_control_chars=kwargs.get('allow_control_chars'),
4763
+ operation_name=operation_name,
4764
+ api_reference_link=api_reference_link,
4765
+ required_arguments=required_arguments)
4766
+ else:
4767
+ return self.base_client.call_api(
4768
+ resource_path=resource_path,
4769
+ method=method,
4770
+ path_params=path_params,
4771
+ header_params=header_params,
4772
+ body=update_tool_details,
4773
+ allow_control_chars=kwargs.get('allow_control_chars'),
4774
+ operation_name=operation_name,
4775
+ api_reference_link=api_reference_link,
4776
+ required_arguments=required_arguments)