oci 2.115.1__py3-none-any.whl → 2.117.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 (593) hide show
  1. oci/__init__.py +2 -2
  2. oci/access_governance_cp/access_governance_cp_client.py +8 -8
  3. oci/adm/application_dependency_management_client.py +41 -41
  4. oci/adm/models/__init__.py +4 -0
  5. oci/adm/models/create_vulnerability_audit_details.py +27 -0
  6. oci/adm/models/usage_data_details.py +92 -0
  7. oci/adm/models/usage_data_via_object_storage_tuple_details.py +143 -0
  8. oci/adm/models/vulnerability.py +33 -2
  9. oci/adm/models/vulnerability_audit.py +86 -0
  10. oci/adm/models/work_request_summary.py +35 -2
  11. oci/ai_anomaly_detection/anomaly_detection_client.py +36 -36
  12. oci/ai_document/ai_service_document_client.py +22 -22
  13. oci/ai_language/ai_service_language_client.py +36 -36
  14. oci/ai_speech/ai_service_speech_client.py +9 -9
  15. oci/ai_speech/models/__init__.py +4 -0
  16. oci/ai_speech/models/create_transcription_job_details.py +4 -4
  17. oci/ai_speech/models/diarization.py +103 -0
  18. oci/ai_speech/models/transcription_job.py +6 -6
  19. oci/ai_speech/models/transcription_job_summary.py +6 -6
  20. oci/ai_speech/models/transcription_model_details.py +29 -2
  21. oci/ai_speech/models/transcription_settings.py +68 -0
  22. oci/ai_speech/models/update_transcription_job_details.py +4 -4
  23. oci/ai_vision/ai_service_vision_client.py +25 -25
  24. oci/analytics/analytics_client.py +23 -23
  25. oci/announcements_service/announcement_client.py +4 -4
  26. oci/announcements_service/announcement_subscription_client.py +9 -9
  27. oci/announcements_service/announcements_preferences_client.py +4 -4
  28. oci/apigateway/api_gateway_client.py +21 -21
  29. oci/apigateway/deployment_client.py +6 -6
  30. oci/apigateway/gateway_client.py +6 -6
  31. oci/apigateway/subscribers_client.py +6 -6
  32. oci/apigateway/usage_plans_client.py +6 -6
  33. oci/apigateway/work_requests_client.py +5 -5
  34. oci/apm_config/config_client.py +8 -8
  35. oci/apm_control_plane/apm_domain_client.py +14 -14
  36. oci/apm_synthetics/apm_synthetic_client.py +18 -18
  37. oci/apm_traces/query_client.py +2 -2
  38. oci/apm_traces/trace_client.py +4 -4
  39. oci/application_migration/application_migration_client.py +19 -19
  40. oci/appmgmt_control/appmgmt_control_client.py +8 -8
  41. oci/artifacts/artifacts_client.py +32 -32
  42. oci/audit/audit_client.py +3 -3
  43. oci/autoscaling/auto_scaling_client.py +11 -11
  44. oci/bastion/bastion_client.py +15 -15
  45. oci/bds/bds_client.py +521 -47
  46. oci/bds/bds_client_composite_operations.py +123 -0
  47. oci/bds/models/__init__.py +14 -0
  48. oci/bds/models/certificate_service_info_details.py +72 -0
  49. oci/bds/models/certificate_service_info_summary.py +206 -0
  50. oci/bds/models/disable_certificate_details.py +103 -0
  51. oci/bds/models/enable_certificate_details.py +196 -0
  52. oci/bds/models/host_cert_details.py +134 -0
  53. oci/bds/models/host_specific_certificate_details.py +150 -0
  54. oci/bds/models/renew_certificate_details.py +196 -0
  55. oci/bds/models/work_request.py +7 -3
  56. oci/blockchain/blockchain_platform_client.py +27 -27
  57. oci/budget/budget_client.py +10 -10
  58. oci/certificates/certificates_client.py +5 -5
  59. oci/certificates_management/certificates_management_client.py +32 -32
  60. oci/cims/incident_client.py +8 -8
  61. oci/cims/user_client.py +1 -1
  62. oci/cloud_bridge/common_client.py +5 -5
  63. oci/cloud_bridge/discovery_client.py +14 -14
  64. oci/cloud_bridge/inventory_client.py +16 -16
  65. oci/cloud_bridge/ocb_agent_svc_client.py +23 -23
  66. oci/cloud_guard/cloud_guard_client.py +133 -133
  67. oci/cloud_migrations/migration_client.py +43 -43
  68. oci/compute_cloud_at_customer/compute_cloud_at_customer_client.py +14 -15
  69. oci/compute_instance_agent/compute_instance_agent_client.py +6 -6
  70. oci/compute_instance_agent/plugin_client.py +2 -2
  71. oci/compute_instance_agent/pluginconfig_client.py +1 -1
  72. oci/container_engine/container_engine_client.py +44 -44
  73. oci/container_instances/container_instance_client.py +18 -18
  74. oci/core/blockstorage_client.py +60 -60
  75. oci/core/compute_client.py +1480 -210
  76. oci/core/compute_client_composite_operations.py +195 -0
  77. oci/core/compute_management_client.py +32 -32
  78. oci/core/models/__init__.py +42 -0
  79. oci/core/models/capacity_source.py +101 -0
  80. oci/core/models/change_compute_capacity_topology_compartment_details.py +78 -0
  81. oci/core/models/compute_bare_metal_host.py +458 -0
  82. oci/core/models/compute_bare_metal_host_collection.py +72 -0
  83. oci/core/models/compute_bare_metal_host_summary.py +422 -0
  84. oci/core/models/compute_capacity_topology.py +425 -0
  85. oci/core/models/compute_capacity_topology_collection.py +72 -0
  86. oci/core/models/compute_capacity_topology_summary.py +370 -0
  87. oci/core/models/compute_hpc_island.py +267 -0
  88. oci/core/models/compute_hpc_island_collection.py +72 -0
  89. oci/core/models/compute_hpc_island_summary.py +251 -0
  90. oci/core/models/compute_network_block.py +302 -0
  91. oci/core/models/compute_network_block_collection.py +72 -0
  92. oci/core/models/compute_network_block_summary.py +286 -0
  93. oci/core/models/create_capacity_source_details.py +89 -0
  94. oci/core/models/create_compute_capacity_topology_details.py +253 -0
  95. oci/core/models/create_dedicated_capacity_source_details.py +85 -0
  96. oci/core/models/dedicated_capacity_source.py +86 -0
  97. oci/core/models/update_capacity_source_details.py +89 -0
  98. oci/core/models/update_compute_capacity_topology_details.py +183 -0
  99. oci/core/models/update_dedicated_capacity_source_details.py +50 -0
  100. oci/core/virtual_network_client.py +242 -242
  101. oci/dashboard_service/dashboard_client.py +6 -6
  102. oci/dashboard_service/dashboard_group_client.py +6 -6
  103. oci/data_catalog/data_catalog_client.py +141 -141
  104. oci/data_flow/data_flow_client.py +42 -42
  105. oci/data_integration/data_integration_client.py +163 -163
  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 +252 -252
  109. oci/data_science/data_science_client.py +91 -91
  110. oci/data_science/models/fast_launch_job_config_summary.py +7 -3
  111. oci/data_science/models/job_shape_summary.py +7 -3
  112. oci/data_science/models/model_deployment_shape_summary.py +7 -3
  113. oci/data_science/models/notebook_session_shape_summary.py +7 -3
  114. oci/database/database_client.py +2092 -1268
  115. oci/database/database_client_composite_operations.py +222 -0
  116. oci/database/models/__init__.py +14 -0
  117. oci/database/models/autonomous_container_database.py +33 -2
  118. oci/database/models/autonomous_container_database_backup_config.py +2 -0
  119. oci/database/models/autonomous_container_database_summary.py +33 -2
  120. oci/database/models/autonomous_vm_cluster.py +95 -2
  121. oci/database/models/autonomous_vm_cluster_summary.py +95 -2
  122. oci/database/models/cloud_autonomous_vm_cluster.py +95 -2
  123. oci/database/models/cloud_autonomous_vm_cluster_summary.py +95 -2
  124. oci/database/models/console_history.py +368 -0
  125. oci/database/models/console_history_collection.py +72 -0
  126. oci/database/models/console_history_summary.py +368 -0
  127. oci/database/models/create_cloud_vm_cluster_details.py +33 -2
  128. oci/database/models/create_console_history_details.py +151 -0
  129. oci/database/models/create_vm_cluster_details.py +33 -2
  130. oci/database/models/db_system_upgrade_history_entry.py +64 -2
  131. oci/database/models/db_system_upgrade_history_entry_summary.py +64 -2
  132. oci/database/models/peer_autonomous_container_database_backup_config.py +2 -0
  133. oci/database/models/system_version_collection.py +72 -0
  134. oci/database/models/system_version_summary.py +134 -0
  135. oci/database/models/update_autonomous_vm_cluster_details.py +95 -2
  136. oci/database/models/update_cloud_autonomous_vm_cluster_details.py +93 -0
  137. oci/database/models/update_console_history_details.py +150 -0
  138. oci/database/models/upgrade_db_system_details.py +31 -0
  139. oci/database_management/db_management_client.py +182 -182
  140. oci/database_management/diagnosability_client.py +4 -4
  141. oci/database_management/managed_my_sql_databases_client.py +6 -6
  142. oci/database_management/perfhub_client.py +1 -1
  143. oci/database_management/sql_tuning_client.py +17 -17
  144. oci/database_migration/database_migration_client.py +41 -41
  145. oci/database_tools/database_tools_client.py +23 -23
  146. oci/devops/devops_client.py +89 -89
  147. oci/disaster_recovery/disaster_recovery_client.py +29 -29
  148. oci/dns/dns_client.py +52 -52
  149. oci/dts/appliance_export_job_client.py +6 -6
  150. oci/dts/shipping_vendors_client.py +1 -1
  151. oci/dts/transfer_appliance_client.py +8 -8
  152. oci/dts/transfer_appliance_entitlement_client.py +3 -3
  153. oci/dts/transfer_device_client.py +5 -5
  154. oci/dts/transfer_job_client.py +6 -6
  155. oci/dts/transfer_package_client.py +7 -7
  156. oci/em_warehouse/em_data_lake_client.py +13 -13
  157. oci/em_warehouse/em_warehouse_client.py +13 -13
  158. oci/email/email_client.py +25 -25
  159. oci/events/events_client.py +6 -6
  160. oci/file_storage/file_storage_client.py +50 -50
  161. oci/fleet_software_update/fleet_software_update_client.py +44 -44
  162. oci/functions/functions_invoke_client.py +1 -1
  163. oci/functions/functions_management_client.py +16 -16
  164. oci/fusion_apps/data_masking_activity_client.py +3 -3
  165. oci/fusion_apps/fusion_applications_client.py +39 -39
  166. oci/fusion_apps/fusion_environment_client.py +15 -15
  167. oci/fusion_apps/fusion_environment_family_client.py +8 -8
  168. oci/fusion_apps/refresh_activity_client.py +4 -4
  169. oci/fusion_apps/scheduled_activity_client.py +2 -2
  170. oci/fusion_apps/service_attachment_client.py +2 -2
  171. oci/generic_artifacts_content/generic_artifacts_content_client.py +3 -3
  172. oci/golden_gate/golden_gate_client.py +536 -57
  173. oci/golden_gate/golden_gate_client_composite_operations.py +90 -0
  174. oci/golden_gate/models/__init__.py +8 -0
  175. oci/golden_gate/models/certificate.py +713 -0
  176. oci/golden_gate/models/certificate_collection.py +72 -0
  177. oci/golden_gate/models/certificate_summary.py +269 -0
  178. oci/golden_gate/models/create_certificate_details.py +105 -0
  179. oci/golden_gate/models/create_microsoft_sqlserver_connection_details.py +2 -2
  180. oci/golden_gate/models/create_mysql_connection_details.py +10 -12
  181. oci/golden_gate/models/create_postgresql_connection_details.py +8 -6
  182. oci/golden_gate/models/microsoft_sqlserver_connection.py +2 -2
  183. oci/golden_gate/models/microsoft_sqlserver_connection_summary.py +2 -2
  184. oci/golden_gate/models/update_microsoft_sqlserver_connection_details.py +2 -2
  185. oci/golden_gate/models/update_mysql_connection_details.py +10 -12
  186. oci/golden_gate/models/update_postgresql_connection_details.py +8 -6
  187. oci/golden_gate/models/work_request.py +11 -3
  188. oci/governance_rules_control_plane/governance_rule_client.py +15 -15
  189. oci/governance_rules_control_plane/work_request_client.py +5 -5
  190. oci/healthchecks/health_checks_client.py +17 -17
  191. oci/identity/identity_client.py +145 -145
  192. oci/identity_data_plane/dataplane_client.py +2 -2
  193. oci/identity_domains/identity_domains_client.py +20355 -6173
  194. oci/identity_domains/models/__init__.py +216 -0
  195. oci/identity_domains/models/app_extension_radius_app_app.py +55 -0
  196. oci/identity_domains/models/approval_workflow.py +832 -0
  197. oci/identity_domains/models/approval_workflow_approval_workflow_steps.py +294 -0
  198. oci/identity_domains/models/approval_workflow_assignment.py +771 -0
  199. oci/identity_domains/models/approval_workflow_assignment_approval_workflow.py +318 -0
  200. oci/identity_domains/models/approval_workflow_assignment_assigned_to.py +318 -0
  201. oci/identity_domains/models/approval_workflow_assignments.py +196 -0
  202. oci/identity_domains/models/approval_workflow_max_duration.py +185 -0
  203. oci/identity_domains/models/approval_workflow_step.py +929 -0
  204. oci/identity_domains/models/approval_workflow_step_approvers.py +294 -0
  205. oci/identity_domains/models/approval_workflow_steps.py +196 -0
  206. oci/identity_domains/models/approval_workflows.py +196 -0
  207. oci/identity_domains/models/authentication_factors_remover.py +51 -2
  208. oci/identity_domains/models/branding_setting.py +1556 -0
  209. oci/identity_domains/models/branding_settings.py +196 -0
  210. oci/identity_domains/models/branding_settings_company_names.py +131 -0
  211. oci/identity_domains/models/branding_settings_default_company_names.py +143 -0
  212. oci/identity_domains/models/branding_settings_default_images.py +188 -0
  213. oci/identity_domains/models/branding_settings_default_login_texts.py +143 -0
  214. oci/identity_domains/models/branding_settings_images.py +176 -0
  215. oci/identity_domains/models/branding_settings_login_texts.py +131 -0
  216. oci/identity_domains/models/cloud_gate.py +1239 -0
  217. oci/identity_domains/models/cloud_gate_ext_mappings.py +610 -0
  218. oci/identity_domains/models/cloud_gate_ext_servers.py +296 -0
  219. oci/identity_domains/models/cloud_gate_ext_upstream_server_groups.py +316 -0
  220. oci/identity_domains/models/cloud_gate_ext_upstream_servers.py +426 -0
  221. oci/identity_domains/models/cloud_gate_mapping.py +1068 -0
  222. oci/identity_domains/models/cloud_gate_mapping_cloud_gate.py +153 -0
  223. oci/identity_domains/models/cloud_gate_mapping_gateway_app.py +204 -0
  224. oci/identity_domains/models/cloud_gate_mapping_search_request.py +364 -0
  225. oci/identity_domains/models/cloud_gate_mapping_server.py +153 -0
  226. oci/identity_domains/models/cloud_gate_mapping_upstream_server_group.py +217 -0
  227. oci/identity_domains/models/cloud_gate_mappings.py +196 -0
  228. oci/identity_domains/models/cloud_gate_oauth_client.py +208 -0
  229. oci/identity_domains/models/cloud_gate_search_request.py +364 -0
  230. oci/identity_domains/models/cloud_gate_server.py +1042 -0
  231. oci/identity_domains/models/cloud_gate_server_cloud_gate.py +153 -0
  232. oci/identity_domains/models/cloud_gate_server_search_request.py +364 -0
  233. oci/identity_domains/models/cloud_gate_servers.py +196 -0
  234. oci/identity_domains/models/cloud_gates.py +196 -0
  235. oci/identity_domains/models/condition.py +1063 -0
  236. oci/identity_domains/models/condition_search_request.py +364 -0
  237. oci/identity_domains/models/conditions.py +196 -0
  238. oci/identity_domains/models/defined_tags.py +2 -0
  239. oci/identity_domains/models/extension_social_identity_provider.py +55 -0
  240. oci/identity_domains/models/freeform_tags.py +2 -0
  241. oci/identity_domains/models/identity_provider_relay_idp_param_mappings.py +159 -0
  242. oci/identity_domains/models/me_password_changer.py +2 -2
  243. oci/identity_domains/models/my_authentication_factors_remover.py +51 -2
  244. oci/identity_domains/models/my_completed_approval.py +1146 -0
  245. oci/identity_domains/models/my_completed_approvals.py +196 -0
  246. oci/identity_domains/models/my_pending_approval.py +1146 -0
  247. oci/identity_domains/models/my_pending_approvals.py +196 -0
  248. oci/identity_domains/models/my_request.py +217 -2
  249. oci/identity_domains/models/my_request_approval_details.py +398 -0
  250. oci/identity_domains/models/my_request_requesting.py +53 -0
  251. oci/identity_domains/models/network_perimeter.py +852 -0
  252. oci/identity_domains/models/network_perimeter_ip_addresses.py +228 -0
  253. oci/identity_domains/models/network_perimeter_search_request.py +364 -0
  254. oci/identity_domains/models/network_perimeters.py +196 -0
  255. oci/identity_domains/models/notification_setting.py +1038 -0
  256. oci/identity_domains/models/notification_settings.py +196 -0
  257. oci/identity_domains/models/notification_settings_event_settings.py +143 -0
  258. oci/identity_domains/models/notification_settings_from_email_address.py +278 -0
  259. oci/identity_domains/models/notification_settings_search_request.py +171 -0
  260. oci/identity_domains/models/o_auth_client_certificate.py +1187 -0
  261. oci/identity_domains/models/o_auth_client_certificate_search_request.py +364 -0
  262. oci/identity_domains/models/o_auth_client_certificates.py +196 -0
  263. oci/identity_domains/models/o_auth_partner_certificate.py +1187 -0
  264. oci/identity_domains/models/o_auth_partner_certificate_search_request.py +364 -0
  265. oci/identity_domains/models/o_auth_partner_certificates.py +196 -0
  266. oci/identity_domains/models/policies.py +196 -0
  267. oci/identity_domains/models/policy.py +979 -0
  268. oci/identity_domains/models/policy_policy_type.py +150 -0
  269. oci/identity_domains/models/policy_rules.py +247 -0
  270. oci/identity_domains/models/policy_search_request.py +364 -0
  271. oci/identity_domains/models/rule.py +1110 -0
  272. oci/identity_domains/models/rule_condition_group.py +270 -0
  273. oci/identity_domains/models/rule_policy_type.py +150 -0
  274. oci/identity_domains/models/rule_return.py +188 -0
  275. oci/identity_domains/models/rule_search_request.py +364 -0
  276. oci/identity_domains/models/rules.py +196 -0
  277. oci/identity_domains/models/schema.py +537 -0
  278. oci/identity_domains/models/schema_attributes.py +4165 -0
  279. oci/identity_domains/models/schema_idcs_complex_attribute_name_mappings.py +188 -0
  280. oci/identity_domains/models/schema_idcs_csv_attribute_name_mappings.py +433 -0
  281. oci/identity_domains/models/schema_localized_canonical_values.py +188 -0
  282. oci/identity_domains/models/schema_localized_display_name.py +147 -0
  283. oci/identity_domains/models/schema_referenced_resource_type_unique_attribute_name_mappings.py +139 -0
  284. oci/identity_domains/models/schema_resolve_value_using_resource_type.py +139 -0
  285. oci/identity_domains/models/schema_search_request.py +329 -0
  286. oci/identity_domains/models/schema_sub_attributes.py +3209 -0
  287. oci/identity_domains/models/schemas.py +196 -0
  288. oci/identity_domains/models/self_registration_profile.py +1636 -0
  289. oci/identity_domains/models/self_registration_profile_after_submit_text.py +194 -0
  290. oci/identity_domains/models/self_registration_profile_consent_text.py +194 -0
  291. oci/identity_domains/models/self_registration_profile_default_groups.py +190 -0
  292. oci/identity_domains/models/self_registration_profile_display_name.py +194 -0
  293. oci/identity_domains/models/self_registration_profile_email_template.py +202 -0
  294. oci/identity_domains/models/self_registration_profile_footer_text.py +194 -0
  295. oci/identity_domains/models/self_registration_profile_header_text.py +194 -0
  296. oci/identity_domains/models/self_registration_profile_search_request.py +364 -0
  297. oci/identity_domains/models/self_registration_profile_user_attributes.py +286 -0
  298. oci/identity_domains/models/self_registration_profiles.py +196 -0
  299. oci/identity_domains/models/setting.py +3110 -0
  300. oci/identity_domains/models/settings.py +196 -0
  301. oci/identity_domains/models/settings_certificate_validation.py +566 -0
  302. oci/identity_domains/models/settings_cloud_gate_cors_settings.py +318 -0
  303. oci/identity_domains/models/settings_company_names.py +135 -0
  304. oci/identity_domains/models/settings_default_company_names.py +143 -0
  305. oci/identity_domains/models/settings_default_images.py +188 -0
  306. oci/identity_domains/models/settings_default_login_texts.py +145 -0
  307. oci/identity_domains/models/settings_images.py +176 -0
  308. oci/identity_domains/models/settings_login_texts.py +137 -0
  309. oci/identity_domains/models/settings_purge_configs.py +139 -0
  310. oci/identity_domains/models/settings_search_request.py +171 -0
  311. oci/identity_domains/models/settings_tenant_custom_claims.py +438 -0
  312. oci/identity_domains/models/user_ext_risk_scores.py +4 -0
  313. oci/integration/integration_instance_client.py +15 -15
  314. oci/jms/java_management_service_client.py +66 -66
  315. oci/jms_java_downloads/java_download_client.py +25 -25
  316. oci/key_management/ekm_client.py +5 -5
  317. oci/key_management/kms_crypto_client.py +6 -6
  318. oci/key_management/kms_management_client.py +21 -21
  319. oci/key_management/kms_vault_client.py +14 -14
  320. oci/license_manager/license_manager_client.py +18 -18
  321. oci/limits/limits_client.py +4 -4
  322. oci/limits/quotas_client.py +7 -7
  323. oci/load_balancer/load_balancer_client.py +61 -61
  324. oci/lockbox/lockbox_client.py +23 -23
  325. oci/log_analytics/log_analytics_client.py +388 -192
  326. oci/log_analytics/models/export_details.py +15 -17
  327. oci/logging/logging_management_client.py +30 -30
  328. oci/loggingingestion/logging_client.py +1 -1
  329. oci/loggingsearch/log_search_client.py +1 -1
  330. oci/management_agent/management_agent_client.py +23 -23
  331. oci/management_dashboard/dashx_apis_client.py +14 -14
  332. oci/marketplace/account_client.py +2 -2
  333. oci/marketplace/marketplace_client.py +30 -30
  334. oci/marketplace_publisher/marketplace_publisher_client.py +71 -71
  335. oci/media_services/media_services_client.py +48 -48
  336. oci/media_services/media_stream_client.py +2 -2
  337. oci/monitoring/monitoring_client.py +13 -13
  338. oci/mysql/channels_client.py +7 -7
  339. oci/mysql/db_backups_client.py +6 -6
  340. oci/mysql/db_system_client.py +17 -17
  341. oci/mysql/mysqlaas_client.py +7 -7
  342. oci/mysql/replicas_client.py +5 -5
  343. oci/mysql/work_requests_client.py +4 -4
  344. oci/network_firewall/network_firewall_client.py +80 -80
  345. oci/network_load_balancer/network_load_balancer_client.py +34 -34
  346. oci/nosql/nosql_client.py +24 -24
  347. oci/object_storage/object_storage_client.py +50 -50
  348. oci/oce/oce_instance_client.py +10 -10
  349. oci/oci_control_center/occ_metrics_client.py +3 -3
  350. oci/ocvp/__init__.py +4 -2
  351. oci/ocvp/cluster_client.py +732 -0
  352. oci/ocvp/cluster_client_composite_operations.py +160 -0
  353. oci/ocvp/esxi_host_client.py +262 -14
  354. oci/ocvp/esxi_host_client_composite_operations.py +84 -1
  355. oci/ocvp/models/__init__.py +29 -7
  356. oci/ocvp/models/change_sddc_compartment_details.py +1 -1
  357. oci/ocvp/models/cluster.py +1026 -0
  358. oci/ocvp/models/cluster_collection.py +72 -0
  359. oci/ocvp/models/cluster_summary.py +671 -0
  360. oci/ocvp/models/create_cluster_details.py +658 -0
  361. oci/ocvp/models/create_esxi_host_details.py +112 -161
  362. oci/ocvp/models/create_sddc_details.py +86 -814
  363. oci/ocvp/models/datastore_details.py +154 -0
  364. oci/ocvp/models/datastore_info.py +6 -6
  365. oci/ocvp/models/downgrade_hcx_details.py +1 -1
  366. oci/ocvp/models/esxi_host.py +132 -64
  367. oci/ocvp/models/esxi_host_collection.py +1 -1
  368. oci/ocvp/models/esxi_host_summary.py +100 -63
  369. oci/ocvp/models/hcx_license_summary.py +1 -1
  370. oci/ocvp/models/initial_cluster_configuration.py +518 -0
  371. oci/ocvp/models/initial_configuration.py +72 -0
  372. oci/ocvp/models/network_configuration.py +635 -0
  373. oci/ocvp/models/replace_host_details.py +78 -0
  374. oci/ocvp/models/sddc.py +176 -1269
  375. oci/ocvp/models/sddc_collection.py +1 -1
  376. oci/ocvp/models/sddc_password.py +123 -0
  377. oci/ocvp/models/sddc_summary.py +55 -161
  378. oci/ocvp/models/supported_commitment_summary.py +96 -0
  379. oci/ocvp/models/supported_commitment_summary_collection.py +72 -0
  380. oci/ocvp/models/supported_esxi_software_version_summary.py +135 -0
  381. oci/ocvp/models/supported_host_shape_collection.py +1 -1
  382. oci/ocvp/models/supported_host_shape_summary.py +54 -54
  383. oci/ocvp/models/supported_vmware_software_version_collection.py +1 -1
  384. oci/ocvp/models/supported_vmware_software_version_summary.py +34 -3
  385. oci/ocvp/models/update_cluster_details.py +265 -0
  386. oci/ocvp/models/update_esxi_host_details.py +32 -32
  387. oci/ocvp/models/update_sddc_details.py +42 -377
  388. oci/ocvp/models/vsphere_license.py +1 -1
  389. oci/ocvp/models/vsphere_upgrade_object.py +1 -1
  390. oci/ocvp/models/work_request.py +20 -4
  391. oci/ocvp/models/work_request_collection.py +1 -1
  392. oci/ocvp/models/work_request_error.py +1 -1
  393. oci/ocvp/models/work_request_error_collection.py +1 -1
  394. oci/ocvp/models/work_request_log_entry.py +1 -1
  395. oci/ocvp/models/work_request_log_entry_collection.py +1 -1
  396. oci/ocvp/models/work_request_resource.py +1 -1
  397. oci/ocvp/sddc_client.py +212 -68
  398. oci/ocvp/sddc_client_composite_operations.py +1 -1
  399. oci/ocvp/work_request_client.py +10 -10
  400. oci/ocvp/work_request_client_composite_operations.py +1 -1
  401. oci/oda/management_client.py +56 -56
  402. oci/oda/oda_client.py +17 -17
  403. oci/oda/odapackage_client.py +7 -7
  404. oci/onesubscription/billing_schedule_client.py +1 -1
  405. oci/onesubscription/commitment_client.py +2 -2
  406. oci/onesubscription/computed_usage_client.py +3 -3
  407. oci/onesubscription/invoice_summary_client.py +2 -2
  408. oci/onesubscription/organization_subscription_client.py +1 -1
  409. oci/onesubscription/ratecard_client.py +1 -1
  410. oci/onesubscription/subscribed_service_client.py +2 -2
  411. oci/onesubscription/subscription_client.py +1 -1
  412. oci/ons/notification_control_plane_client.py +6 -6
  413. oci/ons/notification_data_plane_client.py +10 -10
  414. oci/opa/opa_instance_client.py +11 -11
  415. oci/opensearch/opensearch_cluster_backup_client.py +4 -4
  416. oci/opensearch/opensearch_cluster_client.py +14 -14
  417. oci/operator_access_control/access_requests_client.py +9 -9
  418. oci/operator_access_control/operator_actions_client.py +2 -2
  419. oci/operator_access_control/operator_control_assignment_client.py +6 -6
  420. oci/operator_access_control/operator_control_client.py +6 -6
  421. oci/opsi/models/__init__.py +22 -0
  422. oci/opsi/models/awr_hub_objects.py +72 -0
  423. oci/opsi/models/awr_hub_source.py +904 -0
  424. oci/opsi/models/awr_hub_source_summary.py +904 -0
  425. oci/opsi/models/awr_hub_source_summary_collection.py +72 -0
  426. oci/opsi/models/awr_hub_sources.py +72 -0
  427. oci/opsi/models/change_awr_hub_source_compartment_details.py +72 -0
  428. oci/opsi/models/change_operations_insights_warehouse_compartment_details.py +76 -0
  429. oci/opsi/models/create_awr_hub_details.py +1 -1
  430. oci/opsi/models/create_awr_hub_source_details.py +377 -0
  431. oci/opsi/models/list_objects.py +134 -0
  432. oci/opsi/models/object_summary.py +329 -0
  433. oci/opsi/models/update_awr_hub_source_details.py +210 -0
  434. oci/opsi/models/work_request.py +27 -3
  435. oci/opsi/operations_insights_client.py +3221 -1507
  436. oci/opsi/operations_insights_client_composite_operations.py +283 -0
  437. oci/optimizer/optimizer_client.py +26 -26
  438. oci/os_management/event_client.py +8 -8
  439. oci/os_management/os_management_client.py +69 -69
  440. oci/os_management_hub/lifecycle_environment_client.py +11 -11
  441. oci/os_management_hub/managed_instance_client.py +22 -22
  442. oci/os_management_hub/managed_instance_group_client.py +22 -22
  443. oci/os_management_hub/management_station_client.py +8 -8
  444. oci/os_management_hub/onboarding_client.py +5 -5
  445. oci/os_management_hub/reporting_managed_instance_client.py +3 -3
  446. oci/os_management_hub/scheduled_job_client.py +6 -6
  447. oci/os_management_hub/software_source_client.py +22 -22
  448. oci/os_management_hub/work_request_client.py +4 -4
  449. oci/osp_gateway/address_rule_service_client.py +1 -1
  450. oci/osp_gateway/address_service_client.py +2 -2
  451. oci/osp_gateway/invoice_service_client.py +5 -5
  452. oci/osp_gateway/subscription_service_client.py +5 -5
  453. oci/osub_billing_schedule/billing_schedule_client.py +1 -1
  454. oci/osub_organization_subscription/organization_subscription_client.py +1 -1
  455. oci/osub_subscription/commitment_client.py +2 -2
  456. oci/osub_subscription/ratecard_client.py +1 -1
  457. oci/osub_subscription/subscription_client.py +1 -1
  458. oci/osub_usage/computed_usage_client.py +3 -3
  459. oci/psql/__init__.py +14 -0
  460. oci/psql/models/__init__.py +166 -0
  461. oci/psql/models/backup.py +645 -0
  462. oci/psql/models/backup_collection.py +72 -0
  463. oci/psql/models/backup_policy.py +156 -0
  464. oci/psql/models/backup_source_details.py +113 -0
  465. oci/psql/models/backup_summary.py +481 -0
  466. oci/psql/models/change_backup_compartment_details.py +74 -0
  467. oci/psql/models/change_configuration_compartment_details.py +74 -0
  468. oci/psql/models/change_db_system_compartment_details.py +78 -0
  469. oci/psql/models/config_overrides.py +103 -0
  470. oci/psql/models/config_params.py +289 -0
  471. oci/psql/models/configuration.py +532 -0
  472. oci/psql/models/configuration_collection.py +72 -0
  473. oci/psql/models/configuration_details.py +72 -0
  474. oci/psql/models/configuration_summary.py +450 -0
  475. oci/psql/models/connection_details.py +134 -0
  476. oci/psql/models/create_backup_details.py +262 -0
  477. oci/psql/models/create_configuration_details.py +384 -0
  478. oci/psql/models/create_db_instance_details.py +136 -0
  479. oci/psql/models/create_db_system_details.py +585 -0
  480. oci/psql/models/credentials.py +100 -0
  481. oci/psql/models/daily_backup_policy.py +89 -0
  482. oci/psql/models/db_configuration_override_collection.py +72 -0
  483. oci/psql/models/db_instance.py +325 -0
  484. oci/psql/models/db_instance_endpoint.py +99 -0
  485. oci/psql/models/db_system.py +827 -0
  486. oci/psql/models/db_system_collection.py +72 -0
  487. oci/psql/models/db_system_details.py +103 -0
  488. oci/psql/models/db_system_summary.py +574 -0
  489. oci/psql/models/default_config_params.py +258 -0
  490. oci/psql/models/default_configuration.py +406 -0
  491. oci/psql/models/default_configuration_collection.py +72 -0
  492. oci/psql/models/default_configuration_details.py +72 -0
  493. oci/psql/models/default_configuration_summary.py +320 -0
  494. oci/psql/models/endpoint.py +134 -0
  495. oci/psql/models/failover_db_system_details.py +107 -0
  496. oci/psql/models/management_policy.py +99 -0
  497. oci/psql/models/management_policy_details.py +99 -0
  498. oci/psql/models/monthly_backup_policy.py +122 -0
  499. oci/psql/models/network_details.py +136 -0
  500. oci/psql/models/none_backup_policy.py +58 -0
  501. oci/psql/models/none_source_details.py +51 -0
  502. oci/psql/models/oci_optimized_storage_details.py +95 -0
  503. oci/psql/models/password_details.py +110 -0
  504. oci/psql/models/patch_db_system_details.py +74 -0
  505. oci/psql/models/patch_insert_instruction.py +171 -0
  506. oci/psql/models/patch_instruction.py +184 -0
  507. oci/psql/models/patch_merge_instruction.py +97 -0
  508. oci/psql/models/patch_move_instruction.py +147 -0
  509. oci/psql/models/patch_prohibit_instruction.py +100 -0
  510. oci/psql/models/patch_remove_instruction.py +59 -0
  511. oci/psql/models/patch_replace_instruction.py +92 -0
  512. oci/psql/models/patch_require_instruction.py +99 -0
  513. oci/psql/models/plain_text_password_details.py +82 -0
  514. oci/psql/models/primary_db_instance_details.py +72 -0
  515. oci/psql/models/reset_master_user_password_details.py +69 -0
  516. oci/psql/models/restart_db_instance_in_db_system_details.py +119 -0
  517. oci/psql/models/restore_db_system_details.py +105 -0
  518. oci/psql/models/shape_collection.py +72 -0
  519. oci/psql/models/shape_summary.py +165 -0
  520. oci/psql/models/source_details.py +109 -0
  521. oci/psql/models/storage_details.py +161 -0
  522. oci/psql/models/update_backup_details.py +200 -0
  523. oci/psql/models/update_configuration_details.py +103 -0
  524. oci/psql/models/update_db_config_params.py +121 -0
  525. oci/psql/models/update_db_system_db_instance_details.py +103 -0
  526. oci/psql/models/update_db_system_details.py +250 -0
  527. oci/psql/models/update_storage_details_params.py +74 -0
  528. oci/psql/models/vault_secret_password_details.py +113 -0
  529. oci/psql/models/weekly_backup_policy.py +157 -0
  530. oci/psql/models/work_request.py +412 -0
  531. oci/psql/models/work_request_error.py +136 -0
  532. oci/psql/models/work_request_error_collection.py +72 -0
  533. oci/psql/models/work_request_log_entry.py +103 -0
  534. oci/psql/models/work_request_log_entry_collection.py +72 -0
  535. oci/psql/models/work_request_resource.py +228 -0
  536. oci/psql/models/work_request_summary.py +412 -0
  537. oci/psql/models/work_request_summary_collection.py +72 -0
  538. oci/psql/postgresql_client.py +3980 -0
  539. oci/psql/postgresql_client_composite_operations.py +807 -0
  540. oci/queue/queue_admin_client.py +11 -11
  541. oci/queue/queue_client.py +8 -8
  542. oci/recovery/database_recovery_client.py +23 -23
  543. oci/redis/redis_cluster_client.py +11 -11
  544. oci/regions_definitions.py +12 -4
  545. oci/resource_manager/resource_manager_client.py +52 -52
  546. oci/resource_search/resource_search_client.py +3 -3
  547. oci/rover/rover_bundle_client.py +8 -8
  548. oci/rover/rover_cluster_client.py +8 -8
  549. oci/rover/rover_entitlement_client.py +6 -6
  550. oci/rover/rover_node_client.py +15 -15
  551. oci/rover/shape_client.py +1 -1
  552. oci/rover/work_requests_client.py +5 -5
  553. oci/sch/service_connector_client.py +12 -12
  554. oci/secrets/secrets_client.py +3 -3
  555. oci/service_catalog/service_catalog_client.py +26 -26
  556. oci/service_manager_proxy/service_manager_proxy_client.py +2 -2
  557. oci/service_mesh/service_mesh_client.py +48 -48
  558. oci/stack_monitoring/stack_monitoring_client.py +58 -58
  559. oci/streaming/stream_admin_client.py +18 -18
  560. oci/streaming/stream_client.py +8 -8
  561. oci/tenant_manager_control_plane/domain_client.py +5 -5
  562. oci/tenant_manager_control_plane/domain_governance_client.py +5 -5
  563. oci/tenant_manager_control_plane/governance_client.py +2 -2
  564. oci/tenant_manager_control_plane/link_client.py +3 -3
  565. oci/tenant_manager_control_plane/orders_client.py +2 -2
  566. oci/tenant_manager_control_plane/organization_client.py +10 -10
  567. oci/tenant_manager_control_plane/recipient_invitation_client.py +5 -5
  568. oci/tenant_manager_control_plane/sender_invitation_client.py +5 -5
  569. oci/tenant_manager_control_plane/subscription_client.py +11 -11
  570. oci/tenant_manager_control_plane/work_request_client.py +4 -4
  571. oci/threat_intelligence/threatintel_client.py +5 -5
  572. oci/usage/resources_client.py +2 -2
  573. oci/usage/rewards_client.py +6 -6
  574. oci/usage/usagelimits_client.py +1 -1
  575. oci/usage_api/usageapi_client.py +19 -19
  576. oci/vault/vaults_client.py +11 -11
  577. oci/vbs_inst/vbs_instance_client.py +10 -10
  578. oci/version.py +1 -1
  579. oci/visual_builder/vb_instance_client.py +13 -13
  580. oci/vn_monitoring/vn_monitoring_client.py +12 -12
  581. oci/vulnerability_scanning/vulnerability_scanning_client.py +58 -58
  582. oci/waa/waa_client.py +13 -13
  583. oci/waa/work_request_client.py +4 -4
  584. oci/waas/redirect_client.py +6 -6
  585. oci/waas/waas_client.py +66 -66
  586. oci/waf/waf_client.py +24 -24
  587. oci/work_requests/work_request_client.py +4 -4
  588. {oci-2.115.1.dist-info → oci-2.117.0.dist-info}/METADATA +1 -1
  589. {oci-2.115.1.dist-info → oci-2.117.0.dist-info}/RECORD +593 -334
  590. {oci-2.115.1.dist-info → oci-2.117.0.dist-info}/LICENSE.txt +0 -0
  591. {oci-2.115.1.dist-info → oci-2.117.0.dist-info}/THIRD_PARTY_LICENSES.txt +0 -0
  592. {oci-2.115.1.dist-info → oci-2.117.0.dist-info}/WHEEL +0 -0
  593. {oci-2.115.1.dist-info → oci-2.117.0.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,3980 @@
1
+ # coding: utf-8
2
+ # Copyright (c) 2016, 2023, Oracle and/or its affiliates. All rights reserved.
3
+ # This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
4
+
5
+ # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220915
6
+
7
+ from __future__ import absolute_import
8
+
9
+ from oci._vendor import requests # noqa: F401
10
+ from oci._vendor import six
11
+
12
+ from oci import retry, circuit_breaker # noqa: F401
13
+ from oci.base_client import BaseClient
14
+ from oci.config import get_config_value_or_default, validate_config
15
+ from oci.signer import Signer
16
+ from oci.util import Sentinel, get_signer_from_authentication_type, AUTHENTICATION_TYPE_FIELD_NAME
17
+ from oci.exceptions import InvalidAlloyConfig
18
+ from oci.alloy import OCI_SDK_ENABLED_SERVICES_SET
19
+ from .models import psql_type_mapping
20
+ missing = Sentinel("Missing")
21
+
22
+
23
+ class PostgresqlClient(object):
24
+ """
25
+ A description of the PGSQL Control Plane API
26
+ """
27
+
28
+ def __init__(self, config, **kwargs):
29
+ """
30
+ Creates a new service client
31
+
32
+ :param dict config:
33
+ Configuration keys and values as per `SDK and Tool Configuration <https://docs.cloud.oracle.com/Content/API/Concepts/sdkconfig.htm>`__.
34
+ The :py:meth:`~oci.config.from_file` method can be used to load configuration from a file. Alternatively, a ``dict`` can be passed. You can validate_config
35
+ the dict using :py:meth:`~oci.config.validate_config`
36
+
37
+ :param str service_endpoint: (optional)
38
+ The endpoint of the service to call using this client. For example ``https://iaas.us-ashburn-1.oraclecloud.com``. If this keyword argument is
39
+ not provided then it will be derived using the region in the config parameter. You should only provide this keyword argument if you have an explicit
40
+ need to specify a service endpoint.
41
+
42
+ :param timeout: (optional)
43
+ The connection and read timeouts for the client. The default values are connection timeout 10 seconds and read timeout 60 seconds. This keyword argument can be provided
44
+ as a single float, in which case the value provided is used for both the read and connection timeouts, or as a tuple of two floats. If
45
+ a tuple is provided then the first value is used as the connection timeout and the second value as the read timeout.
46
+ :type timeout: float or tuple(float, float)
47
+
48
+ :param signer: (optional)
49
+ The signer to use when signing requests made by the service client. The default is to use a :py:class:`~oci.signer.Signer` based on the values
50
+ provided in the config parameter.
51
+
52
+ One use case for this parameter is for `Instance Principals authentication <https://docs.cloud.oracle.com/Content/Identity/Tasks/callingservicesfrominstances.htm>`__
53
+ by passing an instance of :py:class:`~oci.auth.signers.InstancePrincipalsSecurityTokenSigner` as the value for this keyword argument
54
+ :type signer: :py:class:`~oci.signer.AbstractBaseSigner`
55
+
56
+ :param obj retry_strategy: (optional)
57
+ A retry strategy to apply to all calls made by this service client (i.e. at the client level). There is no retry strategy applied by default.
58
+ Retry strategies can also be applied at the operation level by passing a ``retry_strategy`` keyword argument as part of calling the operation.
59
+ Any value provided at the operation level will override whatever is specified at the client level.
60
+
61
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY`
62
+ is also available. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
63
+
64
+ :param obj circuit_breaker_strategy: (optional)
65
+ A circuit breaker strategy to apply to all calls made by this service client (i.e. at the client level).
66
+ This client uses :py:data:`~oci.circuit_breaker.DEFAULT_CIRCUIT_BREAKER_STRATEGY` as default if no circuit breaker strategy is provided.
67
+ The specifics of circuit breaker strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/circuit_breakers.html>`__.
68
+
69
+ :param function circuit_breaker_callback: (optional)
70
+ Callback function to receive any exceptions triggerred by the circuit breaker.
71
+
72
+ :param bool client_level_realm_specific_endpoint_template_enabled: (optional)
73
+ A boolean flag to indicate whether or not this client should be created with realm specific endpoint template enabled or disable. By default, this will be set as None.
74
+
75
+ :param allow_control_chars: (optional)
76
+ allow_control_chars is a boolean to indicate whether or not this client should allow control characters in the response object. By default, the client will not
77
+ allow control characters to be in the response object.
78
+ """
79
+ if not OCI_SDK_ENABLED_SERVICES_SET.is_service_enabled("psql"):
80
+ raise InvalidAlloyConfig("The Alloy configuration has disabled this service, this behavior is controlled by OCI_SDK_ENABLED_SERVICES_SET variable. Please check if your local alloy-config file configured the service you're targeting or contact the cloud provider on the availability of this service")
81
+
82
+ validate_config(config, signer=kwargs.get('signer'))
83
+ if 'signer' in kwargs:
84
+ signer = kwargs['signer']
85
+
86
+ elif AUTHENTICATION_TYPE_FIELD_NAME in config:
87
+ signer = get_signer_from_authentication_type(config)
88
+
89
+ else:
90
+ signer = Signer(
91
+ tenancy=config["tenancy"],
92
+ user=config["user"],
93
+ fingerprint=config["fingerprint"],
94
+ private_key_file_location=config.get("key_file"),
95
+ pass_phrase=get_config_value_or_default(config, "pass_phrase"),
96
+ private_key_content=config.get("key_content")
97
+ )
98
+
99
+ base_client_init_kwargs = {
100
+ 'regional_client': True,
101
+ 'service_endpoint': kwargs.get('service_endpoint'),
102
+ 'base_path': '/20220915',
103
+ 'service_endpoint_template': 'https://postgresql.{region}.oci.{secondLevelDomain}',
104
+ 'service_endpoint_template_per_realm': { }, # noqa: E201 E202
105
+ 'skip_deserialization': kwargs.get('skip_deserialization', False),
106
+ 'circuit_breaker_strategy': kwargs.get('circuit_breaker_strategy', circuit_breaker.GLOBAL_CIRCUIT_BREAKER_STRATEGY),
107
+ 'client_level_realm_specific_endpoint_template_enabled': kwargs.get('client_level_realm_specific_endpoint_template_enabled')
108
+ }
109
+ if 'timeout' in kwargs:
110
+ base_client_init_kwargs['timeout'] = kwargs.get('timeout')
111
+ if base_client_init_kwargs.get('circuit_breaker_strategy') is None:
112
+ base_client_init_kwargs['circuit_breaker_strategy'] = circuit_breaker.DEFAULT_CIRCUIT_BREAKER_STRATEGY
113
+ if 'allow_control_chars' in kwargs:
114
+ base_client_init_kwargs['allow_control_chars'] = kwargs.get('allow_control_chars')
115
+ self.base_client = BaseClient("postgresql", config, signer, psql_type_mapping, **base_client_init_kwargs)
116
+ self.retry_strategy = kwargs.get('retry_strategy')
117
+ self.circuit_breaker_callback = kwargs.get('circuit_breaker_callback')
118
+
119
+ def change_backup_compartment(self, backup_id, change_backup_compartment_details, **kwargs):
120
+ """
121
+ Moves a Backup resource from one compartment identifier to another. When provided, If-Match is checked against ETag values of the resource.
122
+
123
+
124
+ :param str backup_id: (required)
125
+ unique Backup identifier
126
+
127
+ :param oci.psql.models.ChangeBackupCompartmentDetails change_backup_compartment_details: (required)
128
+ The information to be updated.
129
+
130
+ :param str if_match: (optional)
131
+ For optimistic concurrency control. In the PUT or DELETE call
132
+
133
+ :param str opc_request_id: (optional)
134
+ The client request ID for tracing.
135
+
136
+ :param str opc_retry_token: (optional)
137
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
138
+
139
+ :param obj retry_strategy: (optional)
140
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
141
+
142
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
143
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
144
+
145
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
146
+
147
+ :param bool allow_control_chars: (optional)
148
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
149
+ By default, the response will not allow control characters in strings
150
+
151
+ :return: A :class:`~oci.response.Response` object with data of type None
152
+ :rtype: :class:`~oci.response.Response`
153
+
154
+ :example:
155
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/change_backup_compartment.py.html>`__ to see an example of how to use change_backup_compartment API.
156
+ """
157
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
158
+ required_arguments = ['backupId']
159
+ resource_path = "/backups/{backupId}/actions/changeCompartment"
160
+ method = "POST"
161
+ operation_name = "change_backup_compartment"
162
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Backup/ChangeBackupCompartment"
163
+
164
+ # Don't accept unknown kwargs
165
+ expected_kwargs = [
166
+ "allow_control_chars",
167
+ "retry_strategy",
168
+ "if_match",
169
+ "opc_request_id",
170
+ "opc_retry_token"
171
+ ]
172
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
173
+ if extra_kwargs:
174
+ raise ValueError(
175
+ f"change_backup_compartment got unknown kwargs: {extra_kwargs!r}")
176
+
177
+ path_params = {
178
+ "backupId": backup_id
179
+ }
180
+
181
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
182
+
183
+ for (k, v) in six.iteritems(path_params):
184
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
185
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
186
+
187
+ header_params = {
188
+ "accept": "application/json",
189
+ "content-type": "application/json",
190
+ "if-match": kwargs.get("if_match", missing),
191
+ "opc-request-id": kwargs.get("opc_request_id", missing),
192
+ "opc-retry-token": kwargs.get("opc_retry_token", missing)
193
+ }
194
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
195
+
196
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
197
+ operation_retry_strategy=kwargs.get('retry_strategy'),
198
+ client_retry_strategy=self.retry_strategy
199
+ )
200
+ if retry_strategy is None:
201
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
202
+
203
+ if retry_strategy:
204
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
205
+ self.base_client.add_opc_retry_token_if_needed(header_params)
206
+ self.base_client.add_opc_client_retries_header(header_params)
207
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
208
+ return retry_strategy.make_retrying_call(
209
+ self.base_client.call_api,
210
+ resource_path=resource_path,
211
+ method=method,
212
+ path_params=path_params,
213
+ header_params=header_params,
214
+ body=change_backup_compartment_details,
215
+ allow_control_chars=kwargs.get('allow_control_chars'),
216
+ operation_name=operation_name,
217
+ api_reference_link=api_reference_link,
218
+ required_arguments=required_arguments)
219
+ else:
220
+ return self.base_client.call_api(
221
+ resource_path=resource_path,
222
+ method=method,
223
+ path_params=path_params,
224
+ header_params=header_params,
225
+ body=change_backup_compartment_details,
226
+ allow_control_chars=kwargs.get('allow_control_chars'),
227
+ operation_name=operation_name,
228
+ api_reference_link=api_reference_link,
229
+ required_arguments=required_arguments)
230
+
231
+ def change_configuration_compartment(self, configuration_id, change_configuration_compartment_details, **kwargs):
232
+ """
233
+ Moves a Configuration resource from one compartment identifier to another. When provided, If-Match is checked against ETag values of the resource.
234
+
235
+
236
+ :param str configuration_id: (required)
237
+ unique Configuration identifier
238
+
239
+ :param oci.psql.models.ChangeConfigurationCompartmentDetails change_configuration_compartment_details: (required)
240
+ The information to be updated.
241
+
242
+ :param str if_match: (optional)
243
+ For optimistic concurrency control. In the PUT or DELETE call
244
+
245
+ :param str opc_request_id: (optional)
246
+ The client request ID for tracing.
247
+
248
+ :param str opc_retry_token: (optional)
249
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
250
+
251
+ :param obj retry_strategy: (optional)
252
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
253
+
254
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
255
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
256
+
257
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
258
+
259
+ :param bool allow_control_chars: (optional)
260
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
261
+ By default, the response will not allow control characters in strings
262
+
263
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.Configuration`
264
+ :rtype: :class:`~oci.response.Response`
265
+
266
+ :example:
267
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/change_configuration_compartment.py.html>`__ to see an example of how to use change_configuration_compartment API.
268
+ """
269
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
270
+ required_arguments = ['configurationId']
271
+ resource_path = "/configurations/{configurationId}/actions/changeCompartment"
272
+ method = "POST"
273
+ operation_name = "change_configuration_compartment"
274
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Configuration/ChangeConfigurationCompartment"
275
+
276
+ # Don't accept unknown kwargs
277
+ expected_kwargs = [
278
+ "allow_control_chars",
279
+ "retry_strategy",
280
+ "if_match",
281
+ "opc_request_id",
282
+ "opc_retry_token"
283
+ ]
284
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
285
+ if extra_kwargs:
286
+ raise ValueError(
287
+ f"change_configuration_compartment got unknown kwargs: {extra_kwargs!r}")
288
+
289
+ path_params = {
290
+ "configurationId": configuration_id
291
+ }
292
+
293
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
294
+
295
+ for (k, v) in six.iteritems(path_params):
296
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
297
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
298
+
299
+ header_params = {
300
+ "accept": "application/json",
301
+ "content-type": "application/json",
302
+ "if-match": kwargs.get("if_match", missing),
303
+ "opc-request-id": kwargs.get("opc_request_id", missing),
304
+ "opc-retry-token": kwargs.get("opc_retry_token", missing)
305
+ }
306
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
307
+
308
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
309
+ operation_retry_strategy=kwargs.get('retry_strategy'),
310
+ client_retry_strategy=self.retry_strategy
311
+ )
312
+ if retry_strategy is None:
313
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
314
+
315
+ if retry_strategy:
316
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
317
+ self.base_client.add_opc_retry_token_if_needed(header_params)
318
+ self.base_client.add_opc_client_retries_header(header_params)
319
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
320
+ return retry_strategy.make_retrying_call(
321
+ self.base_client.call_api,
322
+ resource_path=resource_path,
323
+ method=method,
324
+ path_params=path_params,
325
+ header_params=header_params,
326
+ body=change_configuration_compartment_details,
327
+ response_type="Configuration",
328
+ allow_control_chars=kwargs.get('allow_control_chars'),
329
+ operation_name=operation_name,
330
+ api_reference_link=api_reference_link,
331
+ required_arguments=required_arguments)
332
+ else:
333
+ return self.base_client.call_api(
334
+ resource_path=resource_path,
335
+ method=method,
336
+ path_params=path_params,
337
+ header_params=header_params,
338
+ body=change_configuration_compartment_details,
339
+ response_type="Configuration",
340
+ allow_control_chars=kwargs.get('allow_control_chars'),
341
+ operation_name=operation_name,
342
+ api_reference_link=api_reference_link,
343
+ required_arguments=required_arguments)
344
+
345
+ def change_db_system_compartment(self, db_system_id, change_db_system_compartment_details, **kwargs):
346
+ """
347
+ Moves a DbSystem resource from one compartment identifier to another. When provided, If-Match is checked against ETag values of the resource.
348
+
349
+
350
+ :param str db_system_id: (required)
351
+ unique DbSystem identifier
352
+
353
+ :param oci.psql.models.ChangeDbSystemCompartmentDetails change_db_system_compartment_details: (required)
354
+ The information to be updated.
355
+
356
+ :param str if_match: (optional)
357
+ For optimistic concurrency control. In the PUT or DELETE call
358
+
359
+ :param str opc_request_id: (optional)
360
+ The client request ID for tracing.
361
+
362
+ :param str opc_retry_token: (optional)
363
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
364
+
365
+ :param obj retry_strategy: (optional)
366
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
367
+
368
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
369
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
370
+
371
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
372
+
373
+ :param bool allow_control_chars: (optional)
374
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
375
+ By default, the response will not allow control characters in strings
376
+
377
+ :return: A :class:`~oci.response.Response` object with data of type None
378
+ :rtype: :class:`~oci.response.Response`
379
+
380
+ :example:
381
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/change_db_system_compartment.py.html>`__ to see an example of how to use change_db_system_compartment API.
382
+ """
383
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
384
+ required_arguments = ['dbSystemId']
385
+ resource_path = "/dbSystems/{dbSystemId}/actions/changeCompartment"
386
+ method = "POST"
387
+ operation_name = "change_db_system_compartment"
388
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/ChangeDbSystemCompartment"
389
+
390
+ # Don't accept unknown kwargs
391
+ expected_kwargs = [
392
+ "allow_control_chars",
393
+ "retry_strategy",
394
+ "if_match",
395
+ "opc_request_id",
396
+ "opc_retry_token"
397
+ ]
398
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
399
+ if extra_kwargs:
400
+ raise ValueError(
401
+ f"change_db_system_compartment got unknown kwargs: {extra_kwargs!r}")
402
+
403
+ path_params = {
404
+ "dbSystemId": db_system_id
405
+ }
406
+
407
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
408
+
409
+ for (k, v) in six.iteritems(path_params):
410
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
411
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
412
+
413
+ header_params = {
414
+ "accept": "application/json",
415
+ "content-type": "application/json",
416
+ "if-match": kwargs.get("if_match", missing),
417
+ "opc-request-id": kwargs.get("opc_request_id", missing),
418
+ "opc-retry-token": kwargs.get("opc_retry_token", missing)
419
+ }
420
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
421
+
422
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
423
+ operation_retry_strategy=kwargs.get('retry_strategy'),
424
+ client_retry_strategy=self.retry_strategy
425
+ )
426
+ if retry_strategy is None:
427
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
428
+
429
+ if retry_strategy:
430
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
431
+ self.base_client.add_opc_retry_token_if_needed(header_params)
432
+ self.base_client.add_opc_client_retries_header(header_params)
433
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
434
+ return retry_strategy.make_retrying_call(
435
+ self.base_client.call_api,
436
+ resource_path=resource_path,
437
+ method=method,
438
+ path_params=path_params,
439
+ header_params=header_params,
440
+ body=change_db_system_compartment_details,
441
+ allow_control_chars=kwargs.get('allow_control_chars'),
442
+ operation_name=operation_name,
443
+ api_reference_link=api_reference_link,
444
+ required_arguments=required_arguments)
445
+ else:
446
+ return self.base_client.call_api(
447
+ resource_path=resource_path,
448
+ method=method,
449
+ path_params=path_params,
450
+ header_params=header_params,
451
+ body=change_db_system_compartment_details,
452
+ allow_control_chars=kwargs.get('allow_control_chars'),
453
+ operation_name=operation_name,
454
+ api_reference_link=api_reference_link,
455
+ required_arguments=required_arguments)
456
+
457
+ def create_backup(self, create_backup_details, **kwargs):
458
+ """
459
+ Creates a new Backup.
460
+
461
+
462
+ :param oci.psql.models.CreateBackupDetails create_backup_details: (required)
463
+ Details for the new Backup.
464
+
465
+ :param str opc_retry_token: (optional)
466
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
467
+
468
+ :param str opc_request_id: (optional)
469
+ The client request ID for tracing.
470
+
471
+ :param obj retry_strategy: (optional)
472
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
473
+
474
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
475
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
476
+
477
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
478
+
479
+ :param bool allow_control_chars: (optional)
480
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
481
+ By default, the response will not allow control characters in strings
482
+
483
+ :return: A :class:`~oci.response.Response` object with data of type None
484
+ :rtype: :class:`~oci.response.Response`
485
+
486
+ :example:
487
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/create_backup.py.html>`__ to see an example of how to use create_backup API.
488
+ """
489
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
490
+ required_arguments = []
491
+ resource_path = "/backups"
492
+ method = "POST"
493
+ operation_name = "create_backup"
494
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Backup/CreateBackup"
495
+
496
+ # Don't accept unknown kwargs
497
+ expected_kwargs = [
498
+ "allow_control_chars",
499
+ "retry_strategy",
500
+ "opc_retry_token",
501
+ "opc_request_id"
502
+ ]
503
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
504
+ if extra_kwargs:
505
+ raise ValueError(
506
+ f"create_backup got unknown kwargs: {extra_kwargs!r}")
507
+
508
+ header_params = {
509
+ "accept": "application/json",
510
+ "content-type": "application/json",
511
+ "opc-retry-token": kwargs.get("opc_retry_token", missing),
512
+ "opc-request-id": kwargs.get("opc_request_id", missing)
513
+ }
514
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
515
+
516
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
517
+ operation_retry_strategy=kwargs.get('retry_strategy'),
518
+ client_retry_strategy=self.retry_strategy
519
+ )
520
+ if retry_strategy is None:
521
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
522
+
523
+ if retry_strategy:
524
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
525
+ self.base_client.add_opc_retry_token_if_needed(header_params)
526
+ self.base_client.add_opc_client_retries_header(header_params)
527
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
528
+ return retry_strategy.make_retrying_call(
529
+ self.base_client.call_api,
530
+ resource_path=resource_path,
531
+ method=method,
532
+ header_params=header_params,
533
+ body=create_backup_details,
534
+ allow_control_chars=kwargs.get('allow_control_chars'),
535
+ operation_name=operation_name,
536
+ api_reference_link=api_reference_link,
537
+ required_arguments=required_arguments)
538
+ else:
539
+ return self.base_client.call_api(
540
+ resource_path=resource_path,
541
+ method=method,
542
+ header_params=header_params,
543
+ body=create_backup_details,
544
+ allow_control_chars=kwargs.get('allow_control_chars'),
545
+ operation_name=operation_name,
546
+ api_reference_link=api_reference_link,
547
+ required_arguments=required_arguments)
548
+
549
+ def create_configuration(self, create_configuration_details, **kwargs):
550
+ """
551
+ Creates a new Configuration Set.
552
+
553
+
554
+ :param oci.psql.models.CreateConfigurationDetails create_configuration_details: (required)
555
+ Details for the new Configuration.
556
+
557
+ :param str opc_retry_token: (optional)
558
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
559
+
560
+ :param str opc_request_id: (optional)
561
+ The client request ID for tracing.
562
+
563
+ :param obj retry_strategy: (optional)
564
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
565
+
566
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
567
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
568
+
569
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
570
+
571
+ :param bool allow_control_chars: (optional)
572
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
573
+ By default, the response will not allow control characters in strings
574
+
575
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.Configuration`
576
+ :rtype: :class:`~oci.response.Response`
577
+
578
+ :example:
579
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/create_configuration.py.html>`__ to see an example of how to use create_configuration API.
580
+ """
581
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
582
+ required_arguments = []
583
+ resource_path = "/configurations"
584
+ method = "POST"
585
+ operation_name = "create_configuration"
586
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Configuration/CreateConfiguration"
587
+
588
+ # Don't accept unknown kwargs
589
+ expected_kwargs = [
590
+ "allow_control_chars",
591
+ "retry_strategy",
592
+ "opc_retry_token",
593
+ "opc_request_id"
594
+ ]
595
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
596
+ if extra_kwargs:
597
+ raise ValueError(
598
+ f"create_configuration got unknown kwargs: {extra_kwargs!r}")
599
+
600
+ header_params = {
601
+ "accept": "application/json",
602
+ "content-type": "application/json",
603
+ "opc-retry-token": kwargs.get("opc_retry_token", missing),
604
+ "opc-request-id": kwargs.get("opc_request_id", missing)
605
+ }
606
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
607
+
608
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
609
+ operation_retry_strategy=kwargs.get('retry_strategy'),
610
+ client_retry_strategy=self.retry_strategy
611
+ )
612
+ if retry_strategy is None:
613
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
614
+
615
+ if retry_strategy:
616
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
617
+ self.base_client.add_opc_retry_token_if_needed(header_params)
618
+ self.base_client.add_opc_client_retries_header(header_params)
619
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
620
+ return retry_strategy.make_retrying_call(
621
+ self.base_client.call_api,
622
+ resource_path=resource_path,
623
+ method=method,
624
+ header_params=header_params,
625
+ body=create_configuration_details,
626
+ response_type="Configuration",
627
+ allow_control_chars=kwargs.get('allow_control_chars'),
628
+ operation_name=operation_name,
629
+ api_reference_link=api_reference_link,
630
+ required_arguments=required_arguments)
631
+ else:
632
+ return self.base_client.call_api(
633
+ resource_path=resource_path,
634
+ method=method,
635
+ header_params=header_params,
636
+ body=create_configuration_details,
637
+ response_type="Configuration",
638
+ allow_control_chars=kwargs.get('allow_control_chars'),
639
+ operation_name=operation_name,
640
+ api_reference_link=api_reference_link,
641
+ required_arguments=required_arguments)
642
+
643
+ def create_db_system(self, create_db_system_details, **kwargs):
644
+ """
645
+ Creates a new DbSystem.
646
+
647
+
648
+ :param oci.psql.models.CreateDbSystemDetails create_db_system_details: (required)
649
+ Details for the new DbSystem.
650
+
651
+ :param str opc_retry_token: (optional)
652
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
653
+
654
+ :param str opc_request_id: (optional)
655
+ The client request ID for tracing.
656
+
657
+ :param obj retry_strategy: (optional)
658
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
659
+
660
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
661
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
662
+
663
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
664
+
665
+ :param bool allow_control_chars: (optional)
666
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
667
+ By default, the response will not allow control characters in strings
668
+
669
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.DbSystem`
670
+ :rtype: :class:`~oci.response.Response`
671
+
672
+ :example:
673
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/create_db_system.py.html>`__ to see an example of how to use create_db_system API.
674
+ """
675
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
676
+ required_arguments = []
677
+ resource_path = "/dbSystems"
678
+ method = "POST"
679
+ operation_name = "create_db_system"
680
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/CreateDbSystem"
681
+
682
+ # Don't accept unknown kwargs
683
+ expected_kwargs = [
684
+ "allow_control_chars",
685
+ "retry_strategy",
686
+ "opc_retry_token",
687
+ "opc_request_id"
688
+ ]
689
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
690
+ if extra_kwargs:
691
+ raise ValueError(
692
+ f"create_db_system got unknown kwargs: {extra_kwargs!r}")
693
+
694
+ header_params = {
695
+ "accept": "application/json",
696
+ "content-type": "application/json",
697
+ "opc-retry-token": kwargs.get("opc_retry_token", missing),
698
+ "opc-request-id": kwargs.get("opc_request_id", missing)
699
+ }
700
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
701
+
702
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
703
+ operation_retry_strategy=kwargs.get('retry_strategy'),
704
+ client_retry_strategy=self.retry_strategy
705
+ )
706
+ if retry_strategy is None:
707
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
708
+
709
+ if retry_strategy:
710
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
711
+ self.base_client.add_opc_retry_token_if_needed(header_params)
712
+ self.base_client.add_opc_client_retries_header(header_params)
713
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
714
+ return retry_strategy.make_retrying_call(
715
+ self.base_client.call_api,
716
+ resource_path=resource_path,
717
+ method=method,
718
+ header_params=header_params,
719
+ body=create_db_system_details,
720
+ response_type="DbSystem",
721
+ allow_control_chars=kwargs.get('allow_control_chars'),
722
+ operation_name=operation_name,
723
+ api_reference_link=api_reference_link,
724
+ required_arguments=required_arguments)
725
+ else:
726
+ return self.base_client.call_api(
727
+ resource_path=resource_path,
728
+ method=method,
729
+ header_params=header_params,
730
+ body=create_db_system_details,
731
+ response_type="DbSystem",
732
+ allow_control_chars=kwargs.get('allow_control_chars'),
733
+ operation_name=operation_name,
734
+ api_reference_link=api_reference_link,
735
+ required_arguments=required_arguments)
736
+
737
+ def delete_backup(self, backup_id, **kwargs):
738
+ """
739
+ Deletes a Backup resource by identifier
740
+
741
+
742
+ :param str backup_id: (required)
743
+ unique Backup identifier
744
+
745
+ :param str if_match: (optional)
746
+ For optimistic concurrency control. In the PUT or DELETE call
747
+
748
+ :param str opc_request_id: (optional)
749
+ The client request ID for tracing.
750
+
751
+ :param obj retry_strategy: (optional)
752
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
753
+
754
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
755
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
756
+
757
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
758
+
759
+ :param bool allow_control_chars: (optional)
760
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
761
+ By default, the response will not allow control characters in strings
762
+
763
+ :return: A :class:`~oci.response.Response` object with data of type None
764
+ :rtype: :class:`~oci.response.Response`
765
+
766
+ :example:
767
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/delete_backup.py.html>`__ to see an example of how to use delete_backup API.
768
+ """
769
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
770
+ required_arguments = ['backupId']
771
+ resource_path = "/backups/{backupId}"
772
+ method = "DELETE"
773
+ operation_name = "delete_backup"
774
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Backup/DeleteBackup"
775
+
776
+ # Don't accept unknown kwargs
777
+ expected_kwargs = [
778
+ "allow_control_chars",
779
+ "retry_strategy",
780
+ "if_match",
781
+ "opc_request_id"
782
+ ]
783
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
784
+ if extra_kwargs:
785
+ raise ValueError(
786
+ f"delete_backup got unknown kwargs: {extra_kwargs!r}")
787
+
788
+ path_params = {
789
+ "backupId": backup_id
790
+ }
791
+
792
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
793
+
794
+ for (k, v) in six.iteritems(path_params):
795
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
796
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
797
+
798
+ header_params = {
799
+ "accept": "application/json",
800
+ "content-type": "application/json",
801
+ "if-match": kwargs.get("if_match", missing),
802
+ "opc-request-id": kwargs.get("opc_request_id", missing)
803
+ }
804
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
805
+
806
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
807
+ operation_retry_strategy=kwargs.get('retry_strategy'),
808
+ client_retry_strategy=self.retry_strategy
809
+ )
810
+ if retry_strategy is None:
811
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
812
+
813
+ if retry_strategy:
814
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
815
+ self.base_client.add_opc_client_retries_header(header_params)
816
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
817
+ return retry_strategy.make_retrying_call(
818
+ self.base_client.call_api,
819
+ resource_path=resource_path,
820
+ method=method,
821
+ path_params=path_params,
822
+ header_params=header_params,
823
+ allow_control_chars=kwargs.get('allow_control_chars'),
824
+ operation_name=operation_name,
825
+ api_reference_link=api_reference_link,
826
+ required_arguments=required_arguments)
827
+ else:
828
+ return self.base_client.call_api(
829
+ resource_path=resource_path,
830
+ method=method,
831
+ path_params=path_params,
832
+ header_params=header_params,
833
+ allow_control_chars=kwargs.get('allow_control_chars'),
834
+ operation_name=operation_name,
835
+ api_reference_link=api_reference_link,
836
+ required_arguments=required_arguments)
837
+
838
+ def delete_configuration(self, configuration_id, **kwargs):
839
+ """
840
+ Deletes a Cofniguration resource by identifier
841
+
842
+
843
+ :param str configuration_id: (required)
844
+ unique Configuration identifier
845
+
846
+ :param str if_match: (optional)
847
+ For optimistic concurrency control. In the PUT or DELETE call
848
+
849
+ :param str opc_request_id: (optional)
850
+ The client request ID for tracing.
851
+
852
+ :param obj retry_strategy: (optional)
853
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
854
+
855
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
856
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
857
+
858
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
859
+
860
+ :param bool allow_control_chars: (optional)
861
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
862
+ By default, the response will not allow control characters in strings
863
+
864
+ :return: A :class:`~oci.response.Response` object with data of type None
865
+ :rtype: :class:`~oci.response.Response`
866
+
867
+ :example:
868
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/delete_configuration.py.html>`__ to see an example of how to use delete_configuration API.
869
+ """
870
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
871
+ required_arguments = ['configurationId']
872
+ resource_path = "/configurations/{configurationId}"
873
+ method = "DELETE"
874
+ operation_name = "delete_configuration"
875
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Configuration/DeleteConfiguration"
876
+
877
+ # Don't accept unknown kwargs
878
+ expected_kwargs = [
879
+ "allow_control_chars",
880
+ "retry_strategy",
881
+ "if_match",
882
+ "opc_request_id"
883
+ ]
884
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
885
+ if extra_kwargs:
886
+ raise ValueError(
887
+ f"delete_configuration got unknown kwargs: {extra_kwargs!r}")
888
+
889
+ path_params = {
890
+ "configurationId": configuration_id
891
+ }
892
+
893
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
894
+
895
+ for (k, v) in six.iteritems(path_params):
896
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
897
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
898
+
899
+ header_params = {
900
+ "accept": "application/json",
901
+ "content-type": "application/json",
902
+ "if-match": kwargs.get("if_match", missing),
903
+ "opc-request-id": kwargs.get("opc_request_id", missing)
904
+ }
905
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
906
+
907
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
908
+ operation_retry_strategy=kwargs.get('retry_strategy'),
909
+ client_retry_strategy=self.retry_strategy
910
+ )
911
+ if retry_strategy is None:
912
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
913
+
914
+ if retry_strategy:
915
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
916
+ self.base_client.add_opc_client_retries_header(header_params)
917
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
918
+ return retry_strategy.make_retrying_call(
919
+ self.base_client.call_api,
920
+ resource_path=resource_path,
921
+ method=method,
922
+ path_params=path_params,
923
+ header_params=header_params,
924
+ allow_control_chars=kwargs.get('allow_control_chars'),
925
+ operation_name=operation_name,
926
+ api_reference_link=api_reference_link,
927
+ required_arguments=required_arguments)
928
+ else:
929
+ return self.base_client.call_api(
930
+ resource_path=resource_path,
931
+ method=method,
932
+ path_params=path_params,
933
+ header_params=header_params,
934
+ allow_control_chars=kwargs.get('allow_control_chars'),
935
+ operation_name=operation_name,
936
+ api_reference_link=api_reference_link,
937
+ required_arguments=required_arguments)
938
+
939
+ def delete_db_system(self, db_system_id, **kwargs):
940
+ """
941
+ Deletes a DbSystem resource by identifier
942
+
943
+
944
+ :param str db_system_id: (required)
945
+ unique DbSystem identifier
946
+
947
+ :param str if_match: (optional)
948
+ For optimistic concurrency control. In the PUT or DELETE call
949
+
950
+ :param str opc_request_id: (optional)
951
+ The client request ID for tracing.
952
+
953
+ :param obj retry_strategy: (optional)
954
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
955
+
956
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
957
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
958
+
959
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
960
+
961
+ :param bool allow_control_chars: (optional)
962
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
963
+ By default, the response will not allow control characters in strings
964
+
965
+ :return: A :class:`~oci.response.Response` object with data of type None
966
+ :rtype: :class:`~oci.response.Response`
967
+
968
+ :example:
969
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/delete_db_system.py.html>`__ to see an example of how to use delete_db_system API.
970
+ """
971
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
972
+ required_arguments = ['dbSystemId']
973
+ resource_path = "/dbSystems/{dbSystemId}"
974
+ method = "DELETE"
975
+ operation_name = "delete_db_system"
976
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/DeleteDbSystem"
977
+
978
+ # Don't accept unknown kwargs
979
+ expected_kwargs = [
980
+ "allow_control_chars",
981
+ "retry_strategy",
982
+ "if_match",
983
+ "opc_request_id"
984
+ ]
985
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
986
+ if extra_kwargs:
987
+ raise ValueError(
988
+ f"delete_db_system got unknown kwargs: {extra_kwargs!r}")
989
+
990
+ path_params = {
991
+ "dbSystemId": db_system_id
992
+ }
993
+
994
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
995
+
996
+ for (k, v) in six.iteritems(path_params):
997
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
998
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
999
+
1000
+ header_params = {
1001
+ "accept": "application/json",
1002
+ "content-type": "application/json",
1003
+ "if-match": kwargs.get("if_match", missing),
1004
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1005
+ }
1006
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1007
+
1008
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1009
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1010
+ client_retry_strategy=self.retry_strategy
1011
+ )
1012
+ if retry_strategy is None:
1013
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
1014
+
1015
+ if retry_strategy:
1016
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1017
+ self.base_client.add_opc_client_retries_header(header_params)
1018
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1019
+ return retry_strategy.make_retrying_call(
1020
+ self.base_client.call_api,
1021
+ resource_path=resource_path,
1022
+ method=method,
1023
+ path_params=path_params,
1024
+ header_params=header_params,
1025
+ allow_control_chars=kwargs.get('allow_control_chars'),
1026
+ operation_name=operation_name,
1027
+ api_reference_link=api_reference_link,
1028
+ required_arguments=required_arguments)
1029
+ else:
1030
+ return self.base_client.call_api(
1031
+ resource_path=resource_path,
1032
+ method=method,
1033
+ path_params=path_params,
1034
+ header_params=header_params,
1035
+ allow_control_chars=kwargs.get('allow_control_chars'),
1036
+ operation_name=operation_name,
1037
+ api_reference_link=api_reference_link,
1038
+ required_arguments=required_arguments)
1039
+
1040
+ def failover_db_system(self, db_system_id, failover_db_system_details, **kwargs):
1041
+ """
1042
+ Runs a failover operation. Optionally user can specify the desired AD for 3AD regions.
1043
+
1044
+
1045
+ :param str db_system_id: (required)
1046
+ unique DbSystem identifier
1047
+
1048
+ :param oci.psql.models.FailoverDbSystemDetails failover_db_system_details: (required)
1049
+ The information to be updated.
1050
+
1051
+ :param str if_match: (optional)
1052
+ For optimistic concurrency control. In the PUT or DELETE call
1053
+
1054
+ :param str opc_request_id: (optional)
1055
+ The client request ID for tracing.
1056
+
1057
+ :param str opc_retry_token: (optional)
1058
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
1059
+
1060
+ :param obj retry_strategy: (optional)
1061
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1062
+
1063
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
1064
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1065
+
1066
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1067
+
1068
+ :param bool allow_control_chars: (optional)
1069
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1070
+ By default, the response will not allow control characters in strings
1071
+
1072
+ :return: A :class:`~oci.response.Response` object with data of type None
1073
+ :rtype: :class:`~oci.response.Response`
1074
+
1075
+ :example:
1076
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/failover_db_system.py.html>`__ to see an example of how to use failover_db_system API.
1077
+ """
1078
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1079
+ required_arguments = ['dbSystemId']
1080
+ resource_path = "/dbSystems/{dbSystemId}/actions/failover"
1081
+ method = "POST"
1082
+ operation_name = "failover_db_system"
1083
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/FailoverDbSystem"
1084
+
1085
+ # Don't accept unknown kwargs
1086
+ expected_kwargs = [
1087
+ "allow_control_chars",
1088
+ "retry_strategy",
1089
+ "if_match",
1090
+ "opc_request_id",
1091
+ "opc_retry_token"
1092
+ ]
1093
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1094
+ if extra_kwargs:
1095
+ raise ValueError(
1096
+ f"failover_db_system got unknown kwargs: {extra_kwargs!r}")
1097
+
1098
+ path_params = {
1099
+ "dbSystemId": db_system_id
1100
+ }
1101
+
1102
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
1103
+
1104
+ for (k, v) in six.iteritems(path_params):
1105
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
1106
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
1107
+
1108
+ header_params = {
1109
+ "accept": "application/json",
1110
+ "content-type": "application/json",
1111
+ "if-match": kwargs.get("if_match", missing),
1112
+ "opc-request-id": kwargs.get("opc_request_id", missing),
1113
+ "opc-retry-token": kwargs.get("opc_retry_token", missing)
1114
+ }
1115
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1116
+
1117
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1118
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1119
+ client_retry_strategy=self.retry_strategy
1120
+ )
1121
+ if retry_strategy is None:
1122
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
1123
+
1124
+ if retry_strategy:
1125
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1126
+ self.base_client.add_opc_retry_token_if_needed(header_params)
1127
+ self.base_client.add_opc_client_retries_header(header_params)
1128
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1129
+ return retry_strategy.make_retrying_call(
1130
+ self.base_client.call_api,
1131
+ resource_path=resource_path,
1132
+ method=method,
1133
+ path_params=path_params,
1134
+ header_params=header_params,
1135
+ body=failover_db_system_details,
1136
+ allow_control_chars=kwargs.get('allow_control_chars'),
1137
+ operation_name=operation_name,
1138
+ api_reference_link=api_reference_link,
1139
+ required_arguments=required_arguments)
1140
+ else:
1141
+ return self.base_client.call_api(
1142
+ resource_path=resource_path,
1143
+ method=method,
1144
+ path_params=path_params,
1145
+ header_params=header_params,
1146
+ body=failover_db_system_details,
1147
+ allow_control_chars=kwargs.get('allow_control_chars'),
1148
+ operation_name=operation_name,
1149
+ api_reference_link=api_reference_link,
1150
+ required_arguments=required_arguments)
1151
+
1152
+ def get_backup(self, backup_id, **kwargs):
1153
+ """
1154
+ Gets a Backup by identifier
1155
+
1156
+
1157
+ :param str backup_id: (required)
1158
+ unique Backup identifier
1159
+
1160
+ :param str opc_request_id: (optional)
1161
+ The client request ID for tracing.
1162
+
1163
+ :param obj retry_strategy: (optional)
1164
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1165
+
1166
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
1167
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1168
+
1169
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1170
+
1171
+ :param bool allow_control_chars: (optional)
1172
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1173
+ By default, the response will not allow control characters in strings
1174
+
1175
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.Backup`
1176
+ :rtype: :class:`~oci.response.Response`
1177
+
1178
+ :example:
1179
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/get_backup.py.html>`__ to see an example of how to use get_backup API.
1180
+ """
1181
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1182
+ required_arguments = ['backupId']
1183
+ resource_path = "/backups/{backupId}"
1184
+ method = "GET"
1185
+ operation_name = "get_backup"
1186
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Backup/GetBackup"
1187
+
1188
+ # Don't accept unknown kwargs
1189
+ expected_kwargs = [
1190
+ "allow_control_chars",
1191
+ "retry_strategy",
1192
+ "opc_request_id"
1193
+ ]
1194
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1195
+ if extra_kwargs:
1196
+ raise ValueError(
1197
+ f"get_backup got unknown kwargs: {extra_kwargs!r}")
1198
+
1199
+ path_params = {
1200
+ "backupId": backup_id
1201
+ }
1202
+
1203
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
1204
+
1205
+ for (k, v) in six.iteritems(path_params):
1206
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
1207
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
1208
+
1209
+ header_params = {
1210
+ "accept": "application/json",
1211
+ "content-type": "application/json",
1212
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1213
+ }
1214
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1215
+
1216
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1217
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1218
+ client_retry_strategy=self.retry_strategy
1219
+ )
1220
+ if retry_strategy is None:
1221
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
1222
+
1223
+ if retry_strategy:
1224
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1225
+ self.base_client.add_opc_client_retries_header(header_params)
1226
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1227
+ return retry_strategy.make_retrying_call(
1228
+ self.base_client.call_api,
1229
+ resource_path=resource_path,
1230
+ method=method,
1231
+ path_params=path_params,
1232
+ header_params=header_params,
1233
+ response_type="Backup",
1234
+ allow_control_chars=kwargs.get('allow_control_chars'),
1235
+ operation_name=operation_name,
1236
+ api_reference_link=api_reference_link,
1237
+ required_arguments=required_arguments)
1238
+ else:
1239
+ return self.base_client.call_api(
1240
+ resource_path=resource_path,
1241
+ method=method,
1242
+ path_params=path_params,
1243
+ header_params=header_params,
1244
+ response_type="Backup",
1245
+ allow_control_chars=kwargs.get('allow_control_chars'),
1246
+ operation_name=operation_name,
1247
+ api_reference_link=api_reference_link,
1248
+ required_arguments=required_arguments)
1249
+
1250
+ def get_configuration(self, configuration_id, **kwargs):
1251
+ """
1252
+ Gets a Configuration by identifier
1253
+
1254
+
1255
+ :param str configuration_id: (required)
1256
+ unique Configuration identifier
1257
+
1258
+ :param str opc_request_id: (optional)
1259
+ The client request ID for tracing.
1260
+
1261
+ :param obj retry_strategy: (optional)
1262
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1263
+
1264
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
1265
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1266
+
1267
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1268
+
1269
+ :param bool allow_control_chars: (optional)
1270
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1271
+ By default, the response will not allow control characters in strings
1272
+
1273
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.Configuration`
1274
+ :rtype: :class:`~oci.response.Response`
1275
+
1276
+ :example:
1277
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/get_configuration.py.html>`__ to see an example of how to use get_configuration API.
1278
+ """
1279
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1280
+ required_arguments = ['configurationId']
1281
+ resource_path = "/configurations/{configurationId}"
1282
+ method = "GET"
1283
+ operation_name = "get_configuration"
1284
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Configuration/GetConfiguration"
1285
+
1286
+ # Don't accept unknown kwargs
1287
+ expected_kwargs = [
1288
+ "allow_control_chars",
1289
+ "retry_strategy",
1290
+ "opc_request_id"
1291
+ ]
1292
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1293
+ if extra_kwargs:
1294
+ raise ValueError(
1295
+ f"get_configuration got unknown kwargs: {extra_kwargs!r}")
1296
+
1297
+ path_params = {
1298
+ "configurationId": configuration_id
1299
+ }
1300
+
1301
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
1302
+
1303
+ for (k, v) in six.iteritems(path_params):
1304
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
1305
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
1306
+
1307
+ header_params = {
1308
+ "accept": "application/json",
1309
+ "content-type": "application/json",
1310
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1311
+ }
1312
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1313
+
1314
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1315
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1316
+ client_retry_strategy=self.retry_strategy
1317
+ )
1318
+ if retry_strategy is None:
1319
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
1320
+
1321
+ if retry_strategy:
1322
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1323
+ self.base_client.add_opc_client_retries_header(header_params)
1324
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1325
+ return retry_strategy.make_retrying_call(
1326
+ self.base_client.call_api,
1327
+ resource_path=resource_path,
1328
+ method=method,
1329
+ path_params=path_params,
1330
+ header_params=header_params,
1331
+ response_type="Configuration",
1332
+ allow_control_chars=kwargs.get('allow_control_chars'),
1333
+ operation_name=operation_name,
1334
+ api_reference_link=api_reference_link,
1335
+ required_arguments=required_arguments)
1336
+ else:
1337
+ return self.base_client.call_api(
1338
+ resource_path=resource_path,
1339
+ method=method,
1340
+ path_params=path_params,
1341
+ header_params=header_params,
1342
+ response_type="Configuration",
1343
+ allow_control_chars=kwargs.get('allow_control_chars'),
1344
+ operation_name=operation_name,
1345
+ api_reference_link=api_reference_link,
1346
+ required_arguments=required_arguments)
1347
+
1348
+ def get_connection_details(self, db_system_id, **kwargs):
1349
+ """
1350
+ Gets the DbSystem connection details.
1351
+
1352
+
1353
+ :param str db_system_id: (required)
1354
+ unique DbSystem identifier
1355
+
1356
+ :param str opc_request_id: (optional)
1357
+ The client request ID for tracing.
1358
+
1359
+ :param obj retry_strategy: (optional)
1360
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1361
+
1362
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
1363
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1364
+
1365
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1366
+
1367
+ :param bool allow_control_chars: (optional)
1368
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1369
+ By default, the response will not allow control characters in strings
1370
+
1371
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.ConnectionDetails`
1372
+ :rtype: :class:`~oci.response.Response`
1373
+
1374
+ :example:
1375
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/get_connection_details.py.html>`__ to see an example of how to use get_connection_details API.
1376
+ """
1377
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1378
+ required_arguments = ['dbSystemId']
1379
+ resource_path = "/dbSystems/{dbSystemId}/connectionDetails"
1380
+ method = "GET"
1381
+ operation_name = "get_connection_details"
1382
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/ConnectionDetails/GetConnectionDetails"
1383
+
1384
+ # Don't accept unknown kwargs
1385
+ expected_kwargs = [
1386
+ "allow_control_chars",
1387
+ "retry_strategy",
1388
+ "opc_request_id"
1389
+ ]
1390
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1391
+ if extra_kwargs:
1392
+ raise ValueError(
1393
+ f"get_connection_details got unknown kwargs: {extra_kwargs!r}")
1394
+
1395
+ path_params = {
1396
+ "dbSystemId": db_system_id
1397
+ }
1398
+
1399
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
1400
+
1401
+ for (k, v) in six.iteritems(path_params):
1402
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
1403
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
1404
+
1405
+ header_params = {
1406
+ "accept": "application/json",
1407
+ "content-type": "application/json",
1408
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1409
+ }
1410
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1411
+
1412
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1413
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1414
+ client_retry_strategy=self.retry_strategy
1415
+ )
1416
+ if retry_strategy is None:
1417
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
1418
+
1419
+ if retry_strategy:
1420
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1421
+ self.base_client.add_opc_client_retries_header(header_params)
1422
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1423
+ return retry_strategy.make_retrying_call(
1424
+ self.base_client.call_api,
1425
+ resource_path=resource_path,
1426
+ method=method,
1427
+ path_params=path_params,
1428
+ header_params=header_params,
1429
+ response_type="ConnectionDetails",
1430
+ allow_control_chars=kwargs.get('allow_control_chars'),
1431
+ operation_name=operation_name,
1432
+ api_reference_link=api_reference_link,
1433
+ required_arguments=required_arguments)
1434
+ else:
1435
+ return self.base_client.call_api(
1436
+ resource_path=resource_path,
1437
+ method=method,
1438
+ path_params=path_params,
1439
+ header_params=header_params,
1440
+ response_type="ConnectionDetails",
1441
+ allow_control_chars=kwargs.get('allow_control_chars'),
1442
+ operation_name=operation_name,
1443
+ api_reference_link=api_reference_link,
1444
+ required_arguments=required_arguments)
1445
+
1446
+ def get_db_system(self, db_system_id, **kwargs):
1447
+ """
1448
+ Gets a DbSystem by identifier
1449
+
1450
+
1451
+ :param str db_system_id: (required)
1452
+ unique DbSystem identifier
1453
+
1454
+ :param str opc_request_id: (optional)
1455
+ The client request ID for tracing.
1456
+
1457
+ :param list[str] excluded_fields: (optional)
1458
+ A filter to exclude DB config when this query param is set to OverrideDbConfig
1459
+
1460
+ Allowed values are: "dbConfigurationParams"
1461
+
1462
+ :param obj retry_strategy: (optional)
1463
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1464
+
1465
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
1466
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1467
+
1468
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1469
+
1470
+ :param bool allow_control_chars: (optional)
1471
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1472
+ By default, the response will not allow control characters in strings
1473
+
1474
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.DbSystem`
1475
+ :rtype: :class:`~oci.response.Response`
1476
+
1477
+ :example:
1478
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/get_db_system.py.html>`__ to see an example of how to use get_db_system API.
1479
+ """
1480
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1481
+ required_arguments = ['dbSystemId']
1482
+ resource_path = "/dbSystems/{dbSystemId}"
1483
+ method = "GET"
1484
+ operation_name = "get_db_system"
1485
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/GetDbSystem"
1486
+
1487
+ # Don't accept unknown kwargs
1488
+ expected_kwargs = [
1489
+ "allow_control_chars",
1490
+ "retry_strategy",
1491
+ "opc_request_id",
1492
+ "excluded_fields"
1493
+ ]
1494
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1495
+ if extra_kwargs:
1496
+ raise ValueError(
1497
+ f"get_db_system got unknown kwargs: {extra_kwargs!r}")
1498
+
1499
+ path_params = {
1500
+ "dbSystemId": db_system_id
1501
+ }
1502
+
1503
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
1504
+
1505
+ for (k, v) in six.iteritems(path_params):
1506
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
1507
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
1508
+
1509
+ if 'excluded_fields' in kwargs:
1510
+ excluded_fields_allowed_values = ["dbConfigurationParams"]
1511
+ for excluded_fields_item in kwargs['excluded_fields']:
1512
+ if excluded_fields_item not in excluded_fields_allowed_values:
1513
+ raise ValueError(
1514
+ f"Invalid value for `excluded_fields`, must be one of { excluded_fields_allowed_values }"
1515
+ )
1516
+
1517
+ query_params = {
1518
+ "excludedFields": self.base_client.generate_collection_format_param(kwargs.get("excluded_fields", missing), 'multi')
1519
+ }
1520
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
1521
+
1522
+ header_params = {
1523
+ "accept": "application/json",
1524
+ "content-type": "application/json",
1525
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1526
+ }
1527
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1528
+
1529
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1530
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1531
+ client_retry_strategy=self.retry_strategy
1532
+ )
1533
+ if retry_strategy is None:
1534
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
1535
+
1536
+ if retry_strategy:
1537
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1538
+ self.base_client.add_opc_client_retries_header(header_params)
1539
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1540
+ return retry_strategy.make_retrying_call(
1541
+ self.base_client.call_api,
1542
+ resource_path=resource_path,
1543
+ method=method,
1544
+ path_params=path_params,
1545
+ query_params=query_params,
1546
+ header_params=header_params,
1547
+ response_type="DbSystem",
1548
+ allow_control_chars=kwargs.get('allow_control_chars'),
1549
+ operation_name=operation_name,
1550
+ api_reference_link=api_reference_link,
1551
+ required_arguments=required_arguments)
1552
+ else:
1553
+ return self.base_client.call_api(
1554
+ resource_path=resource_path,
1555
+ method=method,
1556
+ path_params=path_params,
1557
+ query_params=query_params,
1558
+ header_params=header_params,
1559
+ response_type="DbSystem",
1560
+ allow_control_chars=kwargs.get('allow_control_chars'),
1561
+ operation_name=operation_name,
1562
+ api_reference_link=api_reference_link,
1563
+ required_arguments=required_arguments)
1564
+
1565
+ def get_default_configuration(self, default_configuration_id, **kwargs):
1566
+ """
1567
+ Gets a Default Configuration by identifier
1568
+
1569
+
1570
+ :param str default_configuration_id: (required)
1571
+ unique Configuration identifier
1572
+
1573
+ :param str opc_request_id: (optional)
1574
+ The client request ID for tracing.
1575
+
1576
+ :param obj retry_strategy: (optional)
1577
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1578
+
1579
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
1580
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1581
+
1582
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1583
+
1584
+ :param bool allow_control_chars: (optional)
1585
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1586
+ By default, the response will not allow control characters in strings
1587
+
1588
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.DefaultConfiguration`
1589
+ :rtype: :class:`~oci.response.Response`
1590
+
1591
+ :example:
1592
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/get_default_configuration.py.html>`__ to see an example of how to use get_default_configuration API.
1593
+ """
1594
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1595
+ required_arguments = ['defaultConfigurationId']
1596
+ resource_path = "/defaultConfigurations/{defaultConfigurationId}"
1597
+ method = "GET"
1598
+ operation_name = "get_default_configuration"
1599
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DefaultConfiguration/GetDefaultConfiguration"
1600
+
1601
+ # Don't accept unknown kwargs
1602
+ expected_kwargs = [
1603
+ "allow_control_chars",
1604
+ "retry_strategy",
1605
+ "opc_request_id"
1606
+ ]
1607
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1608
+ if extra_kwargs:
1609
+ raise ValueError(
1610
+ f"get_default_configuration got unknown kwargs: {extra_kwargs!r}")
1611
+
1612
+ path_params = {
1613
+ "defaultConfigurationId": default_configuration_id
1614
+ }
1615
+
1616
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
1617
+
1618
+ for (k, v) in six.iteritems(path_params):
1619
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
1620
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
1621
+
1622
+ header_params = {
1623
+ "accept": "application/json",
1624
+ "content-type": "application/json",
1625
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1626
+ }
1627
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1628
+
1629
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1630
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1631
+ client_retry_strategy=self.retry_strategy
1632
+ )
1633
+ if retry_strategy is None:
1634
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
1635
+
1636
+ if retry_strategy:
1637
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1638
+ self.base_client.add_opc_client_retries_header(header_params)
1639
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1640
+ return retry_strategy.make_retrying_call(
1641
+ self.base_client.call_api,
1642
+ resource_path=resource_path,
1643
+ method=method,
1644
+ path_params=path_params,
1645
+ header_params=header_params,
1646
+ response_type="DefaultConfiguration",
1647
+ allow_control_chars=kwargs.get('allow_control_chars'),
1648
+ operation_name=operation_name,
1649
+ api_reference_link=api_reference_link,
1650
+ required_arguments=required_arguments)
1651
+ else:
1652
+ return self.base_client.call_api(
1653
+ resource_path=resource_path,
1654
+ method=method,
1655
+ path_params=path_params,
1656
+ header_params=header_params,
1657
+ response_type="DefaultConfiguration",
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
+
1663
+ def get_primary_db_instance(self, db_system_id, **kwargs):
1664
+ """
1665
+ Gets the primary DbInstance details.
1666
+
1667
+
1668
+ :param str db_system_id: (required)
1669
+ unique DbSystem identifier
1670
+
1671
+ :param str opc_request_id: (optional)
1672
+ The client request ID for tracing.
1673
+
1674
+ :param obj retry_strategy: (optional)
1675
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1676
+
1677
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
1678
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1679
+
1680
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1681
+
1682
+ :param bool allow_control_chars: (optional)
1683
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1684
+ By default, the response will not allow control characters in strings
1685
+
1686
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.PrimaryDbInstanceDetails`
1687
+ :rtype: :class:`~oci.response.Response`
1688
+
1689
+ :example:
1690
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/get_primary_db_instance.py.html>`__ to see an example of how to use get_primary_db_instance API.
1691
+ """
1692
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1693
+ required_arguments = ['dbSystemId']
1694
+ resource_path = "/dbSystems/{dbSystemId}/primaryDbInstance"
1695
+ method = "GET"
1696
+ operation_name = "get_primary_db_instance"
1697
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/GetPrimaryDbInstance"
1698
+
1699
+ # Don't accept unknown kwargs
1700
+ expected_kwargs = [
1701
+ "allow_control_chars",
1702
+ "retry_strategy",
1703
+ "opc_request_id"
1704
+ ]
1705
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1706
+ if extra_kwargs:
1707
+ raise ValueError(
1708
+ f"get_primary_db_instance got unknown kwargs: {extra_kwargs!r}")
1709
+
1710
+ path_params = {
1711
+ "dbSystemId": db_system_id
1712
+ }
1713
+
1714
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
1715
+
1716
+ for (k, v) in six.iteritems(path_params):
1717
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
1718
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
1719
+
1720
+ header_params = {
1721
+ "accept": "application/json",
1722
+ "content-type": "application/json",
1723
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1724
+ }
1725
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1726
+
1727
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1728
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1729
+ client_retry_strategy=self.retry_strategy
1730
+ )
1731
+ if retry_strategy is None:
1732
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
1733
+
1734
+ if retry_strategy:
1735
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1736
+ self.base_client.add_opc_client_retries_header(header_params)
1737
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1738
+ return retry_strategy.make_retrying_call(
1739
+ self.base_client.call_api,
1740
+ resource_path=resource_path,
1741
+ method=method,
1742
+ path_params=path_params,
1743
+ header_params=header_params,
1744
+ response_type="PrimaryDbInstanceDetails",
1745
+ allow_control_chars=kwargs.get('allow_control_chars'),
1746
+ operation_name=operation_name,
1747
+ api_reference_link=api_reference_link,
1748
+ required_arguments=required_arguments)
1749
+ else:
1750
+ return self.base_client.call_api(
1751
+ resource_path=resource_path,
1752
+ method=method,
1753
+ path_params=path_params,
1754
+ header_params=header_params,
1755
+ response_type="PrimaryDbInstanceDetails",
1756
+ allow_control_chars=kwargs.get('allow_control_chars'),
1757
+ operation_name=operation_name,
1758
+ api_reference_link=api_reference_link,
1759
+ required_arguments=required_arguments)
1760
+
1761
+ def get_work_request(self, work_request_id, **kwargs):
1762
+ """
1763
+ Gets details of the work request with the given ID.
1764
+
1765
+
1766
+ :param str work_request_id: (required)
1767
+ The ID of the asynchronous request.
1768
+
1769
+ :param str opc_request_id: (optional)
1770
+ The client request ID for tracing.
1771
+
1772
+ :param obj retry_strategy: (optional)
1773
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1774
+
1775
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
1776
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1777
+
1778
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1779
+
1780
+ :param bool allow_control_chars: (optional)
1781
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1782
+ By default, the response will not allow control characters in strings
1783
+
1784
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.WorkRequest`
1785
+ :rtype: :class:`~oci.response.Response`
1786
+
1787
+ :example:
1788
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/get_work_request.py.html>`__ to see an example of how to use get_work_request API.
1789
+ """
1790
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1791
+ required_arguments = ['workRequestId']
1792
+ resource_path = "/workRequests/{workRequestId}"
1793
+ method = "GET"
1794
+ operation_name = "get_work_request"
1795
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/WorkRequest/GetWorkRequest"
1796
+
1797
+ # Don't accept unknown kwargs
1798
+ expected_kwargs = [
1799
+ "allow_control_chars",
1800
+ "retry_strategy",
1801
+ "opc_request_id"
1802
+ ]
1803
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1804
+ if extra_kwargs:
1805
+ raise ValueError(
1806
+ f"get_work_request got unknown kwargs: {extra_kwargs!r}")
1807
+
1808
+ path_params = {
1809
+ "workRequestId": work_request_id
1810
+ }
1811
+
1812
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
1813
+
1814
+ for (k, v) in six.iteritems(path_params):
1815
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
1816
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
1817
+
1818
+ header_params = {
1819
+ "accept": "application/json",
1820
+ "content-type": "application/json",
1821
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1822
+ }
1823
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1824
+
1825
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1826
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1827
+ client_retry_strategy=self.retry_strategy
1828
+ )
1829
+ if retry_strategy is None:
1830
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
1831
+
1832
+ if retry_strategy:
1833
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
1834
+ self.base_client.add_opc_client_retries_header(header_params)
1835
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
1836
+ return retry_strategy.make_retrying_call(
1837
+ self.base_client.call_api,
1838
+ resource_path=resource_path,
1839
+ method=method,
1840
+ path_params=path_params,
1841
+ header_params=header_params,
1842
+ response_type="WorkRequest",
1843
+ allow_control_chars=kwargs.get('allow_control_chars'),
1844
+ operation_name=operation_name,
1845
+ api_reference_link=api_reference_link,
1846
+ required_arguments=required_arguments)
1847
+ else:
1848
+ return self.base_client.call_api(
1849
+ resource_path=resource_path,
1850
+ method=method,
1851
+ path_params=path_params,
1852
+ header_params=header_params,
1853
+ response_type="WorkRequest",
1854
+ allow_control_chars=kwargs.get('allow_control_chars'),
1855
+ operation_name=operation_name,
1856
+ api_reference_link=api_reference_link,
1857
+ required_arguments=required_arguments)
1858
+
1859
+ def list_backups(self, **kwargs):
1860
+ """
1861
+ Returns a list of Backup.
1862
+
1863
+
1864
+ :param str compartment_id: (optional)
1865
+ The ID of the compartment in which to list resources.
1866
+
1867
+ :param datetime time_started: (optional)
1868
+ The start date for getting backups. An RFC3339 formatted datetime string
1869
+
1870
+ :param datetime time_ended: (optional)
1871
+ The End date for getting backups. An RFC3339 formatted datetime string.
1872
+
1873
+ :param str lifecycle_state: (optional)
1874
+ A filter to return only resources their lifecycleState matches the given lifecycleState.
1875
+
1876
+ Allowed values are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED"
1877
+
1878
+ :param str display_name: (optional)
1879
+ A filter to return only resources that match the entire display name given.
1880
+
1881
+ :param str backup_id: (optional)
1882
+ unique Backup identifier
1883
+
1884
+ :param str id: (optional)
1885
+ unique DbSystem identifier
1886
+
1887
+ :param int limit: (optional)
1888
+ The maximum number of items to return.
1889
+
1890
+ :param str page: (optional)
1891
+ A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
1892
+
1893
+ :param str sort_order: (optional)
1894
+ The sort order to use, either 'ASC' or 'DESC'.
1895
+
1896
+ Allowed values are: "ASC", "DESC"
1897
+
1898
+ :param str sort_by: (optional)
1899
+ The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending.
1900
+
1901
+ Allowed values are: "timeCreated", "displayName"
1902
+
1903
+ :param str opc_request_id: (optional)
1904
+ The client request ID for tracing.
1905
+
1906
+ :param obj retry_strategy: (optional)
1907
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
1908
+
1909
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
1910
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
1911
+
1912
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
1913
+
1914
+ :param bool allow_control_chars: (optional)
1915
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
1916
+ By default, the response will not allow control characters in strings
1917
+
1918
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.BackupCollection`
1919
+ :rtype: :class:`~oci.response.Response`
1920
+
1921
+ :example:
1922
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/list_backups.py.html>`__ to see an example of how to use list_backups API.
1923
+ """
1924
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
1925
+ required_arguments = []
1926
+ resource_path = "/backups"
1927
+ method = "GET"
1928
+ operation_name = "list_backups"
1929
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/BackupCollection/ListBackups"
1930
+
1931
+ # Don't accept unknown kwargs
1932
+ expected_kwargs = [
1933
+ "allow_control_chars",
1934
+ "retry_strategy",
1935
+ "compartment_id",
1936
+ "time_started",
1937
+ "time_ended",
1938
+ "lifecycle_state",
1939
+ "display_name",
1940
+ "backup_id",
1941
+ "id",
1942
+ "limit",
1943
+ "page",
1944
+ "sort_order",
1945
+ "sort_by",
1946
+ "opc_request_id"
1947
+ ]
1948
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
1949
+ if extra_kwargs:
1950
+ raise ValueError(
1951
+ f"list_backups got unknown kwargs: {extra_kwargs!r}")
1952
+
1953
+ if 'lifecycle_state' in kwargs:
1954
+ lifecycle_state_allowed_values = ["CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED"]
1955
+ if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values:
1956
+ raise ValueError(
1957
+ f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }"
1958
+ )
1959
+
1960
+ if 'sort_order' in kwargs:
1961
+ sort_order_allowed_values = ["ASC", "DESC"]
1962
+ if kwargs['sort_order'] not in sort_order_allowed_values:
1963
+ raise ValueError(
1964
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
1965
+ )
1966
+
1967
+ if 'sort_by' in kwargs:
1968
+ sort_by_allowed_values = ["timeCreated", "displayName"]
1969
+ if kwargs['sort_by'] not in sort_by_allowed_values:
1970
+ raise ValueError(
1971
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
1972
+ )
1973
+
1974
+ query_params = {
1975
+ "compartmentId": kwargs.get("compartment_id", missing),
1976
+ "timeStarted": kwargs.get("time_started", missing),
1977
+ "timeEnded": kwargs.get("time_ended", missing),
1978
+ "lifecycleState": kwargs.get("lifecycle_state", missing),
1979
+ "displayName": kwargs.get("display_name", missing),
1980
+ "backupId": kwargs.get("backup_id", missing),
1981
+ "id": kwargs.get("id", missing),
1982
+ "limit": kwargs.get("limit", missing),
1983
+ "page": kwargs.get("page", missing),
1984
+ "sortOrder": kwargs.get("sort_order", missing),
1985
+ "sortBy": kwargs.get("sort_by", missing)
1986
+ }
1987
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
1988
+
1989
+ header_params = {
1990
+ "accept": "application/json",
1991
+ "content-type": "application/json",
1992
+ "opc-request-id": kwargs.get("opc_request_id", missing)
1993
+ }
1994
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
1995
+
1996
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
1997
+ operation_retry_strategy=kwargs.get('retry_strategy'),
1998
+ client_retry_strategy=self.retry_strategy
1999
+ )
2000
+ if retry_strategy is None:
2001
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
2002
+
2003
+ if retry_strategy:
2004
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
2005
+ self.base_client.add_opc_client_retries_header(header_params)
2006
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
2007
+ return retry_strategy.make_retrying_call(
2008
+ self.base_client.call_api,
2009
+ resource_path=resource_path,
2010
+ method=method,
2011
+ query_params=query_params,
2012
+ header_params=header_params,
2013
+ response_type="BackupCollection",
2014
+ allow_control_chars=kwargs.get('allow_control_chars'),
2015
+ operation_name=operation_name,
2016
+ api_reference_link=api_reference_link,
2017
+ required_arguments=required_arguments)
2018
+ else:
2019
+ return self.base_client.call_api(
2020
+ resource_path=resource_path,
2021
+ method=method,
2022
+ query_params=query_params,
2023
+ header_params=header_params,
2024
+ response_type="BackupCollection",
2025
+ allow_control_chars=kwargs.get('allow_control_chars'),
2026
+ operation_name=operation_name,
2027
+ api_reference_link=api_reference_link,
2028
+ required_arguments=required_arguments)
2029
+
2030
+ def list_configurations(self, **kwargs):
2031
+ """
2032
+ Returns a list of Configurations.
2033
+
2034
+
2035
+ :param str compartment_id: (optional)
2036
+ The ID of the compartment in which to list resources.
2037
+
2038
+ :param str lifecycle_state: (optional)
2039
+ A filter to return only resources their lifecycleState matches the given lifecycleState.
2040
+
2041
+ Allowed values are: "ACTIVE", "DELETING", "DELETED", "FAILED"
2042
+
2043
+ :param str display_name: (optional)
2044
+ A filter to return only resources that match the entire display name given.
2045
+
2046
+ :param str db_version: (optional)
2047
+ Verison of the Postgresql DB like 14.5
2048
+
2049
+ :param str shape: (optional)
2050
+ Shape name of the compute like VM.Standard.E4.Flex or VM.Standard3.Flex
2051
+
2052
+ :param str configuration_id: (optional)
2053
+ unique Configuration identifier
2054
+
2055
+ :param int limit: (optional)
2056
+ The maximum number of items to return.
2057
+
2058
+ :param str page: (optional)
2059
+ A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
2060
+
2061
+ :param str sort_order: (optional)
2062
+ The sort order to use, either 'ASC' or 'DESC'.
2063
+
2064
+ Allowed values are: "ASC", "DESC"
2065
+
2066
+ :param str sort_by: (optional)
2067
+ The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending.
2068
+
2069
+ Allowed values are: "timeCreated", "displayName"
2070
+
2071
+ :param str opc_request_id: (optional)
2072
+ The client request ID for tracing.
2073
+
2074
+ :param obj retry_strategy: (optional)
2075
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
2076
+
2077
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
2078
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
2079
+
2080
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
2081
+
2082
+ :param bool allow_control_chars: (optional)
2083
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2084
+ By default, the response will not allow control characters in strings
2085
+
2086
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.ConfigurationCollection`
2087
+ :rtype: :class:`~oci.response.Response`
2088
+
2089
+ :example:
2090
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/list_configurations.py.html>`__ to see an example of how to use list_configurations API.
2091
+ """
2092
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2093
+ required_arguments = []
2094
+ resource_path = "/configurations"
2095
+ method = "GET"
2096
+ operation_name = "list_configurations"
2097
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/ConfigurationCollection/ListConfigurations"
2098
+
2099
+ # Don't accept unknown kwargs
2100
+ expected_kwargs = [
2101
+ "allow_control_chars",
2102
+ "retry_strategy",
2103
+ "compartment_id",
2104
+ "lifecycle_state",
2105
+ "display_name",
2106
+ "db_version",
2107
+ "shape",
2108
+ "configuration_id",
2109
+ "limit",
2110
+ "page",
2111
+ "sort_order",
2112
+ "sort_by",
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"list_configurations got unknown kwargs: {extra_kwargs!r}")
2119
+
2120
+ if 'lifecycle_state' in kwargs:
2121
+ lifecycle_state_allowed_values = ["ACTIVE", "DELETING", "DELETED", "FAILED"]
2122
+ if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values:
2123
+ raise ValueError(
2124
+ f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }"
2125
+ )
2126
+
2127
+ if 'sort_order' in kwargs:
2128
+ sort_order_allowed_values = ["ASC", "DESC"]
2129
+ if kwargs['sort_order'] not in sort_order_allowed_values:
2130
+ raise ValueError(
2131
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
2132
+ )
2133
+
2134
+ if 'sort_by' in kwargs:
2135
+ sort_by_allowed_values = ["timeCreated", "displayName"]
2136
+ if kwargs['sort_by'] not in sort_by_allowed_values:
2137
+ raise ValueError(
2138
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
2139
+ )
2140
+
2141
+ query_params = {
2142
+ "compartmentId": kwargs.get("compartment_id", missing),
2143
+ "lifecycleState": kwargs.get("lifecycle_state", missing),
2144
+ "displayName": kwargs.get("display_name", missing),
2145
+ "dbVersion": kwargs.get("db_version", missing),
2146
+ "shape": kwargs.get("shape", missing),
2147
+ "configurationId": kwargs.get("configuration_id", missing),
2148
+ "limit": kwargs.get("limit", missing),
2149
+ "page": kwargs.get("page", missing),
2150
+ "sortOrder": kwargs.get("sort_order", missing),
2151
+ "sortBy": kwargs.get("sort_by", missing)
2152
+ }
2153
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
2154
+
2155
+ header_params = {
2156
+ "accept": "application/json",
2157
+ "content-type": "application/json",
2158
+ "opc-request-id": kwargs.get("opc_request_id", missing)
2159
+ }
2160
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
2161
+
2162
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
2163
+ operation_retry_strategy=kwargs.get('retry_strategy'),
2164
+ client_retry_strategy=self.retry_strategy
2165
+ )
2166
+ if retry_strategy is None:
2167
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
2168
+
2169
+ if retry_strategy:
2170
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
2171
+ self.base_client.add_opc_client_retries_header(header_params)
2172
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
2173
+ return retry_strategy.make_retrying_call(
2174
+ self.base_client.call_api,
2175
+ resource_path=resource_path,
2176
+ method=method,
2177
+ query_params=query_params,
2178
+ header_params=header_params,
2179
+ response_type="ConfigurationCollection",
2180
+ allow_control_chars=kwargs.get('allow_control_chars'),
2181
+ operation_name=operation_name,
2182
+ api_reference_link=api_reference_link,
2183
+ required_arguments=required_arguments)
2184
+ else:
2185
+ return self.base_client.call_api(
2186
+ resource_path=resource_path,
2187
+ method=method,
2188
+ query_params=query_params,
2189
+ header_params=header_params,
2190
+ response_type="ConfigurationCollection",
2191
+ allow_control_chars=kwargs.get('allow_control_chars'),
2192
+ operation_name=operation_name,
2193
+ api_reference_link=api_reference_link,
2194
+ required_arguments=required_arguments)
2195
+
2196
+ def list_db_systems(self, **kwargs):
2197
+ """
2198
+ Returns a list of DbSystems.
2199
+
2200
+
2201
+ :param str compartment_id: (optional)
2202
+ The ID of the compartment in which to list resources.
2203
+
2204
+ :param str lifecycle_state: (optional)
2205
+ A filter to return only resources their lifecycleState matches the given lifecycleState.
2206
+
2207
+ Allowed values are: "CREATING", "UPDATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", "FAILED", "NEEDS_ATTENTION"
2208
+
2209
+ :param str display_name: (optional)
2210
+ A filter to return only resources that match the entire display name given.
2211
+
2212
+ :param str id: (optional)
2213
+ unique DbSystem identifier
2214
+
2215
+ :param int limit: (optional)
2216
+ The maximum number of items to return.
2217
+
2218
+ :param str page: (optional)
2219
+ A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
2220
+
2221
+ :param str sort_order: (optional)
2222
+ The sort order to use, either 'ASC' or 'DESC'.
2223
+
2224
+ Allowed values are: "ASC", "DESC"
2225
+
2226
+ :param str sort_by: (optional)
2227
+ The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending.
2228
+
2229
+ Allowed values are: "timeCreated", "displayName"
2230
+
2231
+ :param str opc_request_id: (optional)
2232
+ The client request ID for tracing.
2233
+
2234
+ :param obj retry_strategy: (optional)
2235
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
2236
+
2237
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
2238
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
2239
+
2240
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
2241
+
2242
+ :param bool allow_control_chars: (optional)
2243
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2244
+ By default, the response will not allow control characters in strings
2245
+
2246
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.DbSystemCollection`
2247
+ :rtype: :class:`~oci.response.Response`
2248
+
2249
+ :example:
2250
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/list_db_systems.py.html>`__ to see an example of how to use list_db_systems API.
2251
+ """
2252
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2253
+ required_arguments = []
2254
+ resource_path = "/dbSystems"
2255
+ method = "GET"
2256
+ operation_name = "list_db_systems"
2257
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystemCollection/ListDbSystems"
2258
+
2259
+ # Don't accept unknown kwargs
2260
+ expected_kwargs = [
2261
+ "allow_control_chars",
2262
+ "retry_strategy",
2263
+ "compartment_id",
2264
+ "lifecycle_state",
2265
+ "display_name",
2266
+ "id",
2267
+ "limit",
2268
+ "page",
2269
+ "sort_order",
2270
+ "sort_by",
2271
+ "opc_request_id"
2272
+ ]
2273
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2274
+ if extra_kwargs:
2275
+ raise ValueError(
2276
+ f"list_db_systems got unknown kwargs: {extra_kwargs!r}")
2277
+
2278
+ if 'lifecycle_state' in kwargs:
2279
+ lifecycle_state_allowed_values = ["CREATING", "UPDATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", "FAILED", "NEEDS_ATTENTION"]
2280
+ if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values:
2281
+ raise ValueError(
2282
+ f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }"
2283
+ )
2284
+
2285
+ if 'sort_order' in kwargs:
2286
+ sort_order_allowed_values = ["ASC", "DESC"]
2287
+ if kwargs['sort_order'] not in sort_order_allowed_values:
2288
+ raise ValueError(
2289
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
2290
+ )
2291
+
2292
+ if 'sort_by' in kwargs:
2293
+ sort_by_allowed_values = ["timeCreated", "displayName"]
2294
+ if kwargs['sort_by'] not in sort_by_allowed_values:
2295
+ raise ValueError(
2296
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
2297
+ )
2298
+
2299
+ query_params = {
2300
+ "compartmentId": kwargs.get("compartment_id", missing),
2301
+ "lifecycleState": kwargs.get("lifecycle_state", missing),
2302
+ "displayName": kwargs.get("display_name", missing),
2303
+ "id": kwargs.get("id", missing),
2304
+ "limit": kwargs.get("limit", missing),
2305
+ "page": kwargs.get("page", missing),
2306
+ "sortOrder": kwargs.get("sort_order", missing),
2307
+ "sortBy": kwargs.get("sort_by", missing)
2308
+ }
2309
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
2310
+
2311
+ header_params = {
2312
+ "accept": "application/json",
2313
+ "content-type": "application/json",
2314
+ "opc-request-id": kwargs.get("opc_request_id", missing)
2315
+ }
2316
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
2317
+
2318
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
2319
+ operation_retry_strategy=kwargs.get('retry_strategy'),
2320
+ client_retry_strategy=self.retry_strategy
2321
+ )
2322
+ if retry_strategy is None:
2323
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
2324
+
2325
+ if retry_strategy:
2326
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
2327
+ self.base_client.add_opc_client_retries_header(header_params)
2328
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
2329
+ return retry_strategy.make_retrying_call(
2330
+ self.base_client.call_api,
2331
+ resource_path=resource_path,
2332
+ method=method,
2333
+ query_params=query_params,
2334
+ header_params=header_params,
2335
+ response_type="DbSystemCollection",
2336
+ allow_control_chars=kwargs.get('allow_control_chars'),
2337
+ operation_name=operation_name,
2338
+ api_reference_link=api_reference_link,
2339
+ required_arguments=required_arguments)
2340
+ else:
2341
+ return self.base_client.call_api(
2342
+ resource_path=resource_path,
2343
+ method=method,
2344
+ query_params=query_params,
2345
+ header_params=header_params,
2346
+ response_type="DbSystemCollection",
2347
+ allow_control_chars=kwargs.get('allow_control_chars'),
2348
+ operation_name=operation_name,
2349
+ api_reference_link=api_reference_link,
2350
+ required_arguments=required_arguments)
2351
+
2352
+ def list_default_configurations(self, **kwargs):
2353
+ """
2354
+ Returns a list of Default Configurations.
2355
+
2356
+
2357
+ :param str lifecycle_state: (optional)
2358
+ A filter to return only resources their lifecycleState matches the given lifecycleState.
2359
+
2360
+ Allowed values are: "ACTIVE", "DELETING", "DELETED", "FAILED"
2361
+
2362
+ :param str display_name: (optional)
2363
+ A filter to return only resources that match the entire display name given.
2364
+
2365
+ :param str db_version: (optional)
2366
+ Verison of the Postgresql DB like 14.5
2367
+
2368
+ :param str shape: (optional)
2369
+ Shape name of the compute like VM.Standard.E4.Flex or VM.Standard3.Flex
2370
+
2371
+ :param str configuration_id: (optional)
2372
+ unique Configuration identifier
2373
+
2374
+ :param int limit: (optional)
2375
+ The maximum number of items to return.
2376
+
2377
+ :param str page: (optional)
2378
+ A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
2379
+
2380
+ :param str sort_order: (optional)
2381
+ The sort order to use, either 'ASC' or 'DESC'.
2382
+
2383
+ Allowed values are: "ASC", "DESC"
2384
+
2385
+ :param str sort_by: (optional)
2386
+ The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending.
2387
+
2388
+ Allowed values are: "timeCreated", "displayName"
2389
+
2390
+ :param str opc_request_id: (optional)
2391
+ The client request ID for tracing.
2392
+
2393
+ :param obj retry_strategy: (optional)
2394
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
2395
+
2396
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
2397
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
2398
+
2399
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
2400
+
2401
+ :param bool allow_control_chars: (optional)
2402
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2403
+ By default, the response will not allow control characters in strings
2404
+
2405
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.DefaultConfigurationCollection`
2406
+ :rtype: :class:`~oci.response.Response`
2407
+
2408
+ :example:
2409
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/list_default_configurations.py.html>`__ to see an example of how to use list_default_configurations API.
2410
+ """
2411
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2412
+ required_arguments = []
2413
+ resource_path = "/defaultConfigurations"
2414
+ method = "GET"
2415
+ operation_name = "list_default_configurations"
2416
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DefaultConfigurationCollection/ListDefaultConfigurations"
2417
+
2418
+ # Don't accept unknown kwargs
2419
+ expected_kwargs = [
2420
+ "allow_control_chars",
2421
+ "retry_strategy",
2422
+ "lifecycle_state",
2423
+ "display_name",
2424
+ "db_version",
2425
+ "shape",
2426
+ "configuration_id",
2427
+ "limit",
2428
+ "page",
2429
+ "sort_order",
2430
+ "sort_by",
2431
+ "opc_request_id"
2432
+ ]
2433
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2434
+ if extra_kwargs:
2435
+ raise ValueError(
2436
+ f"list_default_configurations got unknown kwargs: {extra_kwargs!r}")
2437
+
2438
+ if 'lifecycle_state' in kwargs:
2439
+ lifecycle_state_allowed_values = ["ACTIVE", "DELETING", "DELETED", "FAILED"]
2440
+ if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values:
2441
+ raise ValueError(
2442
+ f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }"
2443
+ )
2444
+
2445
+ if 'sort_order' in kwargs:
2446
+ sort_order_allowed_values = ["ASC", "DESC"]
2447
+ if kwargs['sort_order'] not in sort_order_allowed_values:
2448
+ raise ValueError(
2449
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
2450
+ )
2451
+
2452
+ if 'sort_by' in kwargs:
2453
+ sort_by_allowed_values = ["timeCreated", "displayName"]
2454
+ if kwargs['sort_by'] not in sort_by_allowed_values:
2455
+ raise ValueError(
2456
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
2457
+ )
2458
+
2459
+ query_params = {
2460
+ "lifecycleState": kwargs.get("lifecycle_state", missing),
2461
+ "displayName": kwargs.get("display_name", missing),
2462
+ "dbVersion": kwargs.get("db_version", missing),
2463
+ "shape": kwargs.get("shape", missing),
2464
+ "configurationId": kwargs.get("configuration_id", missing),
2465
+ "limit": kwargs.get("limit", missing),
2466
+ "page": kwargs.get("page", missing),
2467
+ "sortOrder": kwargs.get("sort_order", missing),
2468
+ "sortBy": kwargs.get("sort_by", missing)
2469
+ }
2470
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
2471
+
2472
+ header_params = {
2473
+ "accept": "application/json",
2474
+ "content-type": "application/json",
2475
+ "opc-request-id": kwargs.get("opc_request_id", missing)
2476
+ }
2477
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
2478
+
2479
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
2480
+ operation_retry_strategy=kwargs.get('retry_strategy'),
2481
+ client_retry_strategy=self.retry_strategy
2482
+ )
2483
+ if retry_strategy is None:
2484
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
2485
+
2486
+ if retry_strategy:
2487
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
2488
+ self.base_client.add_opc_client_retries_header(header_params)
2489
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
2490
+ return retry_strategy.make_retrying_call(
2491
+ self.base_client.call_api,
2492
+ resource_path=resource_path,
2493
+ method=method,
2494
+ query_params=query_params,
2495
+ header_params=header_params,
2496
+ response_type="DefaultConfigurationCollection",
2497
+ allow_control_chars=kwargs.get('allow_control_chars'),
2498
+ operation_name=operation_name,
2499
+ api_reference_link=api_reference_link,
2500
+ required_arguments=required_arguments)
2501
+ else:
2502
+ return self.base_client.call_api(
2503
+ resource_path=resource_path,
2504
+ method=method,
2505
+ query_params=query_params,
2506
+ header_params=header_params,
2507
+ response_type="DefaultConfigurationCollection",
2508
+ allow_control_chars=kwargs.get('allow_control_chars'),
2509
+ operation_name=operation_name,
2510
+ api_reference_link=api_reference_link,
2511
+ required_arguments=required_arguments)
2512
+
2513
+ def list_shapes(self, **kwargs):
2514
+ """
2515
+ Returns the list of shapes allowed in the region.
2516
+
2517
+
2518
+ :param str compartment_id: (optional)
2519
+ The ID of the compartment in which to list resources.
2520
+
2521
+ :param str id: (optional)
2522
+ A filter to return the feature by the shape name.
2523
+
2524
+ :param str opc_request_id: (optional)
2525
+ The client request ID for tracing.
2526
+
2527
+ :param int limit: (optional)
2528
+ The maximum number of items to return.
2529
+
2530
+ :param str page: (optional)
2531
+ A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
2532
+
2533
+ :param str sort_order: (optional)
2534
+ The sort order to use, either 'ASC' or 'DESC'.
2535
+
2536
+ Allowed values are: "ASC", "DESC"
2537
+
2538
+ :param str sort_by: (optional)
2539
+ The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending.
2540
+
2541
+ Allowed values are: "timeCreated", "displayName"
2542
+
2543
+ :param obj retry_strategy: (optional)
2544
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
2545
+
2546
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
2547
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
2548
+
2549
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
2550
+
2551
+ :param bool allow_control_chars: (optional)
2552
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2553
+ By default, the response will not allow control characters in strings
2554
+
2555
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.ShapeCollection`
2556
+ :rtype: :class:`~oci.response.Response`
2557
+
2558
+ :example:
2559
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/list_shapes.py.html>`__ to see an example of how to use list_shapes API.
2560
+ """
2561
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2562
+ required_arguments = []
2563
+ resource_path = "/shapes"
2564
+ method = "GET"
2565
+ operation_name = "list_shapes"
2566
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/ShapeSummary/ListShapes"
2567
+
2568
+ # Don't accept unknown kwargs
2569
+ expected_kwargs = [
2570
+ "allow_control_chars",
2571
+ "retry_strategy",
2572
+ "compartment_id",
2573
+ "id",
2574
+ "opc_request_id",
2575
+ "limit",
2576
+ "page",
2577
+ "sort_order",
2578
+ "sort_by"
2579
+ ]
2580
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2581
+ if extra_kwargs:
2582
+ raise ValueError(
2583
+ f"list_shapes got unknown kwargs: {extra_kwargs!r}")
2584
+
2585
+ if 'sort_order' in kwargs:
2586
+ sort_order_allowed_values = ["ASC", "DESC"]
2587
+ if kwargs['sort_order'] not in sort_order_allowed_values:
2588
+ raise ValueError(
2589
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
2590
+ )
2591
+
2592
+ if 'sort_by' in kwargs:
2593
+ sort_by_allowed_values = ["timeCreated", "displayName"]
2594
+ if kwargs['sort_by'] not in sort_by_allowed_values:
2595
+ raise ValueError(
2596
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
2597
+ )
2598
+
2599
+ query_params = {
2600
+ "compartmentId": kwargs.get("compartment_id", missing),
2601
+ "id": kwargs.get("id", missing),
2602
+ "limit": kwargs.get("limit", missing),
2603
+ "page": kwargs.get("page", missing),
2604
+ "sortOrder": kwargs.get("sort_order", missing),
2605
+ "sortBy": kwargs.get("sort_by", missing)
2606
+ }
2607
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
2608
+
2609
+ header_params = {
2610
+ "accept": "application/json",
2611
+ "content-type": "application/json",
2612
+ "opc-request-id": kwargs.get("opc_request_id", missing)
2613
+ }
2614
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
2615
+
2616
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
2617
+ operation_retry_strategy=kwargs.get('retry_strategy'),
2618
+ client_retry_strategy=self.retry_strategy
2619
+ )
2620
+ if retry_strategy is None:
2621
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
2622
+
2623
+ if retry_strategy:
2624
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
2625
+ self.base_client.add_opc_client_retries_header(header_params)
2626
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
2627
+ return retry_strategy.make_retrying_call(
2628
+ self.base_client.call_api,
2629
+ resource_path=resource_path,
2630
+ method=method,
2631
+ query_params=query_params,
2632
+ header_params=header_params,
2633
+ response_type="ShapeCollection",
2634
+ allow_control_chars=kwargs.get('allow_control_chars'),
2635
+ operation_name=operation_name,
2636
+ api_reference_link=api_reference_link,
2637
+ required_arguments=required_arguments)
2638
+ else:
2639
+ return self.base_client.call_api(
2640
+ resource_path=resource_path,
2641
+ method=method,
2642
+ query_params=query_params,
2643
+ header_params=header_params,
2644
+ response_type="ShapeCollection",
2645
+ allow_control_chars=kwargs.get('allow_control_chars'),
2646
+ operation_name=operation_name,
2647
+ api_reference_link=api_reference_link,
2648
+ required_arguments=required_arguments)
2649
+
2650
+ def list_work_request_errors(self, work_request_id, **kwargs):
2651
+ """
2652
+ Returns a (paginated) list of errors for the work request with the given ID.
2653
+
2654
+
2655
+ :param str work_request_id: (required)
2656
+ The ID of the asynchronous request.
2657
+
2658
+ :param str opc_request_id: (optional)
2659
+ The client request ID for tracing.
2660
+
2661
+ :param str page: (optional)
2662
+ A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
2663
+
2664
+ :param int limit: (optional)
2665
+ The maximum number of items to return.
2666
+
2667
+ :param str sort_by: (optional)
2668
+ The field to sort by. Only one sort order may be provided. Default order for timestamp is descending.
2669
+
2670
+ Allowed values are: "timestamp"
2671
+
2672
+ :param str sort_order: (optional)
2673
+ The sort order to use, either 'ASC' or 'DESC'.
2674
+
2675
+ Allowed values are: "ASC", "DESC"
2676
+
2677
+ :param obj retry_strategy: (optional)
2678
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
2679
+
2680
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
2681
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
2682
+
2683
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
2684
+
2685
+ :param bool allow_control_chars: (optional)
2686
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2687
+ By default, the response will not allow control characters in strings
2688
+
2689
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.WorkRequestErrorCollection`
2690
+ :rtype: :class:`~oci.response.Response`
2691
+
2692
+ :example:
2693
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/list_work_request_errors.py.html>`__ to see an example of how to use list_work_request_errors API.
2694
+ """
2695
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2696
+ required_arguments = ['workRequestId']
2697
+ resource_path = "/workRequests/{workRequestId}/errors"
2698
+ method = "GET"
2699
+ operation_name = "list_work_request_errors"
2700
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/WorkRequestError/ListWorkRequestErrors"
2701
+
2702
+ # Don't accept unknown kwargs
2703
+ expected_kwargs = [
2704
+ "allow_control_chars",
2705
+ "retry_strategy",
2706
+ "opc_request_id",
2707
+ "page",
2708
+ "limit",
2709
+ "sort_by",
2710
+ "sort_order"
2711
+ ]
2712
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2713
+ if extra_kwargs:
2714
+ raise ValueError(
2715
+ f"list_work_request_errors got unknown kwargs: {extra_kwargs!r}")
2716
+
2717
+ path_params = {
2718
+ "workRequestId": work_request_id
2719
+ }
2720
+
2721
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
2722
+
2723
+ for (k, v) in six.iteritems(path_params):
2724
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
2725
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
2726
+
2727
+ if 'sort_by' in kwargs:
2728
+ sort_by_allowed_values = ["timestamp"]
2729
+ if kwargs['sort_by'] not in sort_by_allowed_values:
2730
+ raise ValueError(
2731
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
2732
+ )
2733
+
2734
+ if 'sort_order' in kwargs:
2735
+ sort_order_allowed_values = ["ASC", "DESC"]
2736
+ if kwargs['sort_order'] not in sort_order_allowed_values:
2737
+ raise ValueError(
2738
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
2739
+ )
2740
+
2741
+ query_params = {
2742
+ "page": kwargs.get("page", missing),
2743
+ "limit": kwargs.get("limit", missing),
2744
+ "sortBy": kwargs.get("sort_by", missing),
2745
+ "sortOrder": kwargs.get("sort_order", missing)
2746
+ }
2747
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
2748
+
2749
+ header_params = {
2750
+ "accept": "application/json",
2751
+ "content-type": "application/json",
2752
+ "opc-request-id": kwargs.get("opc_request_id", missing)
2753
+ }
2754
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
2755
+
2756
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
2757
+ operation_retry_strategy=kwargs.get('retry_strategy'),
2758
+ client_retry_strategy=self.retry_strategy
2759
+ )
2760
+ if retry_strategy is None:
2761
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
2762
+
2763
+ if retry_strategy:
2764
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
2765
+ self.base_client.add_opc_client_retries_header(header_params)
2766
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
2767
+ return retry_strategy.make_retrying_call(
2768
+ self.base_client.call_api,
2769
+ resource_path=resource_path,
2770
+ method=method,
2771
+ path_params=path_params,
2772
+ query_params=query_params,
2773
+ header_params=header_params,
2774
+ response_type="WorkRequestErrorCollection",
2775
+ allow_control_chars=kwargs.get('allow_control_chars'),
2776
+ operation_name=operation_name,
2777
+ api_reference_link=api_reference_link,
2778
+ required_arguments=required_arguments)
2779
+ else:
2780
+ return self.base_client.call_api(
2781
+ resource_path=resource_path,
2782
+ method=method,
2783
+ path_params=path_params,
2784
+ query_params=query_params,
2785
+ header_params=header_params,
2786
+ response_type="WorkRequestErrorCollection",
2787
+ allow_control_chars=kwargs.get('allow_control_chars'),
2788
+ operation_name=operation_name,
2789
+ api_reference_link=api_reference_link,
2790
+ required_arguments=required_arguments)
2791
+
2792
+ def list_work_request_logs(self, work_request_id, **kwargs):
2793
+ """
2794
+ Returns a (paginated) list of logs for the work request with the given ID.
2795
+
2796
+
2797
+ :param str work_request_id: (required)
2798
+ The ID of the asynchronous request.
2799
+
2800
+ :param str opc_request_id: (optional)
2801
+ The client request ID for tracing.
2802
+
2803
+ :param str page: (optional)
2804
+ A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
2805
+
2806
+ :param int limit: (optional)
2807
+ The maximum number of items to return.
2808
+
2809
+ :param str sort_by: (optional)
2810
+ The field to sort by. Only one sort order may be provided. Default order for timestamp is descending.
2811
+
2812
+ Allowed values are: "timestamp"
2813
+
2814
+ :param str sort_order: (optional)
2815
+ The sort order to use, either 'ASC' or 'DESC'.
2816
+
2817
+ Allowed values are: "ASC", "DESC"
2818
+
2819
+ :param obj retry_strategy: (optional)
2820
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
2821
+
2822
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
2823
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
2824
+
2825
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
2826
+
2827
+ :param bool allow_control_chars: (optional)
2828
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2829
+ By default, the response will not allow control characters in strings
2830
+
2831
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.WorkRequestLogEntryCollection`
2832
+ :rtype: :class:`~oci.response.Response`
2833
+
2834
+ :example:
2835
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/list_work_request_logs.py.html>`__ to see an example of how to use list_work_request_logs API.
2836
+ """
2837
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2838
+ required_arguments = ['workRequestId']
2839
+ resource_path = "/workRequests/{workRequestId}/logs"
2840
+ method = "GET"
2841
+ operation_name = "list_work_request_logs"
2842
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/WorkRequestLogEntry/ListWorkRequestLogs"
2843
+
2844
+ # Don't accept unknown kwargs
2845
+ expected_kwargs = [
2846
+ "allow_control_chars",
2847
+ "retry_strategy",
2848
+ "opc_request_id",
2849
+ "page",
2850
+ "limit",
2851
+ "sort_by",
2852
+ "sort_order"
2853
+ ]
2854
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
2855
+ if extra_kwargs:
2856
+ raise ValueError(
2857
+ f"list_work_request_logs got unknown kwargs: {extra_kwargs!r}")
2858
+
2859
+ path_params = {
2860
+ "workRequestId": work_request_id
2861
+ }
2862
+
2863
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
2864
+
2865
+ for (k, v) in six.iteritems(path_params):
2866
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
2867
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
2868
+
2869
+ if 'sort_by' in kwargs:
2870
+ sort_by_allowed_values = ["timestamp"]
2871
+ if kwargs['sort_by'] not in sort_by_allowed_values:
2872
+ raise ValueError(
2873
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
2874
+ )
2875
+
2876
+ if 'sort_order' in kwargs:
2877
+ sort_order_allowed_values = ["ASC", "DESC"]
2878
+ if kwargs['sort_order'] not in sort_order_allowed_values:
2879
+ raise ValueError(
2880
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
2881
+ )
2882
+
2883
+ query_params = {
2884
+ "page": kwargs.get("page", missing),
2885
+ "limit": kwargs.get("limit", missing),
2886
+ "sortBy": kwargs.get("sort_by", missing),
2887
+ "sortOrder": kwargs.get("sort_order", missing)
2888
+ }
2889
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
2890
+
2891
+ header_params = {
2892
+ "accept": "application/json",
2893
+ "content-type": "application/json",
2894
+ "opc-request-id": kwargs.get("opc_request_id", missing)
2895
+ }
2896
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
2897
+
2898
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
2899
+ operation_retry_strategy=kwargs.get('retry_strategy'),
2900
+ client_retry_strategy=self.retry_strategy
2901
+ )
2902
+ if retry_strategy is None:
2903
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
2904
+
2905
+ if retry_strategy:
2906
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
2907
+ self.base_client.add_opc_client_retries_header(header_params)
2908
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
2909
+ return retry_strategy.make_retrying_call(
2910
+ self.base_client.call_api,
2911
+ resource_path=resource_path,
2912
+ method=method,
2913
+ path_params=path_params,
2914
+ query_params=query_params,
2915
+ header_params=header_params,
2916
+ response_type="WorkRequestLogEntryCollection",
2917
+ allow_control_chars=kwargs.get('allow_control_chars'),
2918
+ operation_name=operation_name,
2919
+ api_reference_link=api_reference_link,
2920
+ required_arguments=required_arguments)
2921
+ else:
2922
+ return self.base_client.call_api(
2923
+ resource_path=resource_path,
2924
+ method=method,
2925
+ path_params=path_params,
2926
+ query_params=query_params,
2927
+ header_params=header_params,
2928
+ response_type="WorkRequestLogEntryCollection",
2929
+ allow_control_chars=kwargs.get('allow_control_chars'),
2930
+ operation_name=operation_name,
2931
+ api_reference_link=api_reference_link,
2932
+ required_arguments=required_arguments)
2933
+
2934
+ def list_work_requests(self, **kwargs):
2935
+ """
2936
+ Lists the work requests in a compartment.
2937
+
2938
+
2939
+ :param str compartment_id: (optional)
2940
+ The ID of the compartment in which to list resources.
2941
+
2942
+ :param str work_request_id: (optional)
2943
+ The ID of the asynchronous work request.
2944
+
2945
+ :param str status: (optional)
2946
+ A filter to return only resources their lifecycleState matches the given OperationStatus.
2947
+
2948
+ Allowed values are: "ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED"
2949
+
2950
+ :param str resource_id: (optional)
2951
+ The ID of the resource affected by the request.
2952
+
2953
+ :param str opc_request_id: (optional)
2954
+ The client request ID for tracing.
2955
+
2956
+ :param str page: (optional)
2957
+ A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
2958
+
2959
+ :param int limit: (optional)
2960
+ The maximum number of items to return.
2961
+
2962
+ :param str sort_order: (optional)
2963
+ The sort order to use, either 'ASC' or 'DESC'.
2964
+
2965
+ Allowed values are: "ASC", "DESC"
2966
+
2967
+ :param str sort_by: (optional)
2968
+ The field to sort by. Only one sort order may be provided. Default order for timeAccepted is descending.
2969
+
2970
+ Allowed values are: "timeAccepted"
2971
+
2972
+ :param obj retry_strategy: (optional)
2973
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
2974
+
2975
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
2976
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
2977
+
2978
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
2979
+
2980
+ :param bool allow_control_chars: (optional)
2981
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
2982
+ By default, the response will not allow control characters in strings
2983
+
2984
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.WorkRequestSummaryCollection`
2985
+ :rtype: :class:`~oci.response.Response`
2986
+
2987
+ :example:
2988
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/list_work_requests.py.html>`__ to see an example of how to use list_work_requests API.
2989
+ """
2990
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
2991
+ required_arguments = []
2992
+ resource_path = "/workRequests"
2993
+ method = "GET"
2994
+ operation_name = "list_work_requests"
2995
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/WorkRequest/ListWorkRequests"
2996
+
2997
+ # Don't accept unknown kwargs
2998
+ expected_kwargs = [
2999
+ "allow_control_chars",
3000
+ "retry_strategy",
3001
+ "compartment_id",
3002
+ "work_request_id",
3003
+ "status",
3004
+ "resource_id",
3005
+ "opc_request_id",
3006
+ "page",
3007
+ "limit",
3008
+ "sort_order",
3009
+ "sort_by"
3010
+ ]
3011
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
3012
+ if extra_kwargs:
3013
+ raise ValueError(
3014
+ f"list_work_requests got unknown kwargs: {extra_kwargs!r}")
3015
+
3016
+ if 'status' in kwargs:
3017
+ status_allowed_values = ["ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED"]
3018
+ if kwargs['status'] not in status_allowed_values:
3019
+ raise ValueError(
3020
+ f"Invalid value for `status`, must be one of { status_allowed_values }"
3021
+ )
3022
+
3023
+ if 'sort_order' in kwargs:
3024
+ sort_order_allowed_values = ["ASC", "DESC"]
3025
+ if kwargs['sort_order'] not in sort_order_allowed_values:
3026
+ raise ValueError(
3027
+ f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
3028
+ )
3029
+
3030
+ if 'sort_by' in kwargs:
3031
+ sort_by_allowed_values = ["timeAccepted"]
3032
+ if kwargs['sort_by'] not in sort_by_allowed_values:
3033
+ raise ValueError(
3034
+ f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
3035
+ )
3036
+
3037
+ query_params = {
3038
+ "compartmentId": kwargs.get("compartment_id", missing),
3039
+ "workRequestId": kwargs.get("work_request_id", missing),
3040
+ "status": kwargs.get("status", missing),
3041
+ "resourceId": kwargs.get("resource_id", missing),
3042
+ "page": kwargs.get("page", missing),
3043
+ "limit": kwargs.get("limit", missing),
3044
+ "sortOrder": kwargs.get("sort_order", missing),
3045
+ "sortBy": kwargs.get("sort_by", missing)
3046
+ }
3047
+ query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
3048
+
3049
+ header_params = {
3050
+ "accept": "application/json",
3051
+ "content-type": "application/json",
3052
+ "opc-request-id": kwargs.get("opc_request_id", missing)
3053
+ }
3054
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
3055
+
3056
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
3057
+ operation_retry_strategy=kwargs.get('retry_strategy'),
3058
+ client_retry_strategy=self.retry_strategy
3059
+ )
3060
+ if retry_strategy is None:
3061
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
3062
+
3063
+ if retry_strategy:
3064
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
3065
+ self.base_client.add_opc_client_retries_header(header_params)
3066
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
3067
+ return retry_strategy.make_retrying_call(
3068
+ self.base_client.call_api,
3069
+ resource_path=resource_path,
3070
+ method=method,
3071
+ query_params=query_params,
3072
+ header_params=header_params,
3073
+ response_type="WorkRequestSummaryCollection",
3074
+ allow_control_chars=kwargs.get('allow_control_chars'),
3075
+ operation_name=operation_name,
3076
+ api_reference_link=api_reference_link,
3077
+ required_arguments=required_arguments)
3078
+ else:
3079
+ return self.base_client.call_api(
3080
+ resource_path=resource_path,
3081
+ method=method,
3082
+ query_params=query_params,
3083
+ header_params=header_params,
3084
+ response_type="WorkRequestSummaryCollection",
3085
+ allow_control_chars=kwargs.get('allow_control_chars'),
3086
+ operation_name=operation_name,
3087
+ api_reference_link=api_reference_link,
3088
+ required_arguments=required_arguments)
3089
+
3090
+ def patch_db_system(self, db_system_id, patch_db_system_details, **kwargs):
3091
+ """
3092
+ Patching operation allows to add DbInstances to the DbSystem or remove them.
3093
+
3094
+
3095
+ :param str db_system_id: (required)
3096
+ unique DbSystem identifier
3097
+
3098
+ :param oci.psql.models.PatchDbSystemDetails patch_db_system_details: (required)
3099
+ The information to be patched.
3100
+
3101
+ :param str if_match: (optional)
3102
+ For optimistic concurrency control. In the PUT or DELETE call
3103
+
3104
+ :param str opc_request_id: (optional)
3105
+ The client request ID for tracing.
3106
+
3107
+ :param obj retry_strategy: (optional)
3108
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
3109
+
3110
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
3111
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
3112
+
3113
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
3114
+
3115
+ :param bool allow_control_chars: (optional)
3116
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
3117
+ By default, the response will not allow control characters in strings
3118
+
3119
+ :return: A :class:`~oci.response.Response` object with data of type None
3120
+ :rtype: :class:`~oci.response.Response`
3121
+
3122
+ :example:
3123
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/patch_db_system.py.html>`__ to see an example of how to use patch_db_system API.
3124
+ """
3125
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3126
+ required_arguments = ['dbSystemId']
3127
+ resource_path = "/dbSystems/{dbSystemId}"
3128
+ method = "PATCH"
3129
+ operation_name = "patch_db_system"
3130
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/PatchDbSystem"
3131
+
3132
+ # Don't accept unknown kwargs
3133
+ expected_kwargs = [
3134
+ "allow_control_chars",
3135
+ "retry_strategy",
3136
+ "if_match",
3137
+ "opc_request_id"
3138
+ ]
3139
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
3140
+ if extra_kwargs:
3141
+ raise ValueError(
3142
+ f"patch_db_system got unknown kwargs: {extra_kwargs!r}")
3143
+
3144
+ path_params = {
3145
+ "dbSystemId": db_system_id
3146
+ }
3147
+
3148
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
3149
+
3150
+ for (k, v) in six.iteritems(path_params):
3151
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
3152
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
3153
+
3154
+ header_params = {
3155
+ "accept": "application/json",
3156
+ "content-type": "application/json",
3157
+ "if-match": kwargs.get("if_match", missing),
3158
+ "opc-request-id": kwargs.get("opc_request_id", missing)
3159
+ }
3160
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
3161
+
3162
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
3163
+ operation_retry_strategy=kwargs.get('retry_strategy'),
3164
+ client_retry_strategy=self.retry_strategy
3165
+ )
3166
+ if retry_strategy is None:
3167
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
3168
+
3169
+ if retry_strategy:
3170
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
3171
+ self.base_client.add_opc_client_retries_header(header_params)
3172
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
3173
+ return retry_strategy.make_retrying_call(
3174
+ self.base_client.call_api,
3175
+ resource_path=resource_path,
3176
+ method=method,
3177
+ path_params=path_params,
3178
+ header_params=header_params,
3179
+ body=patch_db_system_details,
3180
+ allow_control_chars=kwargs.get('allow_control_chars'),
3181
+ operation_name=operation_name,
3182
+ api_reference_link=api_reference_link,
3183
+ required_arguments=required_arguments)
3184
+ else:
3185
+ return self.base_client.call_api(
3186
+ resource_path=resource_path,
3187
+ method=method,
3188
+ path_params=path_params,
3189
+ header_params=header_params,
3190
+ body=patch_db_system_details,
3191
+ allow_control_chars=kwargs.get('allow_control_chars'),
3192
+ operation_name=operation_name,
3193
+ api_reference_link=api_reference_link,
3194
+ required_arguments=required_arguments)
3195
+
3196
+ def reset_master_user_password(self, db_system_id, reset_master_user_password_details, **kwargs):
3197
+ """
3198
+ Resets the Db system's master password.
3199
+
3200
+
3201
+ :param str db_system_id: (required)
3202
+ unique DbSystem identifier
3203
+
3204
+ :param oci.psql.models.ResetMasterUserPasswordDetails reset_master_user_password_details: (required)
3205
+ The information to be updated.
3206
+
3207
+ :param str if_match: (optional)
3208
+ For optimistic concurrency control. In the PUT or DELETE call
3209
+
3210
+ :param str opc_request_id: (optional)
3211
+ The client request ID for tracing.
3212
+
3213
+ :param str opc_retry_token: (optional)
3214
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
3215
+
3216
+ :param obj retry_strategy: (optional)
3217
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
3218
+
3219
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
3220
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
3221
+
3222
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
3223
+
3224
+ :param bool allow_control_chars: (optional)
3225
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
3226
+ By default, the response will not allow control characters in strings
3227
+
3228
+ :return: A :class:`~oci.response.Response` object with data of type None
3229
+ :rtype: :class:`~oci.response.Response`
3230
+
3231
+ :example:
3232
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/reset_master_user_password.py.html>`__ to see an example of how to use reset_master_user_password API.
3233
+ """
3234
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3235
+ required_arguments = ['dbSystemId']
3236
+ resource_path = "/dbSystems/{dbSystemId}/actions/resetMasterUserPassword"
3237
+ method = "POST"
3238
+ operation_name = "reset_master_user_password"
3239
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/ResetMasterUserPassword"
3240
+
3241
+ # Don't accept unknown kwargs
3242
+ expected_kwargs = [
3243
+ "allow_control_chars",
3244
+ "retry_strategy",
3245
+ "if_match",
3246
+ "opc_request_id",
3247
+ "opc_retry_token"
3248
+ ]
3249
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
3250
+ if extra_kwargs:
3251
+ raise ValueError(
3252
+ f"reset_master_user_password got unknown kwargs: {extra_kwargs!r}")
3253
+
3254
+ path_params = {
3255
+ "dbSystemId": db_system_id
3256
+ }
3257
+
3258
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
3259
+
3260
+ for (k, v) in six.iteritems(path_params):
3261
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
3262
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
3263
+
3264
+ header_params = {
3265
+ "accept": "application/json",
3266
+ "content-type": "application/json",
3267
+ "if-match": kwargs.get("if_match", missing),
3268
+ "opc-request-id": kwargs.get("opc_request_id", missing),
3269
+ "opc-retry-token": kwargs.get("opc_retry_token", missing)
3270
+ }
3271
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
3272
+
3273
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
3274
+ operation_retry_strategy=kwargs.get('retry_strategy'),
3275
+ client_retry_strategy=self.retry_strategy
3276
+ )
3277
+ if retry_strategy is None:
3278
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
3279
+
3280
+ if retry_strategy:
3281
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
3282
+ self.base_client.add_opc_retry_token_if_needed(header_params)
3283
+ self.base_client.add_opc_client_retries_header(header_params)
3284
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
3285
+ return retry_strategy.make_retrying_call(
3286
+ self.base_client.call_api,
3287
+ resource_path=resource_path,
3288
+ method=method,
3289
+ path_params=path_params,
3290
+ header_params=header_params,
3291
+ body=reset_master_user_password_details,
3292
+ allow_control_chars=kwargs.get('allow_control_chars'),
3293
+ operation_name=operation_name,
3294
+ api_reference_link=api_reference_link,
3295
+ required_arguments=required_arguments)
3296
+ else:
3297
+ return self.base_client.call_api(
3298
+ resource_path=resource_path,
3299
+ method=method,
3300
+ path_params=path_params,
3301
+ header_params=header_params,
3302
+ body=reset_master_user_password_details,
3303
+ allow_control_chars=kwargs.get('allow_control_chars'),
3304
+ operation_name=operation_name,
3305
+ api_reference_link=api_reference_link,
3306
+ required_arguments=required_arguments)
3307
+
3308
+ def restart_db_instance_in_db_system(self, db_system_id, restart_db_instance_in_db_system_details, **kwargs):
3309
+ """
3310
+ Restarts the running DbInstance.
3311
+
3312
+
3313
+ :param str db_system_id: (required)
3314
+ unique DbSystem identifier
3315
+
3316
+ :param oci.psql.models.RestartDbInstanceInDbSystemDetails restart_db_instance_in_db_system_details: (required)
3317
+ DdInstance restart parameters.
3318
+
3319
+ :param str if_match: (optional)
3320
+ For optimistic concurrency control. In the PUT or DELETE call
3321
+
3322
+ :param str opc_request_id: (optional)
3323
+ The client request ID for tracing.
3324
+
3325
+ :param str opc_retry_token: (optional)
3326
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
3327
+
3328
+ :param obj retry_strategy: (optional)
3329
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
3330
+
3331
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
3332
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
3333
+
3334
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
3335
+
3336
+ :param bool allow_control_chars: (optional)
3337
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
3338
+ By default, the response will not allow control characters in strings
3339
+
3340
+ :return: A :class:`~oci.response.Response` object with data of type None
3341
+ :rtype: :class:`~oci.response.Response`
3342
+
3343
+ :example:
3344
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/restart_db_instance_in_db_system.py.html>`__ to see an example of how to use restart_db_instance_in_db_system API.
3345
+ """
3346
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3347
+ required_arguments = ['dbSystemId']
3348
+ resource_path = "/dbSystems/{dbSystemId}/actions/restartDbInstance"
3349
+ method = "POST"
3350
+ operation_name = "restart_db_instance_in_db_system"
3351
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/RestartDbInstanceInDbSystem"
3352
+
3353
+ # Don't accept unknown kwargs
3354
+ expected_kwargs = [
3355
+ "allow_control_chars",
3356
+ "retry_strategy",
3357
+ "if_match",
3358
+ "opc_request_id",
3359
+ "opc_retry_token"
3360
+ ]
3361
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
3362
+ if extra_kwargs:
3363
+ raise ValueError(
3364
+ f"restart_db_instance_in_db_system got unknown kwargs: {extra_kwargs!r}")
3365
+
3366
+ path_params = {
3367
+ "dbSystemId": db_system_id
3368
+ }
3369
+
3370
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
3371
+
3372
+ for (k, v) in six.iteritems(path_params):
3373
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
3374
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
3375
+
3376
+ header_params = {
3377
+ "accept": "application/json",
3378
+ "content-type": "application/json",
3379
+ "if-match": kwargs.get("if_match", missing),
3380
+ "opc-request-id": kwargs.get("opc_request_id", missing),
3381
+ "opc-retry-token": kwargs.get("opc_retry_token", missing)
3382
+ }
3383
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
3384
+
3385
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
3386
+ operation_retry_strategy=kwargs.get('retry_strategy'),
3387
+ client_retry_strategy=self.retry_strategy
3388
+ )
3389
+ if retry_strategy is None:
3390
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
3391
+
3392
+ if retry_strategy:
3393
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
3394
+ self.base_client.add_opc_retry_token_if_needed(header_params)
3395
+ self.base_client.add_opc_client_retries_header(header_params)
3396
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
3397
+ return retry_strategy.make_retrying_call(
3398
+ self.base_client.call_api,
3399
+ resource_path=resource_path,
3400
+ method=method,
3401
+ path_params=path_params,
3402
+ header_params=header_params,
3403
+ body=restart_db_instance_in_db_system_details,
3404
+ allow_control_chars=kwargs.get('allow_control_chars'),
3405
+ operation_name=operation_name,
3406
+ api_reference_link=api_reference_link,
3407
+ required_arguments=required_arguments)
3408
+ else:
3409
+ return self.base_client.call_api(
3410
+ resource_path=resource_path,
3411
+ method=method,
3412
+ path_params=path_params,
3413
+ header_params=header_params,
3414
+ body=restart_db_instance_in_db_system_details,
3415
+ allow_control_chars=kwargs.get('allow_control_chars'),
3416
+ operation_name=operation_name,
3417
+ api_reference_link=api_reference_link,
3418
+ required_arguments=required_arguments)
3419
+
3420
+ def restore_db_system(self, db_system_id, restore_db_system_details, **kwargs):
3421
+ """
3422
+ Restore the Db System.
3423
+
3424
+
3425
+ :param str db_system_id: (required)
3426
+ unique DbSystem identifier
3427
+
3428
+ :param oci.psql.models.RestoreDbSystemDetails restore_db_system_details: (required)
3429
+ DB System restore parameters.
3430
+
3431
+ :param str if_match: (optional)
3432
+ For optimistic concurrency control. In the PUT or DELETE call
3433
+
3434
+ :param str opc_request_id: (optional)
3435
+ The client request ID for tracing.
3436
+
3437
+ :param str opc_retry_token: (optional)
3438
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
3439
+
3440
+ :param obj retry_strategy: (optional)
3441
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
3442
+
3443
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
3444
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
3445
+
3446
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
3447
+
3448
+ :param bool allow_control_chars: (optional)
3449
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
3450
+ By default, the response will not allow control characters in strings
3451
+
3452
+ :return: A :class:`~oci.response.Response` object with data of type None
3453
+ :rtype: :class:`~oci.response.Response`
3454
+
3455
+ :example:
3456
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/restore_db_system.py.html>`__ to see an example of how to use restore_db_system API.
3457
+ """
3458
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3459
+ required_arguments = ['dbSystemId']
3460
+ resource_path = "/dbSystems/{dbSystemId}/actions/restore"
3461
+ method = "POST"
3462
+ operation_name = "restore_db_system"
3463
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/RestoreDbSystem"
3464
+
3465
+ # Don't accept unknown kwargs
3466
+ expected_kwargs = [
3467
+ "allow_control_chars",
3468
+ "retry_strategy",
3469
+ "if_match",
3470
+ "opc_request_id",
3471
+ "opc_retry_token"
3472
+ ]
3473
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
3474
+ if extra_kwargs:
3475
+ raise ValueError(
3476
+ f"restore_db_system got unknown kwargs: {extra_kwargs!r}")
3477
+
3478
+ path_params = {
3479
+ "dbSystemId": db_system_id
3480
+ }
3481
+
3482
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
3483
+
3484
+ for (k, v) in six.iteritems(path_params):
3485
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
3486
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
3487
+
3488
+ header_params = {
3489
+ "accept": "application/json",
3490
+ "content-type": "application/json",
3491
+ "if-match": kwargs.get("if_match", missing),
3492
+ "opc-request-id": kwargs.get("opc_request_id", missing),
3493
+ "opc-retry-token": kwargs.get("opc_retry_token", missing)
3494
+ }
3495
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
3496
+
3497
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
3498
+ operation_retry_strategy=kwargs.get('retry_strategy'),
3499
+ client_retry_strategy=self.retry_strategy
3500
+ )
3501
+ if retry_strategy is None:
3502
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
3503
+
3504
+ if retry_strategy:
3505
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
3506
+ self.base_client.add_opc_retry_token_if_needed(header_params)
3507
+ self.base_client.add_opc_client_retries_header(header_params)
3508
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
3509
+ return retry_strategy.make_retrying_call(
3510
+ self.base_client.call_api,
3511
+ resource_path=resource_path,
3512
+ method=method,
3513
+ path_params=path_params,
3514
+ header_params=header_params,
3515
+ body=restore_db_system_details,
3516
+ allow_control_chars=kwargs.get('allow_control_chars'),
3517
+ operation_name=operation_name,
3518
+ api_reference_link=api_reference_link,
3519
+ required_arguments=required_arguments)
3520
+ else:
3521
+ return self.base_client.call_api(
3522
+ resource_path=resource_path,
3523
+ method=method,
3524
+ path_params=path_params,
3525
+ header_params=header_params,
3526
+ body=restore_db_system_details,
3527
+ allow_control_chars=kwargs.get('allow_control_chars'),
3528
+ operation_name=operation_name,
3529
+ api_reference_link=api_reference_link,
3530
+ required_arguments=required_arguments)
3531
+
3532
+ def update_backup(self, backup_id, update_backup_details, **kwargs):
3533
+ """
3534
+ Updates the Backup
3535
+
3536
+
3537
+ :param str backup_id: (required)
3538
+ unique Backup identifier
3539
+
3540
+ :param oci.psql.models.UpdateBackupDetails update_backup_details: (required)
3541
+ The information to be updated.
3542
+
3543
+ :param str if_match: (optional)
3544
+ For optimistic concurrency control. In the PUT or DELETE call
3545
+
3546
+ :param str opc_request_id: (optional)
3547
+ The client request ID for tracing.
3548
+
3549
+ :param obj retry_strategy: (optional)
3550
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
3551
+
3552
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
3553
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
3554
+
3555
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
3556
+
3557
+ :param bool allow_control_chars: (optional)
3558
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
3559
+ By default, the response will not allow control characters in strings
3560
+
3561
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.Backup`
3562
+ :rtype: :class:`~oci.response.Response`
3563
+
3564
+ :example:
3565
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/update_backup.py.html>`__ to see an example of how to use update_backup API.
3566
+ """
3567
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3568
+ required_arguments = ['backupId']
3569
+ resource_path = "/backups/{backupId}"
3570
+ method = "PUT"
3571
+ operation_name = "update_backup"
3572
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Backup/UpdateBackup"
3573
+
3574
+ # Don't accept unknown kwargs
3575
+ expected_kwargs = [
3576
+ "allow_control_chars",
3577
+ "retry_strategy",
3578
+ "if_match",
3579
+ "opc_request_id"
3580
+ ]
3581
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
3582
+ if extra_kwargs:
3583
+ raise ValueError(
3584
+ f"update_backup got unknown kwargs: {extra_kwargs!r}")
3585
+
3586
+ path_params = {
3587
+ "backupId": backup_id
3588
+ }
3589
+
3590
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
3591
+
3592
+ for (k, v) in six.iteritems(path_params):
3593
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
3594
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
3595
+
3596
+ header_params = {
3597
+ "accept": "application/json",
3598
+ "content-type": "application/json",
3599
+ "if-match": kwargs.get("if_match", missing),
3600
+ "opc-request-id": kwargs.get("opc_request_id", missing)
3601
+ }
3602
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
3603
+
3604
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
3605
+ operation_retry_strategy=kwargs.get('retry_strategy'),
3606
+ client_retry_strategy=self.retry_strategy
3607
+ )
3608
+ if retry_strategy is None:
3609
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
3610
+
3611
+ if retry_strategy:
3612
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
3613
+ self.base_client.add_opc_client_retries_header(header_params)
3614
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
3615
+ return retry_strategy.make_retrying_call(
3616
+ self.base_client.call_api,
3617
+ resource_path=resource_path,
3618
+ method=method,
3619
+ path_params=path_params,
3620
+ header_params=header_params,
3621
+ body=update_backup_details,
3622
+ response_type="Backup",
3623
+ allow_control_chars=kwargs.get('allow_control_chars'),
3624
+ operation_name=operation_name,
3625
+ api_reference_link=api_reference_link,
3626
+ required_arguments=required_arguments)
3627
+ else:
3628
+ return self.base_client.call_api(
3629
+ resource_path=resource_path,
3630
+ method=method,
3631
+ path_params=path_params,
3632
+ header_params=header_params,
3633
+ body=update_backup_details,
3634
+ response_type="Backup",
3635
+ allow_control_chars=kwargs.get('allow_control_chars'),
3636
+ operation_name=operation_name,
3637
+ api_reference_link=api_reference_link,
3638
+ required_arguments=required_arguments)
3639
+
3640
+ def update_configuration(self, configuration_id, update_configuration_details, **kwargs):
3641
+ """
3642
+ Updates a display name or description of the Configuration Set.
3643
+
3644
+
3645
+ :param str configuration_id: (required)
3646
+ unique Configuration identifier
3647
+
3648
+ :param oci.psql.models.UpdateConfigurationDetails update_configuration_details: (required)
3649
+ Details for Updating display name or description for Configuration.
3650
+
3651
+ :param str opc_retry_token: (optional)
3652
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
3653
+
3654
+ :param str if_match: (optional)
3655
+ For optimistic concurrency control. In the PUT or DELETE call
3656
+
3657
+ :param str opc_request_id: (optional)
3658
+ The client request ID for tracing.
3659
+
3660
+ :param obj retry_strategy: (optional)
3661
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
3662
+
3663
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
3664
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
3665
+
3666
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
3667
+
3668
+ :param bool allow_control_chars: (optional)
3669
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
3670
+ By default, the response will not allow control characters in strings
3671
+
3672
+ :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.Configuration`
3673
+ :rtype: :class:`~oci.response.Response`
3674
+
3675
+ :example:
3676
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/update_configuration.py.html>`__ to see an example of how to use update_configuration API.
3677
+ """
3678
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3679
+ required_arguments = ['configurationId']
3680
+ resource_path = "/configurations/{configurationId}"
3681
+ method = "PUT"
3682
+ operation_name = "update_configuration"
3683
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Configuration/UpdateConfiguration"
3684
+
3685
+ # Don't accept unknown kwargs
3686
+ expected_kwargs = [
3687
+ "allow_control_chars",
3688
+ "retry_strategy",
3689
+ "opc_retry_token",
3690
+ "if_match",
3691
+ "opc_request_id"
3692
+ ]
3693
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
3694
+ if extra_kwargs:
3695
+ raise ValueError(
3696
+ f"update_configuration got unknown kwargs: {extra_kwargs!r}")
3697
+
3698
+ path_params = {
3699
+ "configurationId": configuration_id
3700
+ }
3701
+
3702
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
3703
+
3704
+ for (k, v) in six.iteritems(path_params):
3705
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
3706
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
3707
+
3708
+ header_params = {
3709
+ "accept": "application/json",
3710
+ "content-type": "application/json",
3711
+ "opc-retry-token": kwargs.get("opc_retry_token", missing),
3712
+ "if-match": kwargs.get("if_match", missing),
3713
+ "opc-request-id": kwargs.get("opc_request_id", missing)
3714
+ }
3715
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
3716
+
3717
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
3718
+ operation_retry_strategy=kwargs.get('retry_strategy'),
3719
+ client_retry_strategy=self.retry_strategy
3720
+ )
3721
+ if retry_strategy is None:
3722
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
3723
+
3724
+ if retry_strategy:
3725
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
3726
+ self.base_client.add_opc_retry_token_if_needed(header_params)
3727
+ self.base_client.add_opc_client_retries_header(header_params)
3728
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
3729
+ return retry_strategy.make_retrying_call(
3730
+ self.base_client.call_api,
3731
+ resource_path=resource_path,
3732
+ method=method,
3733
+ path_params=path_params,
3734
+ header_params=header_params,
3735
+ body=update_configuration_details,
3736
+ response_type="Configuration",
3737
+ allow_control_chars=kwargs.get('allow_control_chars'),
3738
+ operation_name=operation_name,
3739
+ api_reference_link=api_reference_link,
3740
+ required_arguments=required_arguments)
3741
+ else:
3742
+ return self.base_client.call_api(
3743
+ resource_path=resource_path,
3744
+ method=method,
3745
+ path_params=path_params,
3746
+ header_params=header_params,
3747
+ body=update_configuration_details,
3748
+ response_type="Configuration",
3749
+ allow_control_chars=kwargs.get('allow_control_chars'),
3750
+ operation_name=operation_name,
3751
+ api_reference_link=api_reference_link,
3752
+ required_arguments=required_arguments)
3753
+
3754
+ def update_db_system(self, db_system_id, update_db_system_details, **kwargs):
3755
+ """
3756
+ Updates the DbSystem
3757
+
3758
+
3759
+ :param str db_system_id: (required)
3760
+ unique DbSystem identifier
3761
+
3762
+ :param oci.psql.models.UpdateDbSystemDetails update_db_system_details: (required)
3763
+ The information to be updated.
3764
+
3765
+ :param str if_match: (optional)
3766
+ For optimistic concurrency control. In the PUT or DELETE call
3767
+
3768
+ :param str opc_request_id: (optional)
3769
+ The client request ID for tracing.
3770
+
3771
+ :param str opc_retry_token: (optional)
3772
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
3773
+
3774
+ :param obj retry_strategy: (optional)
3775
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
3776
+
3777
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
3778
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
3779
+
3780
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
3781
+
3782
+ :param bool allow_control_chars: (optional)
3783
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
3784
+ By default, the response will not allow control characters in strings
3785
+
3786
+ :return: A :class:`~oci.response.Response` object with data of type None
3787
+ :rtype: :class:`~oci.response.Response`
3788
+
3789
+ :example:
3790
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/update_db_system.py.html>`__ to see an example of how to use update_db_system API.
3791
+ """
3792
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3793
+ required_arguments = ['dbSystemId']
3794
+ resource_path = "/dbSystems/{dbSystemId}"
3795
+ method = "PUT"
3796
+ operation_name = "update_db_system"
3797
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/UpdateDbSystem"
3798
+
3799
+ # Don't accept unknown kwargs
3800
+ expected_kwargs = [
3801
+ "allow_control_chars",
3802
+ "retry_strategy",
3803
+ "if_match",
3804
+ "opc_request_id",
3805
+ "opc_retry_token"
3806
+ ]
3807
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
3808
+ if extra_kwargs:
3809
+ raise ValueError(
3810
+ f"update_db_system got unknown kwargs: {extra_kwargs!r}")
3811
+
3812
+ path_params = {
3813
+ "dbSystemId": db_system_id
3814
+ }
3815
+
3816
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
3817
+
3818
+ for (k, v) in six.iteritems(path_params):
3819
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
3820
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
3821
+
3822
+ header_params = {
3823
+ "accept": "application/json",
3824
+ "content-type": "application/json",
3825
+ "if-match": kwargs.get("if_match", missing),
3826
+ "opc-request-id": kwargs.get("opc_request_id", missing),
3827
+ "opc-retry-token": kwargs.get("opc_retry_token", missing)
3828
+ }
3829
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
3830
+
3831
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
3832
+ operation_retry_strategy=kwargs.get('retry_strategy'),
3833
+ client_retry_strategy=self.retry_strategy
3834
+ )
3835
+ if retry_strategy is None:
3836
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
3837
+
3838
+ if retry_strategy:
3839
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
3840
+ self.base_client.add_opc_retry_token_if_needed(header_params)
3841
+ self.base_client.add_opc_client_retries_header(header_params)
3842
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
3843
+ return retry_strategy.make_retrying_call(
3844
+ self.base_client.call_api,
3845
+ resource_path=resource_path,
3846
+ method=method,
3847
+ path_params=path_params,
3848
+ header_params=header_params,
3849
+ body=update_db_system_details,
3850
+ allow_control_chars=kwargs.get('allow_control_chars'),
3851
+ operation_name=operation_name,
3852
+ api_reference_link=api_reference_link,
3853
+ required_arguments=required_arguments)
3854
+ else:
3855
+ return self.base_client.call_api(
3856
+ resource_path=resource_path,
3857
+ method=method,
3858
+ path_params=path_params,
3859
+ header_params=header_params,
3860
+ body=update_db_system_details,
3861
+ allow_control_chars=kwargs.get('allow_control_chars'),
3862
+ operation_name=operation_name,
3863
+ api_reference_link=api_reference_link,
3864
+ required_arguments=required_arguments)
3865
+
3866
+ def update_db_system_db_instance(self, db_system_id, db_instance_id, update_db_system_db_instance_details, **kwargs):
3867
+ """
3868
+ Updates the DbInstance.
3869
+
3870
+
3871
+ :param str db_system_id: (required)
3872
+ unique DbSystem identifier
3873
+
3874
+ :param str db_instance_id: (required)
3875
+ unique DbInstance identifier
3876
+
3877
+ :param oci.psql.models.UpdateDbSystemDbInstanceDetails update_db_system_db_instance_details: (required)
3878
+ DdInstance update parameters.
3879
+
3880
+ :param str if_match: (optional)
3881
+ For optimistic concurrency control. In the PUT or DELETE call
3882
+
3883
+ :param str opc_request_id: (optional)
3884
+ The client request ID for tracing.
3885
+
3886
+ :param str opc_retry_token: (optional)
3887
+ A token that uniquely identifies a request so it can be retried in case of a timeout or
3888
+
3889
+ :param obj retry_strategy: (optional)
3890
+ A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
3891
+
3892
+ This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided.
3893
+ The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
3894
+
3895
+ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
3896
+
3897
+ :param bool allow_control_chars: (optional)
3898
+ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
3899
+ By default, the response will not allow control characters in strings
3900
+
3901
+ :return: A :class:`~oci.response.Response` object with data of type None
3902
+ :rtype: :class:`~oci.response.Response`
3903
+
3904
+ :example:
3905
+ Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.117.0/psql/update_db_system_db_instance.py.html>`__ to see an example of how to use update_db_system_db_instance API.
3906
+ """
3907
+ # Required path and query arguments. These are in camelCase to replace values in service endpoints.
3908
+ required_arguments = ['dbSystemId', 'dbInstanceId']
3909
+ resource_path = "/dbSystems/{dbSystemId}/dbinstances/{dbInstanceId}"
3910
+ method = "PUT"
3911
+ operation_name = "update_db_system_db_instance"
3912
+ api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/UpdateDbSystemDbInstance"
3913
+
3914
+ # Don't accept unknown kwargs
3915
+ expected_kwargs = [
3916
+ "allow_control_chars",
3917
+ "retry_strategy",
3918
+ "if_match",
3919
+ "opc_request_id",
3920
+ "opc_retry_token"
3921
+ ]
3922
+ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
3923
+ if extra_kwargs:
3924
+ raise ValueError(
3925
+ f"update_db_system_db_instance got unknown kwargs: {extra_kwargs!r}")
3926
+
3927
+ path_params = {
3928
+ "dbSystemId": db_system_id,
3929
+ "dbInstanceId": db_instance_id
3930
+ }
3931
+
3932
+ path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
3933
+
3934
+ for (k, v) in six.iteritems(path_params):
3935
+ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
3936
+ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
3937
+
3938
+ header_params = {
3939
+ "accept": "application/json",
3940
+ "content-type": "application/json",
3941
+ "if-match": kwargs.get("if_match", missing),
3942
+ "opc-request-id": kwargs.get("opc_request_id", missing),
3943
+ "opc-retry-token": kwargs.get("opc_retry_token", missing)
3944
+ }
3945
+ header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
3946
+
3947
+ retry_strategy = self.base_client.get_preferred_retry_strategy(
3948
+ operation_retry_strategy=kwargs.get('retry_strategy'),
3949
+ client_retry_strategy=self.retry_strategy
3950
+ )
3951
+ if retry_strategy is None:
3952
+ retry_strategy = retry.DEFAULT_RETRY_STRATEGY
3953
+
3954
+ if retry_strategy:
3955
+ if not isinstance(retry_strategy, retry.NoneRetryStrategy):
3956
+ self.base_client.add_opc_retry_token_if_needed(header_params)
3957
+ self.base_client.add_opc_client_retries_header(header_params)
3958
+ retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
3959
+ return retry_strategy.make_retrying_call(
3960
+ self.base_client.call_api,
3961
+ resource_path=resource_path,
3962
+ method=method,
3963
+ path_params=path_params,
3964
+ header_params=header_params,
3965
+ body=update_db_system_db_instance_details,
3966
+ allow_control_chars=kwargs.get('allow_control_chars'),
3967
+ operation_name=operation_name,
3968
+ api_reference_link=api_reference_link,
3969
+ required_arguments=required_arguments)
3970
+ else:
3971
+ return self.base_client.call_api(
3972
+ resource_path=resource_path,
3973
+ method=method,
3974
+ path_params=path_params,
3975
+ header_params=header_params,
3976
+ body=update_db_system_db_instance_details,
3977
+ allow_control_chars=kwargs.get('allow_control_chars'),
3978
+ operation_name=operation_name,
3979
+ api_reference_link=api_reference_link,
3980
+ required_arguments=required_arguments)