oci 2.117.0__py3-none-any.whl → 2.118.0__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 (560) hide show
  1. oci/access_governance_cp/access_governance_cp_client.py +8 -8
  2. oci/adm/application_dependency_management_client.py +36 -36
  3. oci/ai_anomaly_detection/anomaly_detection_client.py +36 -36
  4. oci/ai_document/ai_service_document_client.py +22 -22
  5. oci/ai_language/ai_service_language_client.py +36 -36
  6. oci/ai_speech/ai_service_speech_client.py +9 -9
  7. oci/ai_vision/ai_service_vision_client.py +25 -25
  8. oci/analytics/analytics_client.py +23 -23
  9. oci/announcements_service/announcement_client.py +4 -4
  10. oci/announcements_service/announcement_subscription_client.py +9 -9
  11. oci/announcements_service/announcements_preferences_client.py +4 -4
  12. oci/apigateway/api_gateway_client.py +21 -21
  13. oci/apigateway/deployment_client.py +6 -6
  14. oci/apigateway/gateway_client.py +6 -6
  15. oci/apigateway/subscribers_client.py +6 -6
  16. oci/apigateway/usage_plans_client.py +6 -6
  17. oci/apigateway/work_requests_client.py +5 -5
  18. oci/apm_config/config_client.py +8 -8
  19. oci/apm_control_plane/apm_domain_client.py +14 -14
  20. oci/apm_synthetics/apm_synthetic_client.py +18 -18
  21. oci/apm_traces/query_client.py +2 -2
  22. oci/apm_traces/trace_client.py +4 -4
  23. oci/application_migration/application_migration_client.py +19 -19
  24. oci/appmgmt_control/appmgmt_control_client.py +8 -8
  25. oci/artifacts/artifacts_client.py +32 -32
  26. oci/audit/audit_client.py +3 -3
  27. oci/autoscaling/auto_scaling_client.py +11 -11
  28. oci/bastion/bastion_client.py +15 -15
  29. oci/bds/bds_client.py +51 -51
  30. oci/blockchain/blockchain_platform_client.py +27 -27
  31. oci/budget/budget_client.py +10 -10
  32. oci/certificates/certificates_client.py +5 -5
  33. oci/certificates_management/certificates_management_client.py +32 -32
  34. oci/cims/incident_client.py +8 -8
  35. oci/cims/user_client.py +1 -1
  36. oci/cloud_bridge/common_client.py +5 -5
  37. oci/cloud_bridge/discovery_client.py +14 -14
  38. oci/cloud_bridge/inventory_client.py +16 -16
  39. oci/cloud_bridge/ocb_agent_svc_client.py +23 -23
  40. oci/cloud_guard/cloud_guard_client.py +133 -133
  41. oci/cloud_migrations/migration_client.py +43 -43
  42. oci/compute_cloud_at_customer/compute_cloud_at_customer_client.py +12 -12
  43. oci/compute_instance_agent/compute_instance_agent_client.py +6 -6
  44. oci/compute_instance_agent/plugin_client.py +2 -2
  45. oci/compute_instance_agent/pluginconfig_client.py +1 -1
  46. oci/container_engine/container_engine_client.py +44 -44
  47. oci/container_instances/container_instance_client.py +18 -18
  48. oci/core/blockstorage_client.py +60 -60
  49. oci/core/compute_client.py +99 -99
  50. oci/core/compute_management_client.py +32 -32
  51. oci/core/models/update_instance_details.py +39 -2
  52. oci/core/virtual_network_client.py +242 -242
  53. oci/dashboard_service/dashboard_client.py +6 -6
  54. oci/dashboard_service/dashboard_group_client.py +6 -6
  55. oci/data_catalog/data_catalog_client.py +1027 -252
  56. oci/data_catalog/data_catalog_client_composite_operations.py +276 -0
  57. oci/data_catalog/models/__init__.py +6 -0
  58. oci/data_catalog/models/add_resource_lock_details.py +183 -0
  59. oci/data_catalog/models/catalog.py +76 -2
  60. oci/data_catalog/models/catalog_private_endpoint.py +76 -2
  61. oci/data_catalog/models/catalog_private_endpoint_summary.py +76 -2
  62. oci/data_catalog/models/catalog_summary.py +76 -2
  63. oci/data_catalog/models/metastore.py +76 -2
  64. oci/data_catalog/models/metastore_summary.py +76 -2
  65. oci/data_catalog/models/remove_resource_lock_details.py +183 -0
  66. oci/data_catalog/models/resource_lock.py +185 -0
  67. oci/data_flow/data_flow_client.py +42 -42
  68. oci/data_integration/data_integration_client.py +163 -163
  69. oci/data_integration/models/__init__.py +8 -0
  70. oci/data_integration/models/create_task_details.py +31 -0
  71. oci/data_integration/models/create_task_from_data_loader_task.py +7 -0
  72. oci/data_integration/models/create_task_from_integration_task.py +7 -0
  73. oci/data_integration/models/create_task_from_oci_dataflow_task.py +63 -2
  74. oci/data_integration/models/create_task_from_pipeline_task.py +7 -0
  75. oci/data_integration/models/create_task_from_rest_task.py +7 -0
  76. oci/data_integration/models/create_task_from_sql_task.py +7 -0
  77. oci/data_integration/models/incremental_data_entity_clause.py +170 -0
  78. oci/data_integration/models/incremental_field_clause.py +170 -0
  79. oci/data_integration/models/incremental_read_config.py +103 -0
  80. oci/data_integration/models/json_format_attribute.py +33 -2
  81. oci/data_integration/models/read_operation_config.py +27 -0
  82. oci/data_integration/models/runtime_operator.py +2 -2
  83. oci/data_integration/models/runtime_operator_summary.py +2 -2
  84. oci/data_integration/models/shape_details.py +68 -0
  85. oci/data_integration/models/task.py +31 -0
  86. oci/data_integration/models/task_from_data_loader_task_details.py +7 -0
  87. oci/data_integration/models/task_from_integration_task_details.py +7 -0
  88. oci/data_integration/models/task_from_oci_dataflow_task_details.py +63 -2
  89. oci/data_integration/models/task_from_pipeline_task_details.py +7 -0
  90. oci/data_integration/models/task_from_rest_task_details.py +7 -0
  91. oci/data_integration/models/task_from_sql_task_details.py +7 -0
  92. oci/data_integration/models/task_summary.py +31 -0
  93. oci/data_integration/models/task_summary_from_data_loader_task.py +7 -0
  94. oci/data_integration/models/task_summary_from_integration_task.py +7 -0
  95. oci/data_integration/models/task_summary_from_oci_dataflow_task.py +63 -2
  96. oci/data_integration/models/task_summary_from_pipeline_task.py +7 -0
  97. oci/data_integration/models/task_summary_from_rest_task.py +7 -0
  98. oci/data_integration/models/task_summary_from_sql_task.py +7 -0
  99. oci/data_integration/models/update_task_details.py +31 -0
  100. oci/data_integration/models/update_task_from_data_loader_task.py +7 -0
  101. oci/data_integration/models/update_task_from_integration_task.py +7 -0
  102. oci/data_integration/models/update_task_from_oci_dataflow_task.py +63 -2
  103. oci/data_integration/models/update_task_from_pipeline_task.py +7 -0
  104. oci/data_integration/models/update_task_from_rest_task.py +7 -0
  105. oci/data_integration/models/update_task_from_sql_task.py +7 -0
  106. oci/data_labeling_service/data_labeling_management_client.py +17 -17
  107. oci/data_labeling_service_dataplane/data_labeling_client.py +15 -15
  108. oci/data_safe/data_safe_client.py +307 -290
  109. oci/data_safe/data_safe_client_composite_operations.py +5 -5
  110. oci/data_safe/models/__init__.py +2 -0
  111. oci/data_safe/models/audit_event_aggregation_dimensions.py +6 -6
  112. oci/data_safe/models/audit_event_summary.py +14 -14
  113. oci/data_safe/models/audit_policy_dimensions.py +2 -2
  114. oci/data_safe/models/change_report_compartment_details.py +1 -1
  115. oci/data_safe/models/change_sql_firewall_policy_compartment_details.py +2 -2
  116. oci/data_safe/models/database_security_config.py +1 -1
  117. oci/data_safe/models/database_security_config_summary.py +1 -1
  118. oci/data_safe/models/delete_rows_format_entry.py +1 -1
  119. oci/data_safe/models/deterministic_encryption_date_format_entry.py +1 -1
  120. oci/data_safe/models/deterministic_encryption_format_entry.py +1 -1
  121. oci/data_safe/models/deterministic_substitution_format_entry.py +1 -1
  122. oci/data_safe/models/dimensions.py +33 -2
  123. oci/data_safe/models/discovery_analytics_summary.py +7 -3
  124. oci/data_safe/models/entry_details.py +2 -2
  125. oci/data_safe/models/finding_summary.py +2 -2
  126. oci/data_safe/models/firewall_policy_entry_details.py +5 -5
  127. oci/data_safe/models/fixed_number_format_entry.py +1 -1
  128. oci/data_safe/models/fixed_string_format_entry.py +1 -1
  129. oci/data_safe/models/format_entry.py +11 -3
  130. oci/data_safe/models/generate_report_details.py +2 -2
  131. oci/data_safe/models/library_masking_format_entry.py +1 -1
  132. oci/data_safe/models/mask_data_details.py +4 -2
  133. oci/data_safe/models/null_value_format_entry.py +1 -1
  134. oci/data_safe/models/patch_alerts_details.py +1 -1
  135. oci/data_safe/models/pattern_format_entry.py +104 -0
  136. oci/data_safe/models/ppf_format_entry.py +1 -1
  137. oci/data_safe/models/preserve_original_data_format_entry.py +1 -1
  138. oci/data_safe/models/random_date_format_entry.py +1 -1
  139. oci/data_safe/models/random_decimal_number_format_entry.py +1 -1
  140. oci/data_safe/models/random_digits_format_entry.py +1 -1
  141. oci/data_safe/models/random_list_format_entry.py +1 -1
  142. oci/data_safe/models/random_number_format_entry.py +1 -1
  143. oci/data_safe/models/random_string_format_entry.py +1 -1
  144. oci/data_safe/models/random_substitution_format_entry.py +1 -1
  145. oci/data_safe/models/regular_expression_format_entry.py +1 -1
  146. oci/data_safe/models/report.py +2 -2
  147. oci/data_safe/models/report_definition.py +8 -8
  148. oci/data_safe/models/report_summary.py +2 -2
  149. oci/data_safe/models/schedule_report_details.py +2 -2
  150. oci/data_safe/models/sdm_masking_policy_difference.py +5 -5
  151. oci/data_safe/models/sensitive_category.py +7 -0
  152. oci/data_safe/models/sensitive_type.py +33 -0
  153. oci/data_safe/models/sensitive_type_pattern.py +7 -0
  154. oci/data_safe/models/sensitive_type_summary.py +33 -0
  155. oci/data_safe/models/shuffle_format_entry.py +1 -1
  156. oci/data_safe/models/sql_expression_format_entry.py +1 -1
  157. oci/data_safe/models/sql_firewall_allowed_sql_aggregation.py +1 -1
  158. oci/data_safe/models/sql_firewall_allowed_sql_analytics_collection.py +1 -1
  159. oci/data_safe/models/sql_firewall_allowed_sql_collection.py +3 -3
  160. oci/data_safe/models/sql_firewall_allowed_sql_dimensions.py +7 -7
  161. oci/data_safe/models/sql_firewall_allowed_sql_summary.py +23 -23
  162. oci/data_safe/models/sql_firewall_config.py +1 -1
  163. oci/data_safe/models/sql_firewall_policy.py +35 -35
  164. oci/data_safe/models/sql_firewall_policy_aggregation.py +1 -1
  165. oci/data_safe/models/sql_firewall_policy_analytics_collection.py +1 -1
  166. oci/data_safe/models/sql_firewall_policy_collection.py +3 -3
  167. oci/data_safe/models/sql_firewall_policy_dimensions.py +9 -9
  168. oci/data_safe/models/sql_firewall_policy_summary.py +29 -29
  169. oci/data_safe/models/sql_firewall_violation_aggregation_dimensions.py +2 -2
  170. oci/data_safe/models/substring_format_entry.py +1 -1
  171. oci/data_safe/models/truncate_table_format_entry.py +1 -1
  172. oci/data_safe/models/udf_format_entry.py +1 -1
  173. oci/data_safe/models/update_sql_firewall_config_details.py +1 -1
  174. oci/data_safe/models/update_sql_firewall_policy_details.py +19 -19
  175. oci/data_safe/models/work_request.py +11 -3
  176. oci/data_safe/models/work_request_summary.py +11 -3
  177. oci/data_science/data_science_client.py +91 -91
  178. oci/database/database_client.py +327 -327
  179. oci/database_management/db_management_client.py +182 -182
  180. oci/database_management/diagnosability_client.py +4 -4
  181. oci/database_management/managed_my_sql_databases_client.py +6 -6
  182. oci/database_management/perfhub_client.py +1 -1
  183. oci/database_management/sql_tuning_client.py +17 -17
  184. oci/database_migration/database_migration_client.py +41 -41
  185. oci/database_tools/database_tools_client.py +23 -23
  186. oci/devops/devops_client.py +89 -89
  187. oci/disaster_recovery/disaster_recovery_client.py +29 -29
  188. oci/dns/dns_client.py +52 -52
  189. oci/dts/appliance_export_job_client.py +6 -6
  190. oci/dts/shipping_vendors_client.py +1 -1
  191. oci/dts/transfer_appliance_client.py +8 -8
  192. oci/dts/transfer_appliance_entitlement_client.py +3 -3
  193. oci/dts/transfer_device_client.py +5 -5
  194. oci/dts/transfer_job_client.py +6 -6
  195. oci/dts/transfer_package_client.py +7 -7
  196. oci/em_warehouse/em_data_lake_client.py +13 -13
  197. oci/em_warehouse/em_warehouse_client.py +13 -13
  198. oci/email/email_client.py +25 -25
  199. oci/events/events_client.py +6 -6
  200. oci/file_storage/file_storage_client.py +50 -50
  201. oci/fleet_software_update/fleet_software_update_client.py +44 -44
  202. oci/functions/functions_invoke_client.py +1 -1
  203. oci/functions/functions_management_client.py +16 -16
  204. oci/fusion_apps/data_masking_activity_client.py +3 -3
  205. oci/fusion_apps/fusion_applications_client.py +39 -39
  206. oci/fusion_apps/fusion_environment_client.py +15 -15
  207. oci/fusion_apps/fusion_environment_family_client.py +8 -8
  208. oci/fusion_apps/refresh_activity_client.py +4 -4
  209. oci/fusion_apps/scheduled_activity_client.py +2 -2
  210. oci/fusion_apps/service_attachment_client.py +2 -2
  211. oci/generic_artifacts_content/generic_artifacts_content_client.py +3 -3
  212. oci/golden_gate/golden_gate_client.py +61 -61
  213. oci/golden_gate/models/amazon_kinesis_connection.py +9 -0
  214. oci/golden_gate/models/amazon_kinesis_connection_summary.py +8 -0
  215. oci/golden_gate/models/amazon_redshift_connection.py +9 -0
  216. oci/golden_gate/models/amazon_redshift_connection_summary.py +8 -0
  217. oci/golden_gate/models/amazon_s3_connection.py +9 -0
  218. oci/golden_gate/models/amazon_s3_connection_summary.py +8 -0
  219. oci/golden_gate/models/azure_data_lake_storage_connection.py +9 -0
  220. oci/golden_gate/models/azure_data_lake_storage_connection_summary.py +8 -0
  221. oci/golden_gate/models/azure_synapse_connection.py +9 -0
  222. oci/golden_gate/models/azure_synapse_connection_summary.py +8 -0
  223. oci/golden_gate/models/connection.py +61 -4
  224. oci/golden_gate/models/connection_summary.py +61 -4
  225. oci/golden_gate/models/create_amazon_kinesis_connection_details.py +8 -0
  226. oci/golden_gate/models/create_amazon_redshift_connection_details.py +8 -0
  227. oci/golden_gate/models/create_amazon_s3_connection_details.py +8 -0
  228. oci/golden_gate/models/create_azure_data_lake_storage_connection_details.py +8 -0
  229. oci/golden_gate/models/create_azure_synapse_connection_details.py +8 -0
  230. oci/golden_gate/models/create_connection_details.py +61 -4
  231. oci/golden_gate/models/create_database_registration_details.py +2 -2
  232. oci/golden_gate/models/create_deployment_details.py +41 -2
  233. oci/golden_gate/models/create_elasticsearch_connection_details.py +8 -0
  234. oci/golden_gate/models/create_generic_connection_details.py +8 -0
  235. oci/golden_gate/models/create_golden_gate_connection_details.py +14 -0
  236. oci/golden_gate/models/create_google_big_query_connection_details.py +8 -0
  237. oci/golden_gate/models/create_google_cloud_storage_connection_details.py +8 -0
  238. oci/golden_gate/models/create_hdfs_connection_details.py +8 -0
  239. oci/golden_gate/models/create_java_message_service_connection_details.py +14 -0
  240. oci/golden_gate/models/create_kafka_connection_details.py +8 -0
  241. oci/golden_gate/models/create_kafka_schema_registry_connection_details.py +14 -0
  242. oci/golden_gate/models/create_microsoft_sqlserver_connection_details.py +14 -0
  243. oci/golden_gate/models/create_mongo_db_connection_details.py +8 -0
  244. oci/golden_gate/models/create_mysql_connection_details.py +14 -0
  245. oci/golden_gate/models/create_oci_object_storage_connection_details.py +8 -0
  246. oci/golden_gate/models/create_oracle_connection_details.py +14 -0
  247. oci/golden_gate/models/create_oracle_nosql_connection_details.py +8 -0
  248. oci/golden_gate/models/create_postgresql_connection_details.py +14 -0
  249. oci/golden_gate/models/create_redis_connection_details.py +8 -0
  250. oci/golden_gate/models/create_snowflake_connection_details.py +8 -0
  251. oci/golden_gate/models/database_registration.py +2 -2
  252. oci/golden_gate/models/database_registration_summary.py +2 -2
  253. oci/golden_gate/models/deployment.py +113 -4
  254. oci/golden_gate/models/deployment_summary.py +78 -2
  255. oci/golden_gate/models/elasticsearch_connection.py +9 -0
  256. oci/golden_gate/models/elasticsearch_connection_summary.py +8 -0
  257. oci/golden_gate/models/generic_connection.py +9 -0
  258. oci/golden_gate/models/generic_connection_summary.py +8 -0
  259. oci/golden_gate/models/golden_gate_connection.py +15 -0
  260. oci/golden_gate/models/golden_gate_connection_summary.py +14 -0
  261. oci/golden_gate/models/google_big_query_connection.py +9 -0
  262. oci/golden_gate/models/google_big_query_connection_summary.py +8 -0
  263. oci/golden_gate/models/google_cloud_storage_connection.py +9 -0
  264. oci/golden_gate/models/google_cloud_storage_connection_summary.py +8 -0
  265. oci/golden_gate/models/hdfs_connection.py +9 -0
  266. oci/golden_gate/models/hdfs_connection_summary.py +8 -0
  267. oci/golden_gate/models/java_message_service_connection.py +15 -0
  268. oci/golden_gate/models/java_message_service_connection_summary.py +14 -0
  269. oci/golden_gate/models/kafka_bootstrap_server.py +6 -0
  270. oci/golden_gate/models/kafka_connection.py +9 -0
  271. oci/golden_gate/models/kafka_connection_summary.py +8 -0
  272. oci/golden_gate/models/kafka_schema_registry_connection.py +15 -0
  273. oci/golden_gate/models/kafka_schema_registry_connection_summary.py +14 -0
  274. oci/golden_gate/models/microsoft_sqlserver_connection.py +15 -0
  275. oci/golden_gate/models/microsoft_sqlserver_connection_summary.py +14 -0
  276. oci/golden_gate/models/mongo_db_connection.py +9 -0
  277. oci/golden_gate/models/mongo_db_connection_summary.py +8 -0
  278. oci/golden_gate/models/mysql_connection.py +15 -0
  279. oci/golden_gate/models/mysql_connection_summary.py +14 -0
  280. oci/golden_gate/models/oci_object_storage_connection.py +9 -0
  281. oci/golden_gate/models/oci_object_storage_connection_summary.py +8 -0
  282. oci/golden_gate/models/oracle_connection.py +15 -0
  283. oci/golden_gate/models/oracle_connection_summary.py +14 -0
  284. oci/golden_gate/models/oracle_nosql_connection.py +9 -0
  285. oci/golden_gate/models/oracle_nosql_connection_summary.py +8 -0
  286. oci/golden_gate/models/postgresql_connection.py +15 -0
  287. oci/golden_gate/models/postgresql_connection_summary.py +14 -0
  288. oci/golden_gate/models/redis_connection.py +9 -0
  289. oci/golden_gate/models/redis_connection_summary.py +8 -0
  290. oci/golden_gate/models/snowflake_connection.py +9 -0
  291. oci/golden_gate/models/snowflake_connection_summary.py +8 -0
  292. oci/golden_gate/models/update_amazon_kinesis_connection_details.py +15 -0
  293. oci/golden_gate/models/update_amazon_redshift_connection_details.py +15 -0
  294. oci/golden_gate/models/update_amazon_s3_connection_details.py +15 -0
  295. oci/golden_gate/models/update_azure_data_lake_storage_connection_details.py +15 -0
  296. oci/golden_gate/models/update_azure_synapse_connection_details.py +15 -0
  297. oci/golden_gate/models/update_connection_details.py +94 -2
  298. oci/golden_gate/models/update_deployment_details.py +2 -2
  299. oci/golden_gate/models/update_elasticsearch_connection_details.py +15 -0
  300. oci/golden_gate/models/update_generic_connection_details.py +15 -0
  301. oci/golden_gate/models/update_golden_gate_connection_details.py +21 -0
  302. oci/golden_gate/models/update_google_big_query_connection_details.py +15 -0
  303. oci/golden_gate/models/update_google_cloud_storage_connection_details.py +15 -0
  304. oci/golden_gate/models/update_hdfs_connection_details.py +15 -0
  305. oci/golden_gate/models/update_java_message_service_connection_details.py +21 -0
  306. oci/golden_gate/models/update_kafka_connection_details.py +15 -0
  307. oci/golden_gate/models/update_kafka_schema_registry_connection_details.py +21 -0
  308. oci/golden_gate/models/update_microsoft_sqlserver_connection_details.py +21 -0
  309. oci/golden_gate/models/update_mongo_db_connection_details.py +15 -0
  310. oci/golden_gate/models/update_mysql_connection_details.py +21 -0
  311. oci/golden_gate/models/update_oci_object_storage_connection_details.py +15 -0
  312. oci/golden_gate/models/update_oracle_connection_details.py +21 -0
  313. oci/golden_gate/models/update_oracle_nosql_connection_details.py +15 -0
  314. oci/golden_gate/models/update_postgresql_connection_details.py +21 -0
  315. oci/golden_gate/models/update_redis_connection_details.py +15 -0
  316. oci/golden_gate/models/update_snowflake_connection_details.py +15 -0
  317. oci/governance_rules_control_plane/governance_rule_client.py +15 -15
  318. oci/governance_rules_control_plane/work_request_client.py +5 -5
  319. oci/healthchecks/health_checks_client.py +17 -17
  320. oci/identity/identity_client.py +145 -145
  321. oci/identity_data_plane/dataplane_client.py +2 -2
  322. oci/identity_domains/identity_domains_client.py +1901 -1029
  323. oci/identity_domains/models/__init__.py +8 -0
  324. oci/identity_domains/models/extension_user_user.py +59 -0
  325. oci/identity_domains/models/identity_propagation_trust.py +1623 -0
  326. oci/identity_domains/models/identity_propagation_trust_impersonation_service_users.py +243 -0
  327. oci/identity_domains/models/identity_propagation_trust_keytab.py +153 -0
  328. oci/identity_domains/models/identity_propagation_trusts.py +196 -0
  329. oci/identity_domains/models/me.py +1 -1
  330. oci/identity_domains/models/me_name.py +4 -4
  331. oci/identity_domains/models/user.py +1 -1
  332. oci/identity_domains/models/user_name.py +4 -4
  333. oci/integration/integration_instance_client.py +15 -15
  334. oci/jms/java_management_service_client.py +66 -66
  335. oci/jms_java_downloads/java_download_client.py +25 -25
  336. oci/key_management/ekm_client.py +5 -5
  337. oci/key_management/kms_crypto_client.py +6 -6
  338. oci/key_management/kms_management_client.py +21 -21
  339. oci/key_management/kms_vault_client.py +14 -14
  340. oci/license_manager/license_manager_client.py +18 -18
  341. oci/limits/limits_client.py +4 -4
  342. oci/limits/quotas_client.py +7 -7
  343. oci/load_balancer/load_balancer_client.py +61 -61
  344. oci/lockbox/lockbox_client.py +23 -23
  345. oci/log_analytics/log_analytics_client.py +193 -193
  346. oci/logging/logging_management_client.py +30 -30
  347. oci/loggingingestion/logging_client.py +1 -1
  348. oci/loggingsearch/log_search_client.py +1 -1
  349. oci/management_agent/management_agent_client.py +23 -23
  350. oci/management_dashboard/dashx_apis_client.py +14 -14
  351. oci/marketplace/account_client.py +2 -2
  352. oci/marketplace/marketplace_client.py +30 -30
  353. oci/marketplace_publisher/marketplace_publisher_client.py +71 -71
  354. oci/media_services/media_services_client.py +48 -48
  355. oci/media_services/media_stream_client.py +2 -2
  356. oci/monitoring/monitoring_client.py +13 -13
  357. oci/mysql/channels_client.py +7 -7
  358. oci/mysql/db_backups_client.py +6 -6
  359. oci/mysql/db_system_client.py +17 -17
  360. oci/mysql/mysqlaas_client.py +7 -7
  361. oci/mysql/replicas_client.py +5 -5
  362. oci/mysql/work_requests_client.py +4 -4
  363. oci/network_firewall/network_firewall_client.py +80 -80
  364. oci/network_load_balancer/network_load_balancer_client.py +34 -34
  365. oci/nosql/nosql_client.py +24 -24
  366. oci/object_storage/object_storage_client.py +50 -50
  367. oci/oce/oce_instance_client.py +10 -10
  368. oci/oci_control_center/occ_metrics_client.py +3 -3
  369. oci/ocvp/cluster_client.py +5 -5
  370. oci/ocvp/esxi_host_client.py +8 -8
  371. oci/ocvp/sddc_client.py +14 -14
  372. oci/ocvp/work_request_client.py +4 -4
  373. oci/oda/management_client.py +56 -56
  374. oci/oda/oda_client.py +17 -17
  375. oci/oda/odapackage_client.py +7 -7
  376. oci/onesubscription/billing_schedule_client.py +1 -1
  377. oci/onesubscription/commitment_client.py +2 -2
  378. oci/onesubscription/computed_usage_client.py +3 -3
  379. oci/onesubscription/invoice_summary_client.py +2 -2
  380. oci/onesubscription/organization_subscription_client.py +1 -1
  381. oci/onesubscription/ratecard_client.py +1 -1
  382. oci/onesubscription/subscribed_service_client.py +2 -2
  383. oci/onesubscription/subscription_client.py +1 -1
  384. oci/ons/notification_control_plane_client.py +6 -6
  385. oci/ons/notification_data_plane_client.py +10 -10
  386. oci/opa/opa_instance_client.py +11 -11
  387. oci/opensearch/opensearch_cluster_backup_client.py +4 -4
  388. oci/opensearch/opensearch_cluster_client.py +14 -14
  389. oci/operator_access_control/access_requests_client.py +9 -9
  390. oci/operator_access_control/operator_actions_client.py +2 -2
  391. oci/operator_access_control/operator_control_assignment_client.py +6 -6
  392. oci/operator_access_control/operator_control_client.py +6 -6
  393. oci/opsi/operations_insights_client.py +173 -173
  394. oci/optimizer/models/create_profile_details.py +33 -0
  395. oci/optimizer/models/profile.py +33 -0
  396. oci/optimizer/models/profile_summary.py +33 -0
  397. oci/optimizer/models/update_profile_details.py +33 -0
  398. oci/optimizer/optimizer_client.py +129 -53
  399. oci/os_management/event_client.py +8 -8
  400. oci/os_management/os_management_client.py +69 -69
  401. oci/os_management_hub/lifecycle_environment_client.py +11 -11
  402. oci/os_management_hub/managed_instance_client.py +22 -22
  403. oci/os_management_hub/managed_instance_group_client.py +22 -22
  404. oci/os_management_hub/management_station_client.py +8 -8
  405. oci/os_management_hub/onboarding_client.py +5 -5
  406. oci/os_management_hub/reporting_managed_instance_client.py +3 -3
  407. oci/os_management_hub/scheduled_job_client.py +6 -6
  408. oci/os_management_hub/software_source_client.py +22 -22
  409. oci/os_management_hub/work_request_client.py +4 -4
  410. oci/osp_gateway/address_rule_service_client.py +1 -1
  411. oci/osp_gateway/address_service_client.py +2 -2
  412. oci/osp_gateway/invoice_service_client.py +5 -5
  413. oci/osp_gateway/subscription_service_client.py +5 -5
  414. oci/osub_billing_schedule/billing_schedule_client.py +1 -1
  415. oci/osub_organization_subscription/organization_subscription_client.py +1 -1
  416. oci/osub_subscription/commitment_client.py +2 -2
  417. oci/osub_subscription/ratecard_client.py +1 -1
  418. oci/osub_subscription/subscription_client.py +1 -1
  419. oci/osub_usage/computed_usage_client.py +3 -3
  420. oci/psql/models/backup.py +53 -21
  421. oci/psql/models/backup_policy.py +5 -5
  422. oci/psql/models/backup_source_details.py +10 -5
  423. oci/psql/models/backup_summary.py +47 -19
  424. oci/psql/models/change_backup_compartment_details.py +7 -5
  425. oci/psql/models/change_configuration_compartment_details.py +7 -5
  426. oci/psql/models/change_db_system_compartment_details.py +3 -3
  427. oci/psql/models/config_overrides.py +5 -5
  428. oci/psql/models/config_params.py +17 -17
  429. oci/psql/models/configuration.py +37 -21
  430. oci/psql/models/configuration_collection.py +2 -2
  431. oci/psql/models/configuration_details.py +1 -1
  432. oci/psql/models/configuration_summary.py +39 -19
  433. oci/psql/models/connection_details.py +5 -5
  434. oci/psql/models/create_backup_details.py +13 -9
  435. oci/psql/models/create_configuration_details.py +21 -15
  436. oci/psql/models/create_db_instance_details.py +9 -9
  437. oci/psql/models/create_db_system_details.py +35 -25
  438. oci/psql/models/credentials.py +3 -3
  439. oci/psql/models/daily_backup_policy.py +3 -3
  440. oci/psql/models/db_configuration_override_collection.py +3 -3
  441. oci/psql/models/db_instance.py +35 -15
  442. oci/psql/models/db_instance_endpoint.py +3 -3
  443. oci/psql/models/db_system.py +63 -33
  444. oci/psql/models/db_system_collection.py +3 -3
  445. oci/psql/models/db_system_details.py +5 -5
  446. oci/psql/models/db_system_summary.py +57 -27
  447. oci/psql/models/default_config_params.py +15 -15
  448. oci/psql/models/default_configuration.py +31 -19
  449. oci/psql/models/default_configuration_collection.py +2 -2
  450. oci/psql/models/default_configuration_details.py +1 -1
  451. oci/psql/models/default_configuration_summary.py +29 -17
  452. oci/psql/models/endpoint.py +7 -7
  453. oci/psql/models/failover_db_system_details.py +13 -9
  454. oci/psql/models/management_policy.py +1 -1
  455. oci/psql/models/management_policy_details.py +1 -1
  456. oci/psql/models/monthly_backup_policy.py +5 -5
  457. oci/psql/models/network_details.py +15 -7
  458. oci/psql/models/none_backup_policy.py +1 -1
  459. oci/psql/models/none_source_details.py +1 -1
  460. oci/psql/models/oci_optimized_storage_details.py +3 -3
  461. oci/psql/models/password_details.py +4 -4
  462. oci/psql/models/patch_db_system_details.py +2 -2
  463. oci/psql/models/plain_text_password_details.py +3 -3
  464. oci/psql/models/primary_db_instance_details.py +3 -3
  465. oci/psql/models/reset_master_user_password_details.py +2 -2
  466. oci/psql/models/restart_db_instance_in_db_system_details.py +5 -5
  467. oci/psql/models/restore_db_system_details.py +11 -7
  468. oci/psql/models/shape_collection.py +3 -3
  469. oci/psql/models/shape_summary.py +11 -9
  470. oci/psql/models/source_details.py +1 -1
  471. oci/psql/models/storage_details.py +13 -13
  472. oci/psql/models/update_backup_details.py +4 -4
  473. oci/psql/models/update_configuration_details.py +73 -7
  474. oci/psql/models/update_db_config_params.py +11 -7
  475. oci/psql/models/update_db_system_db_instance_details.py +5 -5
  476. oci/psql/models/update_db_system_details.py +4 -4
  477. oci/psql/models/update_storage_details_params.py +5 -5
  478. oci/psql/models/vault_secret_password_details.py +9 -5
  479. oci/psql/models/weekly_backup_policy.py +5 -5
  480. oci/psql/models/work_request.py +19 -9
  481. oci/psql/models/work_request_error.py +12 -6
  482. oci/psql/models/work_request_error_collection.py +2 -2
  483. oci/psql/models/work_request_log_entry.py +6 -2
  484. oci/psql/models/work_request_log_entry_collection.py +2 -2
  485. oci/psql/models/work_request_resource.py +4 -4
  486. oci/psql/models/work_request_summary.py +18 -8
  487. oci/psql/models/work_request_summary_collection.py +2 -2
  488. oci/psql/postgresql_client.py +186 -127
  489. oci/psql/postgresql_client_composite_operations.py +23 -69
  490. oci/queue/queue_admin_client.py +11 -11
  491. oci/queue/queue_client.py +8 -8
  492. oci/recovery/database_recovery_client.py +23 -23
  493. oci/redis/redis_cluster_client.py +11 -11
  494. oci/resource_manager/resource_manager_client.py +52 -52
  495. oci/resource_search/resource_search_client.py +3 -3
  496. oci/rover/rover_bundle_client.py +8 -8
  497. oci/rover/rover_cluster_client.py +8 -8
  498. oci/rover/rover_entitlement_client.py +6 -6
  499. oci/rover/rover_node_client.py +15 -15
  500. oci/rover/shape_client.py +1 -1
  501. oci/rover/work_requests_client.py +5 -5
  502. oci/sch/service_connector_client.py +12 -12
  503. oci/secrets/secrets_client.py +3 -3
  504. oci/service_catalog/service_catalog_client.py +26 -26
  505. oci/service_manager_proxy/service_manager_proxy_client.py +2 -2
  506. oci/service_mesh/service_mesh_client.py +48 -48
  507. oci/stack_monitoring/models/discovery_details.py +7 -3
  508. oci/stack_monitoring/models/discovery_job_summary.py +7 -3
  509. oci/stack_monitoring/stack_monitoring_client.py +58 -58
  510. oci/streaming/stream_admin_client.py +18 -18
  511. oci/streaming/stream_client.py +8 -8
  512. oci/tenant_manager_control_plane/domain_client.py +5 -5
  513. oci/tenant_manager_control_plane/domain_governance_client.py +5 -5
  514. oci/tenant_manager_control_plane/governance_client.py +2 -2
  515. oci/tenant_manager_control_plane/link_client.py +3 -3
  516. oci/tenant_manager_control_plane/orders_client.py +2 -2
  517. oci/tenant_manager_control_plane/organization_client.py +10 -10
  518. oci/tenant_manager_control_plane/recipient_invitation_client.py +5 -5
  519. oci/tenant_manager_control_plane/sender_invitation_client.py +5 -5
  520. oci/tenant_manager_control_plane/subscription_client.py +11 -11
  521. oci/tenant_manager_control_plane/work_request_client.py +4 -4
  522. oci/threat_intelligence/threatintel_client.py +5 -5
  523. oci/usage/resources_client.py +2 -2
  524. oci/usage/rewards_client.py +6 -6
  525. oci/usage/usagelimits_client.py +1 -1
  526. oci/usage_api/models/__init__.py +24 -0
  527. oci/usage_api/models/average_carbon_emission.py +103 -0
  528. oci/usage_api/models/clean_energy_usage.py +134 -0
  529. oci/usage_api/models/create_schedule_details.py +4 -4
  530. oci/usage_api/models/create_usage_carbon_emissions_query_details.py +99 -0
  531. oci/usage_api/models/request_usage_carbon_emissions_details.py +297 -0
  532. oci/usage_api/models/schedule.py +4 -4
  533. oci/usage_api/models/update_schedule_details.py +2 -2
  534. oci/usage_api/models/update_usage_carbon_emissions_query_details.py +68 -0
  535. oci/usage_api/models/usage_carbon_emission_aggregation.py +103 -0
  536. oci/usage_api/models/usage_carbon_emission_summary.py +630 -0
  537. oci/usage_api/models/usage_carbon_emissions_query.py +130 -0
  538. oci/usage_api/models/usage_carbon_emissions_query_collection.py +72 -0
  539. oci/usage_api/models/usage_carbon_emissions_query_definition.py +157 -0
  540. oci/usage_api/models/usage_carbon_emissions_query_summary.py +99 -0
  541. oci/usage_api/models/usage_carbon_emissions_report_query.py +356 -0
  542. oci/usage_api/usageapi_client.py +1151 -210
  543. oci/vault/vaults_client.py +11 -11
  544. oci/vbs_inst/vbs_instance_client.py +10 -10
  545. oci/version.py +1 -1
  546. oci/visual_builder/vb_instance_client.py +13 -13
  547. oci/vn_monitoring/vn_monitoring_client.py +12 -12
  548. oci/vulnerability_scanning/vulnerability_scanning_client.py +58 -58
  549. oci/waa/waa_client.py +13 -13
  550. oci/waa/work_request_client.py +4 -4
  551. oci/waas/redirect_client.py +6 -6
  552. oci/waas/waas_client.py +66 -66
  553. oci/waf/waf_client.py +24 -24
  554. oci/work_requests/work_request_client.py +4 -4
  555. {oci-2.117.0.dist-info → oci-2.118.0.dist-info}/METADATA +1 -1
  556. {oci-2.117.0.dist-info → oci-2.118.0.dist-info}/RECORD +560 -536
  557. {oci-2.117.0.dist-info → oci-2.118.0.dist-info}/LICENSE.txt +0 -0
  558. {oci-2.117.0.dist-info → oci-2.118.0.dist-info}/THIRD_PARTY_LICENSES.txt +0 -0
  559. {oci-2.117.0.dist-info → oci-2.118.0.dist-info}/WHEEL +0 -0
  560. {oci-2.117.0.dist-info → oci-2.118.0.dist-info}/top_level.txt +0 -0
@@ -151,7 +151,7 @@ class UsageapiClient(object):
151
151
  :rtype: :class:`~oci.response.Response`
152
152
 
153
153
  :example:
154
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/create_custom_table.py.html>`__ to see an example of how to use create_custom_table API.
154
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/create_custom_table.py.html>`__ to see an example of how to use create_custom_table API.
155
155
  """
156
156
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
157
157
  required_arguments = []
@@ -248,7 +248,7 @@ class UsageapiClient(object):
248
248
  :rtype: :class:`~oci.response.Response`
249
249
 
250
250
  :example:
251
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/create_query.py.html>`__ to see an example of how to use create_query API.
251
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/create_query.py.html>`__ to see an example of how to use create_query API.
252
252
  """
253
253
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
254
254
  required_arguments = []
@@ -345,7 +345,7 @@ class UsageapiClient(object):
345
345
  :rtype: :class:`~oci.response.Response`
346
346
 
347
347
  :example:
348
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/create_schedule.py.html>`__ to see an example of how to use create_schedule API.
348
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/create_schedule.py.html>`__ to see an example of how to use create_schedule API.
349
349
  """
350
350
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
351
351
  required_arguments = []
@@ -407,6 +407,103 @@ class UsageapiClient(object):
407
407
  api_reference_link=api_reference_link,
408
408
  required_arguments=required_arguments)
409
409
 
410
+ def create_usage_carbon_emissions_query(self, create_usage_carbon_emissions_query_details, **kwargs):
411
+ """
412
+ Returns the created usage carbon emissions query.
413
+
414
+
415
+ :param oci.usage_api.models.CreateUsageCarbonEmissionsQueryDetails create_usage_carbon_emissions_query_details: (required)
416
+ New query details. Up to ten saved queries.
417
+
418
+ :param str opc_request_id: (optional)
419
+ Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
420
+ particular request, please provide the request ID.
421
+
422
+ :param str opc_retry_token: (optional)
423
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
424
+ server error, without risk of executing that same action again. Retry tokens expire after 24
425
+ hours, but can be invalidated before then due to conflicting operations. For example, if a resource
426
+ has been deleted and purged from the system, then a retry of the original creation request
427
+ might be rejected.
428
+
429
+ :param obj retry_strategy: (optional)
430
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
431
+
432
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
433
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
434
+
435
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
436
+
437
+ :param bool allow_control_chars: (optional)
438
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
439
+ By default, the response will not allow control characters in strings
440
+
441
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.UsageCarbonEmissionsQuery`
442
+ :rtype: :class:`~oci.response.Response`
443
+
444
+ :example:
445
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/create_usage_carbon_emissions_query.py.html>`__ to see an example of how to use create_usage_carbon_emissions_query API.
446
+ """
447
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
448
+ required_arguments = []
449
+ resource_path = "/usageCarbonEmissionsQueries"
450
+ method = "POST"
451
+ operation_name = "create_usage_carbon_emissions_query"
452
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/UsageCarbonEmissionsQuery/CreateUsageCarbonEmissionsQuery"
453
+
454
+ # Don't accept unknown kwargs
455
+ expected_kwargs = [
456
+ "allow_control_chars",
457
+ "retry_strategy",
458
+ "opc_request_id",
459
+ "opc_retry_token"
460
+ ]
461
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
462
+ if extra_kwargs:
463
+ raise ValueError(
464
+ f"create_usage_carbon_emissions_query got unknown kwargs: {extra_kwargs!r}")
465
+
466
+ header_params = {
467
+ "accept": "application/json",
468
+ "content-type": "application/json",
469
+ "opc-request-id": kwargs.get("opc_request_id", missing),
470
+ "opc-retry-token": kwargs.get("opc_retry_token", missing)
471
+ }
472
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
473
+
474
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
475
+ operation_retry_strategy=kwargs.get('retry_strategy'),
476
+ client_retry_strategy=self.retry_strategy
477
+ )
478
+
479
+ if retry_strategy:
480
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
481
+ self.base_client.add_opc_retry_token_if_needed(header_params)
482
+ self.base_client.add_opc_client_retries_header(header_params)
483
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
484
+ return retry_strategy.make_retrying_call(
485
+ self.base_client.call_api,
486
+ resource_path=resource_path,
487
+ method=method,
488
+ header_params=header_params,
489
+ body=create_usage_carbon_emissions_query_details,
490
+ response_type="UsageCarbonEmissionsQuery",
491
+ allow_control_chars=kwargs.get('allow_control_chars'),
492
+ operation_name=operation_name,
493
+ api_reference_link=api_reference_link,
494
+ required_arguments=required_arguments)
495
+ else:
496
+ return self.base_client.call_api(
497
+ resource_path=resource_path,
498
+ method=method,
499
+ header_params=header_params,
500
+ body=create_usage_carbon_emissions_query_details,
501
+ response_type="UsageCarbonEmissionsQuery",
502
+ allow_control_chars=kwargs.get('allow_control_chars'),
503
+ operation_name=operation_name,
504
+ api_reference_link=api_reference_link,
505
+ required_arguments=required_arguments)
506
+
410
507
  def delete_custom_table(self, custom_table_id, **kwargs):
411
508
  """
412
509
  Delete a saved custom table by the OCID.
@@ -442,7 +539,7 @@ class UsageapiClient(object):
442
539
  :rtype: :class:`~oci.response.Response`
443
540
 
444
541
  :example:
445
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/delete_custom_table.py.html>`__ to see an example of how to use delete_custom_table API.
542
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/delete_custom_table.py.html>`__ to see an example of how to use delete_custom_table API.
446
543
  """
447
544
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
448
545
  required_arguments = ['customTableId']
@@ -546,7 +643,7 @@ class UsageapiClient(object):
546
643
  :rtype: :class:`~oci.response.Response`
547
644
 
548
645
  :example:
549
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/delete_query.py.html>`__ to see an example of how to use delete_query API.
646
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/delete_query.py.html>`__ to see an example of how to use delete_query API.
550
647
  """
551
648
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
552
649
  required_arguments = ['queryId']
@@ -650,7 +747,7 @@ class UsageapiClient(object):
650
747
  :rtype: :class:`~oci.response.Response`
651
748
 
652
749
  :example:
653
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/delete_schedule.py.html>`__ to see an example of how to use delete_schedule API.
750
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/delete_schedule.py.html>`__ to see an example of how to use delete_schedule API.
654
751
  """
655
752
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
656
753
  required_arguments = ['scheduleId']
@@ -719,6 +816,110 @@ class UsageapiClient(object):
719
816
  api_reference_link=api_reference_link,
720
817
  required_arguments=required_arguments)
721
818
 
819
+ def delete_usage_carbon_emissions_query(self, usage_carbon_emissions_query_id, **kwargs):
820
+ """
821
+ Delete a usage carbon emissions saved query by the OCID.
822
+
823
+
824
+ :param str usage_carbon_emissions_query_id: (required)
825
+ The query unique OCID.
826
+
827
+ :param str opc_request_id: (optional)
828
+ Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
829
+ particular request, please provide the request ID.
830
+
831
+ :param str if_match: (optional)
832
+ For optimistic concurrency control. In the PUT or DELETE call
833
+ for a resource, set the `if-match` parameter to the value of the
834
+ etag from a previous GET or POST response for that resource.
835
+ The resource will be updated or deleted, only if the etag you
836
+ provide matches the resource's current etag value.
837
+
838
+ :param obj retry_strategy: (optional)
839
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
840
+
841
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
842
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
843
+
844
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
845
+
846
+ :param bool allow_control_chars: (optional)
847
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
848
+ By default, the response will not allow control characters in strings
849
+
850
+ :return: A :class:`~oci.response.Response` object with data of type None
851
+ :rtype: :class:`~oci.response.Response`
852
+
853
+ :example:
854
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/delete_usage_carbon_emissions_query.py.html>`__ to see an example of how to use delete_usage_carbon_emissions_query API.
855
+ """
856
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
857
+ required_arguments = ['usageCarbonEmissionsQueryId']
858
+ resource_path = "/usageCarbonEmissionsQueries/{usageCarbonEmissionsQueryId}"
859
+ method = "DELETE"
860
+ operation_name = "delete_usage_carbon_emissions_query"
861
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/UsageCarbonEmissionsQuery/DeleteUsageCarbonEmissionsQuery"
862
+
863
+ # Don't accept unknown kwargs
864
+ expected_kwargs = [
865
+ "allow_control_chars",
866
+ "retry_strategy",
867
+ "opc_request_id",
868
+ "if_match"
869
+ ]
870
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
871
+ if extra_kwargs:
872
+ raise ValueError(
873
+ f"delete_usage_carbon_emissions_query got unknown kwargs: {extra_kwargs!r}")
874
+
875
+ path_params = {
876
+ "usageCarbonEmissionsQueryId": usage_carbon_emissions_query_id
877
+ }
878
+
879
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
880
+
881
+ for (k, v) in six.iteritems(path_params):
882
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
883
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
884
+
885
+ header_params = {
886
+ "accept": "application/json",
887
+ "content-type": "application/json",
888
+ "opc-request-id": kwargs.get("opc_request_id", missing),
889
+ "if-match": kwargs.get("if_match", missing)
890
+ }
891
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
892
+
893
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
894
+ operation_retry_strategy=kwargs.get('retry_strategy'),
895
+ client_retry_strategy=self.retry_strategy
896
+ )
897
+
898
+ if retry_strategy:
899
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
900
+ self.base_client.add_opc_client_retries_header(header_params)
901
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
902
+ return retry_strategy.make_retrying_call(
903
+ self.base_client.call_api,
904
+ resource_path=resource_path,
905
+ method=method,
906
+ path_params=path_params,
907
+ header_params=header_params,
908
+ allow_control_chars=kwargs.get('allow_control_chars'),
909
+ operation_name=operation_name,
910
+ api_reference_link=api_reference_link,
911
+ required_arguments=required_arguments)
912
+ else:
913
+ return self.base_client.call_api(
914
+ resource_path=resource_path,
915
+ method=method,
916
+ path_params=path_params,
917
+ header_params=header_params,
918
+ allow_control_chars=kwargs.get('allow_control_chars'),
919
+ operation_name=operation_name,
920
+ api_reference_link=api_reference_link,
921
+ required_arguments=required_arguments)
922
+
722
923
  def get_custom_table(self, custom_table_id, **kwargs):
723
924
  """
724
925
  Returns the saved custom table.
@@ -747,7 +948,7 @@ class UsageapiClient(object):
747
948
  :rtype: :class:`~oci.response.Response`
748
949
 
749
950
  :example:
750
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/get_custom_table.py.html>`__ to see an example of how to use get_custom_table API.
951
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/get_custom_table.py.html>`__ to see an example of how to use get_custom_table API.
751
952
  """
752
953
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
753
954
  required_arguments = ['customTableId']
@@ -844,7 +1045,7 @@ class UsageapiClient(object):
844
1045
  :rtype: :class:`~oci.response.Response`
845
1046
 
846
1047
  :example:
847
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/get_query.py.html>`__ to see an example of how to use get_query API.
1048
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/get_query.py.html>`__ to see an example of how to use get_query API.
848
1049
  """
849
1050
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
850
1051
  required_arguments = ['queryId']
@@ -941,7 +1142,7 @@ class UsageapiClient(object):
941
1142
  :rtype: :class:`~oci.response.Response`
942
1143
 
943
1144
  :example:
944
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/get_schedule.py.html>`__ to see an example of how to use get_schedule API.
1145
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/get_schedule.py.html>`__ to see an example of how to use get_schedule API.
945
1146
  """
946
1147
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
947
1148
  required_arguments = ['scheduleId']
@@ -1038,7 +1239,7 @@ class UsageapiClient(object):
1038
1239
  :rtype: :class:`~oci.response.Response`
1039
1240
 
1040
1241
  :example:
1041
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/get_scheduled_run.py.html>`__ to see an example of how to use get_scheduled_run API.
1242
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/get_scheduled_run.py.html>`__ to see an example of how to use get_scheduled_run API.
1042
1243
  """
1043
1244
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1044
1245
  required_arguments = ['scheduledRunId']
@@ -1107,38 +1308,18 @@ class UsageapiClient(object):
1107
1308
  api_reference_link=api_reference_link,
1108
1309
  required_arguments=required_arguments)
1109
1310
 
1110
- def list_custom_tables(self, compartment_id, saved_report_id, **kwargs):
1311
+ def get_usage_carbon_emissions_query(self, usage_carbon_emissions_query_id, **kwargs):
1111
1312
  """
1112
- Returns the saved custom table list.
1313
+ Returns the usage carbon emissions saved query.
1113
1314
 
1114
1315
 
1115
- :param str compartment_id: (required)
1116
- The compartment ID in which to list resources.
1117
-
1118
- :param str saved_report_id: (required)
1119
- The saved report ID in which to list resources.
1316
+ :param str usage_carbon_emissions_query_id: (required)
1317
+ The query unique OCID.
1120
1318
 
1121
1319
  :param str opc_request_id: (optional)
1122
1320
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
1123
1321
  particular request, please provide the request ID.
1124
1322
 
1125
- :param int limit: (optional)
1126
- The maximumimum number of items to return.
1127
-
1128
- :param str page: (optional)
1129
- The page token representing the page at which to start retrieving results.
1130
- This is usually retrieved from a previous list call.
1131
-
1132
- :param str sort_by: (optional)
1133
- The field to sort by. If not specified, the default is displayName.
1134
-
1135
- Allowed values are: "displayName"
1136
-
1137
- :param str sort_order: (optional)
1138
- The sort order to use, whether 'asc' or 'desc'.
1139
-
1140
- Allowed values are: "ASC", "DESC"
1141
-
1142
1323
  :param obj retry_strategy: (optional)
1143
1324
  A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1144
1325
 
@@ -1151,57 +1332,39 @@ class UsageapiClient(object):
1151
1332
  allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1152
1333
  By default, the response will not allow control characters in strings
1153
1334
 
1154
- :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.CustomTableCollection`
1335
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.UsageCarbonEmissionsQuery`
1155
1336
  :rtype: :class:`~oci.response.Response`
1156
1337
 
1157
1338
  :example:
1158
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/list_custom_tables.py.html>`__ to see an example of how to use list_custom_tables API.
1339
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/get_usage_carbon_emissions_query.py.html>`__ to see an example of how to use get_usage_carbon_emissions_query API.
1159
1340
  """
1160
1341
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1161
- required_arguments = ['compartmentId', 'savedReportId']
1162
- resource_path = "/customTables"
1342
+ required_arguments = ['usageCarbonEmissionsQueryId']
1343
+ resource_path = "/usageCarbonEmissionsQueries/{usageCarbonEmissionsQueryId}"
1163
1344
  method = "GET"
1164
- operation_name = "list_custom_tables"
1165
- api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/CustomTable/ListCustomTables"
1345
+ operation_name = "get_usage_carbon_emissions_query"
1346
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/UsageCarbonEmissionsQuery/GetUsageCarbonEmissionsQuery"
1166
1347
 
1167
1348
  # Don't accept unknown kwargs
1168
1349
  expected_kwargs = [
1169
1350
  "allow_control_chars",
1170
1351
  "retry_strategy",
1171
- "opc_request_id",
1172
- "limit",
1173
- "page",
1174
- "sort_by",
1175
- "sort_order"
1352
+ "opc_request_id"
1176
1353
  ]
1177
1354
  extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1178
1355
  if extra_kwargs:
1179
1356
  raise ValueError(
1180
- f"list_custom_tables got unknown kwargs: {extra_kwargs!r}")
1357
+ f"get_usage_carbon_emissions_query got unknown kwargs: {extra_kwargs!r}")
1181
1358
 
1182
- if 'sort_by' in kwargs:
1183
- sort_by_allowed_values = ["displayName"]
1184
- if kwargs['sort_by'] not in sort_by_allowed_values:
1185
- raise ValueError(
1186
- f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
1187
- )
1359
+ path_params = {
1360
+ "usageCarbonEmissionsQueryId": usage_carbon_emissions_query_id
1361
+ }
1188
1362
 
1189
- if 'sort_order' in kwargs:
1190
- sort_order_allowed_values = ["ASC", "DESC"]
1191
- if kwargs['sort_order'] not in sort_order_allowed_values:
1192
- raise ValueError(
1193
- f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
1194
- )
1363
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
1195
1364
 
1196
- query_params = {
1197
- "limit": kwargs.get("limit", missing),
1198
- "page": kwargs.get("page", missing),
1199
- "compartmentId": compartment_id,
1200
- "savedReportId": saved_report_id,
1201
- "sortBy": kwargs.get("sort_by", missing),
1202
- "sortOrder": kwargs.get("sort_order", missing)
1203
- }
1204
- query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
1365
+ for (k, v) in six.iteritems(path_params):
1366
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
1367
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
1205
1368
 
1206
1369
  header_params = {
1207
1370
  "accept": "application/json",
@@ -1223,9 +1386,9 @@ class UsageapiClient(object):
1223
1386
  self.base_client.call_api,
1224
1387
  resource_path=resource_path,
1225
1388
  method=method,
1226
- query_params=query_params,
1389
+ path_params=path_params,
1227
1390
  header_params=header_params,
1228
- response_type="CustomTableCollection",
1391
+ response_type="UsageCarbonEmissionsQuery",
1229
1392
  allow_control_chars=kwargs.get('allow_control_chars'),
1230
1393
  operation_name=operation_name,
1231
1394
  api_reference_link=api_reference_link,
@@ -1234,22 +1397,25 @@ class UsageapiClient(object):
1234
1397
  return self.base_client.call_api(
1235
1398
  resource_path=resource_path,
1236
1399
  method=method,
1237
- query_params=query_params,
1400
+ path_params=path_params,
1238
1401
  header_params=header_params,
1239
- response_type="CustomTableCollection",
1402
+ response_type="UsageCarbonEmissionsQuery",
1240
1403
  allow_control_chars=kwargs.get('allow_control_chars'),
1241
1404
  operation_name=operation_name,
1242
1405
  api_reference_link=api_reference_link,
1243
1406
  required_arguments=required_arguments)
1244
1407
 
1245
- def list_queries(self, compartment_id, **kwargs):
1408
+ def list_custom_tables(self, compartment_id, saved_report_id, **kwargs):
1246
1409
  """
1247
- Returns the saved query list.
1410
+ Returns the saved custom table list.
1248
1411
 
1249
1412
 
1250
1413
  :param str compartment_id: (required)
1251
1414
  The compartment ID in which to list resources.
1252
1415
 
1416
+ :param str saved_report_id: (required)
1417
+ The saved report ID in which to list resources.
1418
+
1253
1419
  :param str opc_request_id: (optional)
1254
1420
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
1255
1421
  particular request, please provide the request ID.
@@ -1283,11 +1449,143 @@ class UsageapiClient(object):
1283
1449
  allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1284
1450
  By default, the response will not allow control characters in strings
1285
1451
 
1286
- :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.QueryCollection`
1452
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.CustomTableCollection`
1453
+ :rtype: :class:`~oci.response.Response`
1454
+
1455
+ :example:
1456
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/list_custom_tables.py.html>`__ to see an example of how to use list_custom_tables API.
1457
+ """
1458
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1459
+ required_arguments = ['compartmentId', 'savedReportId']
1460
+ resource_path = "/customTables"
1461
+ method = "GET"
1462
+ operation_name = "list_custom_tables"
1463
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/CustomTable/ListCustomTables"
1464
+
1465
+ # Don't accept unknown kwargs
1466
+ expected_kwargs = [
1467
+ "allow_control_chars",
1468
+ "retry_strategy",
1469
+ "opc_request_id",
1470
+ "limit",
1471
+ "page",
1472
+ "sort_by",
1473
+ "sort_order"
1474
+ ]
1475
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1476
+ if extra_kwargs:
1477
+ raise ValueError(
1478
+ f"list_custom_tables got unknown kwargs: {extra_kwargs!r}")
1479
+
1480
+ if 'sort_by' in kwargs:
1481
+ sort_by_allowed_values = ["displayName"]
1482
+ if kwargs['sort_by'] not in sort_by_allowed_values:
1483
+ raise ValueError(
1484
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
1485
+ )
1486
+
1487
+ if 'sort_order' in kwargs:
1488
+ sort_order_allowed_values = ["ASC", "DESC"]
1489
+ if kwargs['sort_order'] not in sort_order_allowed_values:
1490
+ raise ValueError(
1491
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
1492
+ )
1493
+
1494
+ query_params = {
1495
+ "limit": kwargs.get("limit", missing),
1496
+ "page": kwargs.get("page", missing),
1497
+ "compartmentId": compartment_id,
1498
+ "savedReportId": saved_report_id,
1499
+ "sortBy": kwargs.get("sort_by", missing),
1500
+ "sortOrder": kwargs.get("sort_order", missing)
1501
+ }
1502
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
1503
+
1504
+ header_params = {
1505
+ "accept": "application/json",
1506
+ "content-type": "application/json",
1507
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1508
+ }
1509
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1510
+
1511
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1512
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1513
+ client_retry_strategy=self.retry_strategy
1514
+ )
1515
+
1516
+ if retry_strategy:
1517
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1518
+ self.base_client.add_opc_client_retries_header(header_params)
1519
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1520
+ return retry_strategy.make_retrying_call(
1521
+ self.base_client.call_api,
1522
+ resource_path=resource_path,
1523
+ method=method,
1524
+ query_params=query_params,
1525
+ header_params=header_params,
1526
+ response_type="CustomTableCollection",
1527
+ allow_control_chars=kwargs.get('allow_control_chars'),
1528
+ operation_name=operation_name,
1529
+ api_reference_link=api_reference_link,
1530
+ required_arguments=required_arguments)
1531
+ else:
1532
+ return self.base_client.call_api(
1533
+ resource_path=resource_path,
1534
+ method=method,
1535
+ query_params=query_params,
1536
+ header_params=header_params,
1537
+ response_type="CustomTableCollection",
1538
+ allow_control_chars=kwargs.get('allow_control_chars'),
1539
+ operation_name=operation_name,
1540
+ api_reference_link=api_reference_link,
1541
+ required_arguments=required_arguments)
1542
+
1543
+ def list_queries(self, compartment_id, **kwargs):
1544
+ """
1545
+ Returns the saved query list.
1546
+
1547
+
1548
+ :param str compartment_id: (required)
1549
+ The compartment ID in which to list resources.
1550
+
1551
+ :param str opc_request_id: (optional)
1552
+ Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
1553
+ particular request, please provide the request ID.
1554
+
1555
+ :param int limit: (optional)
1556
+ The maximumimum number of items to return.
1557
+
1558
+ :param str page: (optional)
1559
+ The page token representing the page at which to start retrieving results.
1560
+ This is usually retrieved from a previous list call.
1561
+
1562
+ :param str sort_by: (optional)
1563
+ The field to sort by. If not specified, the default is displayName.
1564
+
1565
+ Allowed values are: "displayName"
1566
+
1567
+ :param str sort_order: (optional)
1568
+ The sort order to use, whether 'asc' or 'desc'.
1569
+
1570
+ Allowed values are: "ASC", "DESC"
1571
+
1572
+ :param obj retry_strategy: (optional)
1573
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1574
+
1575
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
1576
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1577
+
1578
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1579
+
1580
+ :param bool allow_control_chars: (optional)
1581
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1582
+ By default, the response will not allow control characters in strings
1583
+
1584
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.QueryCollection`
1287
1585
  :rtype: :class:`~oci.response.Response`
1288
1586
 
1289
1587
  :example:
1290
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/list_queries.py.html>`__ to see an example of how to use list_queries API.
1588
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/list_queries.py.html>`__ to see an example of how to use list_queries API.
1291
1589
  """
1292
1590
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1293
1591
  required_arguments = ['compartmentId']
@@ -1326,11 +1624,612 @@ class UsageapiClient(object):
1326
1624
  )
1327
1625
 
1328
1626
  query_params = {
1329
- "limit": kwargs.get("limit", missing),
1330
- "page": kwargs.get("page", missing),
1331
- "compartmentId": compartment_id,
1332
- "sortBy": kwargs.get("sort_by", missing),
1333
- "sortOrder": kwargs.get("sort_order", missing)
1627
+ "limit": kwargs.get("limit", missing),
1628
+ "page": kwargs.get("page", missing),
1629
+ "compartmentId": compartment_id,
1630
+ "sortBy": kwargs.get("sort_by", missing),
1631
+ "sortOrder": kwargs.get("sort_order", missing)
1632
+ }
1633
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
1634
+
1635
+ header_params = {
1636
+ "accept": "application/json",
1637
+ "content-type": "application/json",
1638
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1639
+ }
1640
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1641
+
1642
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1643
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1644
+ client_retry_strategy=self.retry_strategy
1645
+ )
1646
+
1647
+ if retry_strategy:
1648
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1649
+ self.base_client.add_opc_client_retries_header(header_params)
1650
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1651
+ return retry_strategy.make_retrying_call(
1652
+ self.base_client.call_api,
1653
+ resource_path=resource_path,
1654
+ method=method,
1655
+ query_params=query_params,
1656
+ header_params=header_params,
1657
+ response_type="QueryCollection",
1658
+ allow_control_chars=kwargs.get('allow_control_chars'),
1659
+ operation_name=operation_name,
1660
+ api_reference_link=api_reference_link,
1661
+ required_arguments=required_arguments)
1662
+ else:
1663
+ return self.base_client.call_api(
1664
+ resource_path=resource_path,
1665
+ method=method,
1666
+ query_params=query_params,
1667
+ header_params=header_params,
1668
+ response_type="QueryCollection",
1669
+ allow_control_chars=kwargs.get('allow_control_chars'),
1670
+ operation_name=operation_name,
1671
+ api_reference_link=api_reference_link,
1672
+ required_arguments=required_arguments)
1673
+
1674
+ def list_scheduled_runs(self, schedule_id, **kwargs):
1675
+ """
1676
+ Returns schedule history list.
1677
+
1678
+
1679
+ :param str schedule_id: (required)
1680
+ The unique ID of a schedule.
1681
+
1682
+ :param str opc_request_id: (optional)
1683
+ Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
1684
+ particular request, please provide the request ID.
1685
+
1686
+ :param str page: (optional)
1687
+ The page token representing the page at which to start retrieving results.
1688
+ This is usually retrieved from a previous list call.
1689
+
1690
+ :param int limit: (optional)
1691
+ The maximumimum number of items to return.
1692
+
1693
+ :param str sort_by: (optional)
1694
+ The field to sort by. If not specified, the default is timeCreated.
1695
+
1696
+ Allowed values are: "timeCreated"
1697
+
1698
+ :param str sort_order: (optional)
1699
+ The sort order to use, whether 'asc' or 'desc'.
1700
+
1701
+ Allowed values are: "ASC", "DESC"
1702
+
1703
+ :param obj retry_strategy: (optional)
1704
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1705
+
1706
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
1707
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1708
+
1709
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1710
+
1711
+ :param bool allow_control_chars: (optional)
1712
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1713
+ By default, the response will not allow control characters in strings
1714
+
1715
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.ScheduledRunCollection`
1716
+ :rtype: :class:`~oci.response.Response`
1717
+
1718
+ :example:
1719
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/list_scheduled_runs.py.html>`__ to see an example of how to use list_scheduled_runs API.
1720
+ """
1721
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1722
+ required_arguments = ['scheduleId']
1723
+ resource_path = "/scheduledRuns"
1724
+ method = "GET"
1725
+ operation_name = "list_scheduled_runs"
1726
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/ScheduledRun/ListScheduledRuns"
1727
+
1728
+ # Don't accept unknown kwargs
1729
+ expected_kwargs = [
1730
+ "allow_control_chars",
1731
+ "retry_strategy",
1732
+ "opc_request_id",
1733
+ "page",
1734
+ "limit",
1735
+ "sort_by",
1736
+ "sort_order"
1737
+ ]
1738
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1739
+ if extra_kwargs:
1740
+ raise ValueError(
1741
+ f"list_scheduled_runs got unknown kwargs: {extra_kwargs!r}")
1742
+
1743
+ if 'sort_by' in kwargs:
1744
+ sort_by_allowed_values = ["timeCreated"]
1745
+ if kwargs['sort_by'] not in sort_by_allowed_values:
1746
+ raise ValueError(
1747
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
1748
+ )
1749
+
1750
+ if 'sort_order' in kwargs:
1751
+ sort_order_allowed_values = ["ASC", "DESC"]
1752
+ if kwargs['sort_order'] not in sort_order_allowed_values:
1753
+ raise ValueError(
1754
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
1755
+ )
1756
+
1757
+ query_params = {
1758
+ "page": kwargs.get("page", missing),
1759
+ "limit": kwargs.get("limit", missing),
1760
+ "scheduleId": schedule_id,
1761
+ "sortBy": kwargs.get("sort_by", missing),
1762
+ "sortOrder": kwargs.get("sort_order", missing)
1763
+ }
1764
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
1765
+
1766
+ header_params = {
1767
+ "accept": "application/json",
1768
+ "content-type": "application/json",
1769
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1770
+ }
1771
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1772
+
1773
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1774
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1775
+ client_retry_strategy=self.retry_strategy
1776
+ )
1777
+
1778
+ if retry_strategy:
1779
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1780
+ self.base_client.add_opc_client_retries_header(header_params)
1781
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1782
+ return retry_strategy.make_retrying_call(
1783
+ self.base_client.call_api,
1784
+ resource_path=resource_path,
1785
+ method=method,
1786
+ query_params=query_params,
1787
+ header_params=header_params,
1788
+ response_type="ScheduledRunCollection",
1789
+ allow_control_chars=kwargs.get('allow_control_chars'),
1790
+ operation_name=operation_name,
1791
+ api_reference_link=api_reference_link,
1792
+ required_arguments=required_arguments)
1793
+ else:
1794
+ return self.base_client.call_api(
1795
+ resource_path=resource_path,
1796
+ method=method,
1797
+ query_params=query_params,
1798
+ header_params=header_params,
1799
+ response_type="ScheduledRunCollection",
1800
+ allow_control_chars=kwargs.get('allow_control_chars'),
1801
+ operation_name=operation_name,
1802
+ api_reference_link=api_reference_link,
1803
+ required_arguments=required_arguments)
1804
+
1805
+ def list_schedules(self, compartment_id, **kwargs):
1806
+ """
1807
+ Returns the saved schedule list.
1808
+
1809
+
1810
+ :param str compartment_id: (required)
1811
+ The compartment ID in which to list resources.
1812
+
1813
+ :param str opc_request_id: (optional)
1814
+ Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
1815
+ particular request, please provide the request ID.
1816
+
1817
+ :param str page: (optional)
1818
+ The page token representing the page at which to start retrieving results.
1819
+ This is usually retrieved from a previous list call.
1820
+
1821
+ :param int limit: (optional)
1822
+ The maximumimum number of items to return.
1823
+
1824
+ :param str sort_by: (optional)
1825
+ The field to sort by. If not specified, the default is timeCreated.
1826
+
1827
+ Allowed values are: "name", "timeCreated"
1828
+
1829
+ :param str sort_order: (optional)
1830
+ The sort order to use, whether 'asc' or 'desc'.
1831
+
1832
+ Allowed values are: "ASC", "DESC"
1833
+
1834
+ :param str name: (optional)
1835
+ Query parameter for filtering by name
1836
+
1837
+ :param obj retry_strategy: (optional)
1838
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1839
+
1840
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
1841
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1842
+
1843
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1844
+
1845
+ :param bool allow_control_chars: (optional)
1846
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1847
+ By default, the response will not allow control characters in strings
1848
+
1849
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.ScheduleCollection`
1850
+ :rtype: :class:`~oci.response.Response`
1851
+
1852
+ :example:
1853
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/list_schedules.py.html>`__ to see an example of how to use list_schedules API.
1854
+ """
1855
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1856
+ required_arguments = ['compartmentId']
1857
+ resource_path = "/schedules"
1858
+ method = "GET"
1859
+ operation_name = "list_schedules"
1860
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/Schedule/ListSchedules"
1861
+
1862
+ # Don't accept unknown kwargs
1863
+ expected_kwargs = [
1864
+ "allow_control_chars",
1865
+ "retry_strategy",
1866
+ "opc_request_id",
1867
+ "page",
1868
+ "limit",
1869
+ "sort_by",
1870
+ "sort_order",
1871
+ "name"
1872
+ ]
1873
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1874
+ if extra_kwargs:
1875
+ raise ValueError(
1876
+ f"list_schedules got unknown kwargs: {extra_kwargs!r}")
1877
+
1878
+ if 'sort_by' in kwargs:
1879
+ sort_by_allowed_values = ["name", "timeCreated"]
1880
+ if kwargs['sort_by'] not in sort_by_allowed_values:
1881
+ raise ValueError(
1882
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
1883
+ )
1884
+
1885
+ if 'sort_order' in kwargs:
1886
+ sort_order_allowed_values = ["ASC", "DESC"]
1887
+ if kwargs['sort_order'] not in sort_order_allowed_values:
1888
+ raise ValueError(
1889
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
1890
+ )
1891
+
1892
+ query_params = {
1893
+ "compartmentId": compartment_id,
1894
+ "page": kwargs.get("page", missing),
1895
+ "limit": kwargs.get("limit", missing),
1896
+ "sortBy": kwargs.get("sort_by", missing),
1897
+ "sortOrder": kwargs.get("sort_order", missing),
1898
+ "name": kwargs.get("name", missing)
1899
+ }
1900
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
1901
+
1902
+ header_params = {
1903
+ "accept": "application/json",
1904
+ "content-type": "application/json",
1905
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1906
+ }
1907
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1908
+
1909
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1910
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1911
+ client_retry_strategy=self.retry_strategy
1912
+ )
1913
+
1914
+ if retry_strategy:
1915
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1916
+ self.base_client.add_opc_client_retries_header(header_params)
1917
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1918
+ return retry_strategy.make_retrying_call(
1919
+ self.base_client.call_api,
1920
+ resource_path=resource_path,
1921
+ method=method,
1922
+ query_params=query_params,
1923
+ header_params=header_params,
1924
+ response_type="ScheduleCollection",
1925
+ allow_control_chars=kwargs.get('allow_control_chars'),
1926
+ operation_name=operation_name,
1927
+ api_reference_link=api_reference_link,
1928
+ required_arguments=required_arguments)
1929
+ else:
1930
+ return self.base_client.call_api(
1931
+ resource_path=resource_path,
1932
+ method=method,
1933
+ query_params=query_params,
1934
+ header_params=header_params,
1935
+ response_type="ScheduleCollection",
1936
+ allow_control_chars=kwargs.get('allow_control_chars'),
1937
+ operation_name=operation_name,
1938
+ api_reference_link=api_reference_link,
1939
+ required_arguments=required_arguments)
1940
+
1941
+ def list_usage_carbon_emissions_queries(self, compartment_id, **kwargs):
1942
+ """
1943
+ Returns the usage carbon emissions saved query list.
1944
+
1945
+
1946
+ :param str compartment_id: (required)
1947
+ The compartment ID in which to list resources.
1948
+
1949
+ :param str opc_request_id: (optional)
1950
+ Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
1951
+ particular request, please provide the request ID.
1952
+
1953
+ :param int limit: (optional)
1954
+ The maximumimum number of items to return.
1955
+
1956
+ :param str page: (optional)
1957
+ The page token representing the page at which to start retrieving results.
1958
+ This is usually retrieved from a previous list call.
1959
+
1960
+ :param str sort_by: (optional)
1961
+ The field to sort by. If not specified, the default is displayName.
1962
+
1963
+ Allowed values are: "displayName"
1964
+
1965
+ :param str sort_order: (optional)
1966
+ The sort order to use, whether 'asc' or 'desc'.
1967
+
1968
+ Allowed values are: "ASC", "DESC"
1969
+
1970
+ :param obj retry_strategy: (optional)
1971
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1972
+
1973
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
1974
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1975
+
1976
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1977
+
1978
+ :param bool allow_control_chars: (optional)
1979
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1980
+ By default, the response will not allow control characters in strings
1981
+
1982
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.UsageCarbonEmissionsQueryCollection`
1983
+ :rtype: :class:`~oci.response.Response`
1984
+
1985
+ :example:
1986
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/list_usage_carbon_emissions_queries.py.html>`__ to see an example of how to use list_usage_carbon_emissions_queries API.
1987
+ """
1988
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1989
+ required_arguments = ['compartmentId']
1990
+ resource_path = "/usageCarbonEmissionsQueries"
1991
+ method = "GET"
1992
+ operation_name = "list_usage_carbon_emissions_queries"
1993
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/UsageCarbonEmissionsQuery/ListUsageCarbonEmissionsQueries"
1994
+
1995
+ # Don't accept unknown kwargs
1996
+ expected_kwargs = [
1997
+ "allow_control_chars",
1998
+ "retry_strategy",
1999
+ "opc_request_id",
2000
+ "limit",
2001
+ "page",
2002
+ "sort_by",
2003
+ "sort_order"
2004
+ ]
2005
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2006
+ if extra_kwargs:
2007
+ raise ValueError(
2008
+ f"list_usage_carbon_emissions_queries got unknown kwargs: {extra_kwargs!r}")
2009
+
2010
+ if 'sort_by' in kwargs:
2011
+ sort_by_allowed_values = ["displayName"]
2012
+ if kwargs['sort_by'] not in sort_by_allowed_values:
2013
+ raise ValueError(
2014
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
2015
+ )
2016
+
2017
+ if 'sort_order' in kwargs:
2018
+ sort_order_allowed_values = ["ASC", "DESC"]
2019
+ if kwargs['sort_order'] not in sort_order_allowed_values:
2020
+ raise ValueError(
2021
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
2022
+ )
2023
+
2024
+ query_params = {
2025
+ "limit": kwargs.get("limit", missing),
2026
+ "page": kwargs.get("page", missing),
2027
+ "compartmentId": compartment_id,
2028
+ "sortBy": kwargs.get("sort_by", missing),
2029
+ "sortOrder": kwargs.get("sort_order", missing)
2030
+ }
2031
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
2032
+
2033
+ header_params = {
2034
+ "accept": "application/json",
2035
+ "content-type": "application/json",
2036
+ "opc-request-id": kwargs.get("opc_request_id", missing)
2037
+ }
2038
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
2039
+
2040
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
2041
+ operation_retry_strategy=kwargs.get('retry_strategy'),
2042
+ client_retry_strategy=self.retry_strategy
2043
+ )
2044
+
2045
+ if retry_strategy:
2046
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
2047
+ self.base_client.add_opc_client_retries_header(header_params)
2048
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
2049
+ return retry_strategy.make_retrying_call(
2050
+ self.base_client.call_api,
2051
+ resource_path=resource_path,
2052
+ method=method,
2053
+ query_params=query_params,
2054
+ header_params=header_params,
2055
+ response_type="UsageCarbonEmissionsQueryCollection",
2056
+ allow_control_chars=kwargs.get('allow_control_chars'),
2057
+ operation_name=operation_name,
2058
+ api_reference_link=api_reference_link,
2059
+ required_arguments=required_arguments)
2060
+ else:
2061
+ return self.base_client.call_api(
2062
+ resource_path=resource_path,
2063
+ method=method,
2064
+ query_params=query_params,
2065
+ header_params=header_params,
2066
+ response_type="UsageCarbonEmissionsQueryCollection",
2067
+ allow_control_chars=kwargs.get('allow_control_chars'),
2068
+ operation_name=operation_name,
2069
+ api_reference_link=api_reference_link,
2070
+ required_arguments=required_arguments)
2071
+
2072
+ def request_average_carbon_emission(self, sku_part_number, **kwargs):
2073
+ """
2074
+ Returns the average carbon emissions summary by SKU.
2075
+
2076
+
2077
+ :param str sku_part_number: (required)
2078
+ The SKU part number.
2079
+
2080
+ :param str opc_request_id: (optional)
2081
+ Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
2082
+ particular request, please provide the request ID.
2083
+
2084
+ :param obj retry_strategy: (optional)
2085
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
2086
+
2087
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
2088
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
2089
+
2090
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
2091
+
2092
+ :param bool allow_control_chars: (optional)
2093
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2094
+ By default, the response will not allow control characters in strings
2095
+
2096
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.AverageCarbonEmission`
2097
+ :rtype: :class:`~oci.response.Response`
2098
+
2099
+ :example:
2100
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/request_average_carbon_emission.py.html>`__ to see an example of how to use request_average_carbon_emission API.
2101
+ """
2102
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2103
+ required_arguments = ['skuPartNumber']
2104
+ resource_path = "/averageCarbonEmissions/{skuPartNumber}"
2105
+ method = "GET"
2106
+ operation_name = "request_average_carbon_emission"
2107
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/AverageCarbonEmission/RequestAverageCarbonEmission"
2108
+
2109
+ # Don't accept unknown kwargs
2110
+ expected_kwargs = [
2111
+ "allow_control_chars",
2112
+ "retry_strategy",
2113
+ "opc_request_id"
2114
+ ]
2115
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2116
+ if extra_kwargs:
2117
+ raise ValueError(
2118
+ f"request_average_carbon_emission got unknown kwargs: {extra_kwargs!r}")
2119
+
2120
+ path_params = {
2121
+ "skuPartNumber": sku_part_number
2122
+ }
2123
+
2124
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
2125
+
2126
+ for (k, v) in six.iteritems(path_params):
2127
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
2128
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
2129
+
2130
+ header_params = {
2131
+ "accept": "application/json",
2132
+ "content-type": "application/json",
2133
+ "opc-request-id": kwargs.get("opc_request_id", missing)
2134
+ }
2135
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
2136
+
2137
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
2138
+ operation_retry_strategy=kwargs.get('retry_strategy'),
2139
+ client_retry_strategy=self.retry_strategy
2140
+ )
2141
+
2142
+ if retry_strategy:
2143
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
2144
+ self.base_client.add_opc_client_retries_header(header_params)
2145
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
2146
+ return retry_strategy.make_retrying_call(
2147
+ self.base_client.call_api,
2148
+ resource_path=resource_path,
2149
+ method=method,
2150
+ path_params=path_params,
2151
+ header_params=header_params,
2152
+ response_type="AverageCarbonEmission",
2153
+ allow_control_chars=kwargs.get('allow_control_chars'),
2154
+ operation_name=operation_name,
2155
+ api_reference_link=api_reference_link,
2156
+ required_arguments=required_arguments)
2157
+ else:
2158
+ return self.base_client.call_api(
2159
+ resource_path=resource_path,
2160
+ method=method,
2161
+ path_params=path_params,
2162
+ header_params=header_params,
2163
+ response_type="AverageCarbonEmission",
2164
+ allow_control_chars=kwargs.get('allow_control_chars'),
2165
+ operation_name=operation_name,
2166
+ api_reference_link=api_reference_link,
2167
+ required_arguments=required_arguments)
2168
+
2169
+ def request_clean_energy_usage(self, region, **kwargs):
2170
+ """
2171
+ Returns the clean energy usage summary by region.
2172
+
2173
+
2174
+ :param str region: (required)
2175
+ The region.
2176
+
2177
+ :param str ad: (optional)
2178
+ The availability domain.
2179
+
2180
+ :param str opc_request_id: (optional)
2181
+ Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
2182
+ particular request, please provide the request ID.
2183
+
2184
+ :param obj retry_strategy: (optional)
2185
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
2186
+
2187
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
2188
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
2189
+
2190
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
2191
+
2192
+ :param bool allow_control_chars: (optional)
2193
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2194
+ By default, the response will not allow control characters in strings
2195
+
2196
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.CleanEnergyUsage`
2197
+ :rtype: :class:`~oci.response.Response`
2198
+
2199
+ :example:
2200
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/request_clean_energy_usage.py.html>`__ to see an example of how to use request_clean_energy_usage API.
2201
+ """
2202
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2203
+ required_arguments = ['region']
2204
+ resource_path = "/cleanEnergyUsages/{region}"
2205
+ method = "GET"
2206
+ operation_name = "request_clean_energy_usage"
2207
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/CleanEnergyUsage/RequestCleanEnergyUsage"
2208
+
2209
+ # Don't accept unknown kwargs
2210
+ expected_kwargs = [
2211
+ "allow_control_chars",
2212
+ "retry_strategy",
2213
+ "ad",
2214
+ "opc_request_id"
2215
+ ]
2216
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2217
+ if extra_kwargs:
2218
+ raise ValueError(
2219
+ f"request_clean_energy_usage got unknown kwargs: {extra_kwargs!r}")
2220
+
2221
+ path_params = {
2222
+ "region": region
2223
+ }
2224
+
2225
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
2226
+
2227
+ for (k, v) in six.iteritems(path_params):
2228
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
2229
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
2230
+
2231
+ query_params = {
2232
+ "ad": kwargs.get("ad", missing)
1334
2233
  }
1335
2234
  query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
1336
2235
 
@@ -1354,9 +2253,10 @@ class UsageapiClient(object):
1354
2253
  self.base_client.call_api,
1355
2254
  resource_path=resource_path,
1356
2255
  method=method,
2256
+ path_params=path_params,
1357
2257
  query_params=query_params,
1358
2258
  header_params=header_params,
1359
- response_type="QueryCollection",
2259
+ response_type="CleanEnergyUsage",
1360
2260
  allow_control_chars=kwargs.get('allow_control_chars'),
1361
2261
  operation_name=operation_name,
1362
2262
  api_reference_link=api_reference_link,
@@ -1365,43 +2265,27 @@ class UsageapiClient(object):
1365
2265
  return self.base_client.call_api(
1366
2266
  resource_path=resource_path,
1367
2267
  method=method,
2268
+ path_params=path_params,
1368
2269
  query_params=query_params,
1369
2270
  header_params=header_params,
1370
- response_type="QueryCollection",
2271
+ response_type="CleanEnergyUsage",
1371
2272
  allow_control_chars=kwargs.get('allow_control_chars'),
1372
2273
  operation_name=operation_name,
1373
2274
  api_reference_link=api_reference_link,
1374
2275
  required_arguments=required_arguments)
1375
2276
 
1376
- def list_scheduled_runs(self, schedule_id, **kwargs):
2277
+ def request_summarized_configurations(self, tenant_id, **kwargs):
1377
2278
  """
1378
- Returns schedule history list.
2279
+ Returns the configurations list for the UI drop-down list.
1379
2280
 
1380
2281
 
1381
- :param str schedule_id: (required)
1382
- The unique ID of a schedule.
2282
+ :param str tenant_id: (required)
2283
+ tenant id
1383
2284
 
1384
2285
  :param str opc_request_id: (optional)
1385
2286
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
1386
2287
  particular request, please provide the request ID.
1387
2288
 
1388
- :param str page: (optional)
1389
- The page token representing the page at which to start retrieving results.
1390
- This is usually retrieved from a previous list call.
1391
-
1392
- :param int limit: (optional)
1393
- The maximumimum number of items to return.
1394
-
1395
- :param str sort_by: (optional)
1396
- The field to sort by. If not specified, the default is timeCreated.
1397
-
1398
- Allowed values are: "timeCreated"
1399
-
1400
- :param str sort_order: (optional)
1401
- The sort order to use, whether 'asc' or 'desc'.
1402
-
1403
- Allowed values are: "ASC", "DESC"
1404
-
1405
2289
  :param obj retry_strategy: (optional)
1406
2290
  A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1407
2291
 
@@ -1414,54 +2298,32 @@ class UsageapiClient(object):
1414
2298
  allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1415
2299
  By default, the response will not allow control characters in strings
1416
2300
 
1417
- :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.ScheduledRunCollection`
2301
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.ConfigurationAggregation`
1418
2302
  :rtype: :class:`~oci.response.Response`
1419
2303
 
1420
2304
  :example:
1421
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/list_scheduled_runs.py.html>`__ to see an example of how to use list_scheduled_runs API.
2305
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/request_summarized_configurations.py.html>`__ to see an example of how to use request_summarized_configurations API.
1422
2306
  """
1423
2307
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1424
- required_arguments = ['scheduleId']
1425
- resource_path = "/scheduledRuns"
2308
+ required_arguments = ['tenantId']
2309
+ resource_path = "/configuration"
1426
2310
  method = "GET"
1427
- operation_name = "list_scheduled_runs"
1428
- api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/ScheduledRun/ListScheduledRuns"
2311
+ operation_name = "request_summarized_configurations"
2312
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/Configuration/RequestSummarizedConfigurations"
1429
2313
 
1430
2314
  # Don't accept unknown kwargs
1431
2315
  expected_kwargs = [
1432
2316
  "allow_control_chars",
1433
2317
  "retry_strategy",
1434
- "opc_request_id",
1435
- "page",
1436
- "limit",
1437
- "sort_by",
1438
- "sort_order"
2318
+ "opc_request_id"
1439
2319
  ]
1440
2320
  extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1441
2321
  if extra_kwargs:
1442
2322
  raise ValueError(
1443
- f"list_scheduled_runs got unknown kwargs: {extra_kwargs!r}")
1444
-
1445
- if 'sort_by' in kwargs:
1446
- sort_by_allowed_values = ["timeCreated"]
1447
- if kwargs['sort_by'] not in sort_by_allowed_values:
1448
- raise ValueError(
1449
- f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
1450
- )
1451
-
1452
- if 'sort_order' in kwargs:
1453
- sort_order_allowed_values = ["ASC", "DESC"]
1454
- if kwargs['sort_order'] not in sort_order_allowed_values:
1455
- raise ValueError(
1456
- f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
1457
- )
2323
+ f"request_summarized_configurations got unknown kwargs: {extra_kwargs!r}")
1458
2324
 
1459
2325
  query_params = {
1460
- "page": kwargs.get("page", missing),
1461
- "limit": kwargs.get("limit", missing),
1462
- "scheduleId": schedule_id,
1463
- "sortBy": kwargs.get("sort_by", missing),
1464
- "sortOrder": kwargs.get("sort_order", missing)
2326
+ "tenantId": tenant_id
1465
2327
  }
1466
2328
  query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
1467
2329
 
@@ -1487,7 +2349,7 @@ class UsageapiClient(object):
1487
2349
  method=method,
1488
2350
  query_params=query_params,
1489
2351
  header_params=header_params,
1490
- response_type="ScheduledRunCollection",
2352
+ response_type="ConfigurationAggregation",
1491
2353
  allow_control_chars=kwargs.get('allow_control_chars'),
1492
2354
  operation_name=operation_name,
1493
2355
  api_reference_link=api_reference_link,
@@ -1498,19 +2360,19 @@ class UsageapiClient(object):
1498
2360
  method=method,
1499
2361
  query_params=query_params,
1500
2362
  header_params=header_params,
1501
- response_type="ScheduledRunCollection",
2363
+ response_type="ConfigurationAggregation",
1502
2364
  allow_control_chars=kwargs.get('allow_control_chars'),
1503
2365
  operation_name=operation_name,
1504
2366
  api_reference_link=api_reference_link,
1505
2367
  required_arguments=required_arguments)
1506
2368
 
1507
- def list_schedules(self, compartment_id, **kwargs):
2369
+ def request_summarized_usages(self, request_summarized_usages_details, **kwargs):
1508
2370
  """
1509
- Returns the saved schedule list.
2371
+ Returns usage for the given account.
1510
2372
 
1511
2373
 
1512
- :param str compartment_id: (required)
1513
- The compartment ID in which to list resources.
2374
+ :param oci.usage_api.models.RequestSummarizedUsagesDetails request_summarized_usages_details: (required)
2375
+ getUsageRequest contains query inforamtion.
1514
2376
 
1515
2377
  :param str opc_request_id: (optional)
1516
2378
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
@@ -1523,19 +2385,6 @@ class UsageapiClient(object):
1523
2385
  :param int limit: (optional)
1524
2386
  The maximumimum number of items to return.
1525
2387
 
1526
- :param str sort_by: (optional)
1527
- The field to sort by. If not specified, the default is timeCreated.
1528
-
1529
- Allowed values are: "name", "timeCreated"
1530
-
1531
- :param str sort_order: (optional)
1532
- The sort order to use, whether 'asc' or 'desc'.
1533
-
1534
- Allowed values are: "ASC", "DESC"
1535
-
1536
- :param str name: (optional)
1537
- Query parameter for filtering by name
1538
-
1539
2388
  :param obj retry_strategy: (optional)
1540
2389
  A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1541
2390
 
@@ -1548,18 +2397,18 @@ class UsageapiClient(object):
1548
2397
  allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1549
2398
  By default, the response will not allow control characters in strings
1550
2399
 
1551
- :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.ScheduleCollection`
2400
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.UsageAggregation`
1552
2401
  :rtype: :class:`~oci.response.Response`
1553
2402
 
1554
2403
  :example:
1555
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/list_schedules.py.html>`__ to see an example of how to use list_schedules API.
2404
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/request_summarized_usages.py.html>`__ to see an example of how to use request_summarized_usages API.
1556
2405
  """
1557
2406
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1558
- required_arguments = ['compartmentId']
1559
- resource_path = "/schedules"
1560
- method = "GET"
1561
- operation_name = "list_schedules"
1562
- api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/Schedule/ListSchedules"
2407
+ required_arguments = []
2408
+ resource_path = "/usage"
2409
+ method = "POST"
2410
+ operation_name = "request_summarized_usages"
2411
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/UsageSummary/RequestSummarizedUsages"
1563
2412
 
1564
2413
  # Don't accept unknown kwargs
1565
2414
  expected_kwargs = [
@@ -1567,37 +2416,16 @@ class UsageapiClient(object):
1567
2416
  "retry_strategy",
1568
2417
  "opc_request_id",
1569
2418
  "page",
1570
- "limit",
1571
- "sort_by",
1572
- "sort_order",
1573
- "name"
2419
+ "limit"
1574
2420
  ]
1575
2421
  extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1576
2422
  if extra_kwargs:
1577
2423
  raise ValueError(
1578
- f"list_schedules got unknown kwargs: {extra_kwargs!r}")
1579
-
1580
- if 'sort_by' in kwargs:
1581
- sort_by_allowed_values = ["name", "timeCreated"]
1582
- if kwargs['sort_by'] not in sort_by_allowed_values:
1583
- raise ValueError(
1584
- f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
1585
- )
1586
-
1587
- if 'sort_order' in kwargs:
1588
- sort_order_allowed_values = ["ASC", "DESC"]
1589
- if kwargs['sort_order'] not in sort_order_allowed_values:
1590
- raise ValueError(
1591
- f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
1592
- )
2424
+ f"request_summarized_usages got unknown kwargs: {extra_kwargs!r}")
1593
2425
 
1594
2426
  query_params = {
1595
- "compartmentId": compartment_id,
1596
2427
  "page": kwargs.get("page", missing),
1597
- "limit": kwargs.get("limit", missing),
1598
- "sortBy": kwargs.get("sort_by", missing),
1599
- "sortOrder": kwargs.get("sort_order", missing),
1600
- "name": kwargs.get("name", missing)
2428
+ "limit": kwargs.get("limit", missing)
1601
2429
  }
1602
2430
  query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
1603
2431
 
@@ -1623,7 +2451,8 @@ class UsageapiClient(object):
1623
2451
  method=method,
1624
2452
  query_params=query_params,
1625
2453
  header_params=header_params,
1626
- response_type="ScheduleCollection",
2454
+ body=request_summarized_usages_details,
2455
+ response_type="UsageAggregation",
1627
2456
  allow_control_chars=kwargs.get('allow_control_chars'),
1628
2457
  operation_name=operation_name,
1629
2458
  api_reference_link=api_reference_link,
@@ -1634,15 +2463,16 @@ class UsageapiClient(object):
1634
2463
  method=method,
1635
2464
  query_params=query_params,
1636
2465
  header_params=header_params,
1637
- response_type="ScheduleCollection",
2466
+ body=request_summarized_usages_details,
2467
+ response_type="UsageAggregation",
1638
2468
  allow_control_chars=kwargs.get('allow_control_chars'),
1639
2469
  operation_name=operation_name,
1640
2470
  api_reference_link=api_reference_link,
1641
2471
  required_arguments=required_arguments)
1642
2472
 
1643
- def request_summarized_configurations(self, tenant_id, **kwargs):
2473
+ def request_usage_carbon_emission_config(self, tenant_id, **kwargs):
1644
2474
  """
1645
- Returns the configurations list for the UI drop-down list.
2475
+ Returns the configuration list for the UI drop-down list of carbon emission console.
1646
2476
 
1647
2477
 
1648
2478
  :param str tenant_id: (required)
@@ -1668,14 +2498,14 @@ class UsageapiClient(object):
1668
2498
  :rtype: :class:`~oci.response.Response`
1669
2499
 
1670
2500
  :example:
1671
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/request_summarized_configurations.py.html>`__ to see an example of how to use request_summarized_configurations API.
2501
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/request_usage_carbon_emission_config.py.html>`__ to see an example of how to use request_usage_carbon_emission_config API.
1672
2502
  """
1673
2503
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1674
2504
  required_arguments = ['tenantId']
1675
- resource_path = "/configuration"
2505
+ resource_path = "/usageCarbonEmissionsConfig"
1676
2506
  method = "GET"
1677
- operation_name = "request_summarized_configurations"
1678
- api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/Configuration/RequestSummarizedConfigurations"
2507
+ operation_name = "request_usage_carbon_emission_config"
2508
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/Configuration/RequestUsageCarbonEmissionConfig"
1679
2509
 
1680
2510
  # Don't accept unknown kwargs
1681
2511
  expected_kwargs = [
@@ -1686,7 +2516,7 @@ class UsageapiClient(object):
1686
2516
  extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1687
2517
  if extra_kwargs:
1688
2518
  raise ValueError(
1689
- f"request_summarized_configurations got unknown kwargs: {extra_kwargs!r}")
2519
+ f"request_usage_carbon_emission_config got unknown kwargs: {extra_kwargs!r}")
1690
2520
 
1691
2521
  query_params = {
1692
2522
  "tenantId": tenant_id
@@ -1732,13 +2562,13 @@ class UsageapiClient(object):
1732
2562
  api_reference_link=api_reference_link,
1733
2563
  required_arguments=required_arguments)
1734
2564
 
1735
- def request_summarized_usages(self, request_summarized_usages_details, **kwargs):
2565
+ def request_usage_carbon_emissions(self, request_usage_carbon_emissions_details, **kwargs):
1736
2566
  """
1737
- Returns usage for the given account.
2567
+ Returns usage carbon emission for the given account.
1738
2568
 
1739
2569
 
1740
- :param oci.usage_api.models.RequestSummarizedUsagesDetails request_summarized_usages_details: (required)
1741
- getUsageRequest contains query inforamtion.
2570
+ :param oci.usage_api.models.RequestUsageCarbonEmissionsDetails request_usage_carbon_emissions_details: (required)
2571
+ getUsageCarbonEmissionRequest contains query inforamtion.
1742
2572
 
1743
2573
  :param str opc_request_id: (optional)
1744
2574
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
@@ -1763,18 +2593,18 @@ class UsageapiClient(object):
1763
2593
  allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1764
2594
  By default, the response will not allow control characters in strings
1765
2595
 
1766
- :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.UsageAggregation`
2596
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.UsageCarbonEmissionAggregation`
1767
2597
  :rtype: :class:`~oci.response.Response`
1768
2598
 
1769
2599
  :example:
1770
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/request_summarized_usages.py.html>`__ to see an example of how to use request_summarized_usages API.
2600
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/request_usage_carbon_emissions.py.html>`__ to see an example of how to use request_usage_carbon_emissions API.
1771
2601
  """
1772
2602
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1773
2603
  required_arguments = []
1774
- resource_path = "/usage"
2604
+ resource_path = "/usageCarbonEmissions"
1775
2605
  method = "POST"
1776
- operation_name = "request_summarized_usages"
1777
- api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/UsageSummary/RequestSummarizedUsages"
2606
+ operation_name = "request_usage_carbon_emissions"
2607
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/UsageCarbonEmissionSummary/RequestUsageCarbonEmissions"
1778
2608
 
1779
2609
  # Don't accept unknown kwargs
1780
2610
  expected_kwargs = [
@@ -1787,7 +2617,7 @@ class UsageapiClient(object):
1787
2617
  extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1788
2618
  if extra_kwargs:
1789
2619
  raise ValueError(
1790
- f"request_summarized_usages got unknown kwargs: {extra_kwargs!r}")
2620
+ f"request_usage_carbon_emissions got unknown kwargs: {extra_kwargs!r}")
1791
2621
 
1792
2622
  query_params = {
1793
2623
  "page": kwargs.get("page", missing),
@@ -1817,8 +2647,8 @@ class UsageapiClient(object):
1817
2647
  method=method,
1818
2648
  query_params=query_params,
1819
2649
  header_params=header_params,
1820
- body=request_summarized_usages_details,
1821
- response_type="UsageAggregation",
2650
+ body=request_usage_carbon_emissions_details,
2651
+ response_type="UsageCarbonEmissionAggregation",
1822
2652
  allow_control_chars=kwargs.get('allow_control_chars'),
1823
2653
  operation_name=operation_name,
1824
2654
  api_reference_link=api_reference_link,
@@ -1829,8 +2659,8 @@ class UsageapiClient(object):
1829
2659
  method=method,
1830
2660
  query_params=query_params,
1831
2661
  header_params=header_params,
1832
- body=request_summarized_usages_details,
1833
- response_type="UsageAggregation",
2662
+ body=request_usage_carbon_emissions_details,
2663
+ response_type="UsageCarbonEmissionAggregation",
1834
2664
  allow_control_chars=kwargs.get('allow_control_chars'),
1835
2665
  operation_name=operation_name,
1836
2666
  api_reference_link=api_reference_link,
@@ -1874,7 +2704,7 @@ class UsageapiClient(object):
1874
2704
  :rtype: :class:`~oci.response.Response`
1875
2705
 
1876
2706
  :example:
1877
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/update_custom_table.py.html>`__ to see an example of how to use update_custom_table API.
2707
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/update_custom_table.py.html>`__ to see an example of how to use update_custom_table API.
1878
2708
  """
1879
2709
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1880
2710
  required_arguments = ['customTableId']
@@ -1985,7 +2815,7 @@ class UsageapiClient(object):
1985
2815
  :rtype: :class:`~oci.response.Response`
1986
2816
 
1987
2817
  :example:
1988
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/update_query.py.html>`__ to see an example of how to use update_query API.
2818
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/update_query.py.html>`__ to see an example of how to use update_query API.
1989
2819
  """
1990
2820
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1991
2821
  required_arguments = ['queryId']
@@ -2096,7 +2926,7 @@ class UsageapiClient(object):
2096
2926
  :rtype: :class:`~oci.response.Response`
2097
2927
 
2098
2928
  :example:
2099
- Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/usageapi/update_schedule.py.html>`__ to see an example of how to use update_schedule API.
2929
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/update_schedule.py.html>`__ to see an example of how to use update_schedule API.
2100
2930
  """
2101
2931
  # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2102
2932
  required_arguments = ['scheduleId']
@@ -2168,3 +2998,114 @@ class UsageapiClient(object):
2168
2998
  operation_name=operation_name,
2169
2999
  api_reference_link=api_reference_link,
2170
3000
  required_arguments=required_arguments)
3001
+
3002
+ def update_usage_carbon_emissions_query(self, update_usage_carbon_emissions_query_details, usage_carbon_emissions_query_id, **kwargs):
3003
+ """
3004
+ Update a usage carbon emissions saved query by the OCID.
3005
+
3006
+
3007
+ :param oci.usage_api.models.UpdateUsageCarbonEmissionsQueryDetails update_usage_carbon_emissions_query_details: (required)
3008
+ The information to be updated.
3009
+
3010
+ :param str usage_carbon_emissions_query_id: (required)
3011
+ The query unique OCID.
3012
+
3013
+ :param str opc_request_id: (optional)
3014
+ Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
3015
+ particular request, please provide the request ID.
3016
+
3017
+ :param str if_match: (optional)
3018
+ For optimistic concurrency control. In the PUT or DELETE call
3019
+ for a resource, set the `if-match` parameter to the value of the
3020
+ etag from a previous GET or POST response for that resource.
3021
+ The resource will be updated or deleted, only if the etag you
3022
+ provide matches the resource's current etag value.
3023
+
3024
+ :param obj retry_strategy: (optional)
3025
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
3026
+
3027
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
3028
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
3029
+
3030
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
3031
+
3032
+ :param bool allow_control_chars: (optional)
3033
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
3034
+ By default, the response will not allow control characters in strings
3035
+
3036
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.usage_api.models.UsageCarbonEmissionsQuery`
3037
+ :rtype: :class:`~oci.response.Response`
3038
+
3039
+ :example:
3040
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/usageapi/update_usage_carbon_emissions_query.py.html>`__ to see an example of how to use update_usage_carbon_emissions_query API.
3041
+ """
3042
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3043
+ required_arguments = ['usageCarbonEmissionsQueryId']
3044
+ resource_path = "/usageCarbonEmissionsQueries/{usageCarbonEmissionsQueryId}"
3045
+ method = "PUT"
3046
+ operation_name = "update_usage_carbon_emissions_query"
3047
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/usage/20200107/UsageCarbonEmissionsQuery/UpdateUsageCarbonEmissionsQuery"
3048
+
3049
+ # Don't accept unknown kwargs
3050
+ expected_kwargs = [
3051
+ "allow_control_chars",
3052
+ "retry_strategy",
3053
+ "opc_request_id",
3054
+ "if_match"
3055
+ ]
3056
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
3057
+ if extra_kwargs:
3058
+ raise ValueError(
3059
+ f"update_usage_carbon_emissions_query got unknown kwargs: {extra_kwargs!r}")
3060
+
3061
+ path_params = {
3062
+ "usageCarbonEmissionsQueryId": usage_carbon_emissions_query_id
3063
+ }
3064
+
3065
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
3066
+
3067
+ for (k, v) in six.iteritems(path_params):
3068
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
3069
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
3070
+
3071
+ header_params = {
3072
+ "accept": "application/json",
3073
+ "content-type": "application/json",
3074
+ "opc-request-id": kwargs.get("opc_request_id", missing),
3075
+ "if-match": kwargs.get("if_match", missing)
3076
+ }
3077
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
3078
+
3079
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
3080
+ operation_retry_strategy=kwargs.get('retry_strategy'),
3081
+ client_retry_strategy=self.retry_strategy
3082
+ )
3083
+
3084
+ if retry_strategy:
3085
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
3086
+ self.base_client.add_opc_client_retries_header(header_params)
3087
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
3088
+ return retry_strategy.make_retrying_call(
3089
+ self.base_client.call_api,
3090
+ resource_path=resource_path,
3091
+ method=method,
3092
+ path_params=path_params,
3093
+ header_params=header_params,
3094
+ body=update_usage_carbon_emissions_query_details,
3095
+ response_type="UsageCarbonEmissionsQuery",
3096
+ allow_control_chars=kwargs.get('allow_control_chars'),
3097
+ operation_name=operation_name,
3098
+ api_reference_link=api_reference_link,
3099
+ required_arguments=required_arguments)
3100
+ else:
3101
+ return self.base_client.call_api(
3102
+ resource_path=resource_path,
3103
+ method=method,
3104
+ path_params=path_params,
3105
+ header_params=header_params,
3106
+ body=update_usage_carbon_emissions_query_details,
3107
+ response_type="UsageCarbonEmissionsQuery",
3108
+ allow_control_chars=kwargs.get('allow_control_chars'),
3109
+ operation_name=operation_name,
3110
+ api_reference_link=api_reference_link,
3111
+ required_arguments=required_arguments)