oci 2.116.0__py3-none-any.whl → 2.118.0__py3-none-any.whl

oci/psql/postgresql_client.py

@@ -22,7 +22,8 @@ missing = Sentinel("Missing")
 
 class PostgresqlClient(object):
     """
-    A description of the PGSQL Control Plane API
+    Use the OCI Database with PostgreSQL API to manage resources such as database systems, database nodes, backups, and configurations.
+    For information, see the user guide documentation for the [service](/iaas/Content/postgresql/home.htm).
     """
 
     def __init__(self, config, **kwargs):
@@ -118,23 +119,27 @@ class PostgresqlClient(object):
 
     def change_backup_compartment(self, backup_id, change_backup_compartment_details, **kwargs):
         """
-        Moves a Backup resource from one compartment identifier to another. When provided, If-Match is checked against ETag values of the resource.
+        Moves a backup from one compartment to another. When provided, If-Match is checked against ETag values of the resource.
 
 
         :param str backup_id: (required)
-            unique Backup identifier
+            A unique identifier for the backup.
 
         :param oci.psql.models.ChangeBackupCompartmentDetails change_backup_compartment_details: (required)
             The information to be updated.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param obj retry_strategy: (optional)
             A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
@@ -152,14 +157,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/change_backup_compartment.py.html>`__ to see an example of how to use change_backup_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/change_backup_compartment.py.html>`__ to see an example of how to use change_backup_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['backupId']
         resource_path = "/backups/{backupId}/actions/changeCompartment"
         method = "POST"
         operation_name = "change_backup_compartment"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Backup/ChangeBackupCompartment"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -230,23 +235,27 @@ class PostgresqlClient(object):
 
     def change_configuration_compartment(self, configuration_id, change_configuration_compartment_details, **kwargs):
         """
-        Moves a Configuration resource from one compartment identifier to another. When provided, If-Match is checked against ETag values of the resource.
+        Moves a configuration from one compartment to another. When provided, If-Match is checked against ETag values of the resource.
 
 
         :param str configuration_id: (required)
-            unique Configuration identifier
+            A unique identifier for the configuration.
 
         :param oci.psql.models.ChangeConfigurationCompartmentDetails change_configuration_compartment_details: (required)
             The information to be updated.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param obj retry_strategy: (optional)
             A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
@@ -260,18 +269,18 @@ class PostgresqlClient(object):
             allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
             By default, the response will not allow control characters in strings
 
-        :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.psql.models.Configuration`
+        :return: A :class:`~oci.response.Response` object with data of type None
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/change_configuration_compartment.py.html>`__ to see an example of how to use change_configuration_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/change_configuration_compartment.py.html>`__ to see an example of how to use change_configuration_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['configurationId']
         resource_path = "/configurations/{configurationId}/actions/changeCompartment"
         method = "POST"
         operation_name = "change_configuration_compartment"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Configuration/ChangeConfigurationCompartment"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -324,7 +333,6 @@ class PostgresqlClient(object):
                 path_params=path_params,
                 header_params=header_params,
                 body=change_configuration_compartment_details,
-                response_type="Configuration",
                 allow_control_chars=kwargs.get('allow_control_chars'),
                 operation_name=operation_name,
                 api_reference_link=api_reference_link,
@@ -336,7 +344,6 @@ class PostgresqlClient(object):
                 path_params=path_params,
                 header_params=header_params,
                 body=change_configuration_compartment_details,
-                response_type="Configuration",
                 allow_control_chars=kwargs.get('allow_control_chars'),
                 operation_name=operation_name,
                 api_reference_link=api_reference_link,
@@ -344,23 +351,27 @@ class PostgresqlClient(object):
 
     def change_db_system_compartment(self, db_system_id, change_db_system_compartment_details, **kwargs):
         """
-        Moves a DbSystem resource from one compartment identifier to another. When provided, If-Match is checked against ETag values of the resource.
+        Moves a database system from one compartment to another. When provided, If-Match is checked against ETag values of the resource.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param oci.psql.models.ChangeDbSystemCompartmentDetails change_db_system_compartment_details: (required)
             The information to be updated.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param obj retry_strategy: (optional)
             A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
@@ -378,14 +389,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/change_db_system_compartment.py.html>`__ to see an example of how to use change_db_system_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/change_db_system_compartment.py.html>`__ to see an example of how to use change_db_system_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId']
         resource_path = "/dbSystems/{dbSystemId}/actions/changeCompartment"
         method = "POST"
         operation_name = "change_db_system_compartment"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/ChangeDbSystemCompartment"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -456,14 +467,17 @@ class PostgresqlClient(object):
 
     def create_backup(self, create_backup_details, **kwargs):
         """
-        Creates a new Backup.
+        Creates a new backup.
 
 
         :param oci.psql.models.CreateBackupDetails create_backup_details: (required)
-            Details for the new Backup.
+            Details for the new backup.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -484,14 +498,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/create_backup.py.html>`__ to see an example of how to use create_backup API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/create_backup.py.html>`__ to see an example of how to use create_backup API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
         resource_path = "/backups"
         method = "POST"
         operation_name = "create_backup"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Backup/CreateBackup"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -548,14 +562,17 @@ class PostgresqlClient(object):
 
     def create_configuration(self, create_configuration_details, **kwargs):
         """
-        Creates a new Configuration Set.
+        Creates a new configuration.
 
 
         :param oci.psql.models.CreateConfigurationDetails create_configuration_details: (required)
-            Details for the new Configuration.
+            Details for the new configuration.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -576,14 +593,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/create_configuration.py.html>`__ to see an example of how to use create_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/create_configuration.py.html>`__ to see an example of how to use create_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
         resource_path = "/configurations"
         method = "POST"
         operation_name = "create_configuration"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Configuration/CreateConfiguration"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -642,14 +659,17 @@ class PostgresqlClient(object):
 
     def create_db_system(self, create_db_system_details, **kwargs):
         """
-        Creates a new DbSystem.
+        Creates a new database system.
 
 
         :param oci.psql.models.CreateDbSystemDetails create_db_system_details: (required)
-            Details for the new DbSystem.
+            Details for the new database system.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -670,14 +690,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/create_db_system.py.html>`__ to see an example of how to use create_db_system API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/create_db_system.py.html>`__ to see an example of how to use create_db_system API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
         resource_path = "/dbSystems"
         method = "POST"
         operation_name = "create_db_system"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/CreateDbSystem"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -736,14 +756,15 @@ class PostgresqlClient(object):
 
     def delete_backup(self, backup_id, **kwargs):
         """
-        Deletes a Backup resource by identifier
+        Deletes a backup by identifier.
 
 
         :param str backup_id: (required)
-            unique Backup identifier
+            A unique identifier for the backup.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -764,14 +785,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/delete_backup.py.html>`__ to see an example of how to use delete_backup API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/delete_backup.py.html>`__ to see an example of how to use delete_backup API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['backupId']
         resource_path = "/backups/{backupId}"
         method = "DELETE"
         operation_name = "delete_backup"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Backup/DeleteBackup"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -837,14 +858,15 @@ class PostgresqlClient(object):
 
     def delete_configuration(self, configuration_id, **kwargs):
         """
-        Deletes a Cofniguration resource by identifier
+        Deletes a configuration by identifier.
 
 
         :param str configuration_id: (required)
-            unique Configuration identifier
+            A unique identifier for the configuration.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -865,14 +887,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/delete_configuration.py.html>`__ to see an example of how to use delete_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/delete_configuration.py.html>`__ to see an example of how to use delete_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['configurationId']
         resource_path = "/configurations/{configurationId}"
         method = "DELETE"
         operation_name = "delete_configuration"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Configuration/DeleteConfiguration"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -938,14 +960,15 @@ class PostgresqlClient(object):
 
     def delete_db_system(self, db_system_id, **kwargs):
         """
-        Deletes a DbSystem resource by identifier
+        Deletes a database system by identifier.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -966,14 +989,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/delete_db_system.py.html>`__ to see an example of how to use delete_db_system API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/delete_db_system.py.html>`__ to see an example of how to use delete_db_system API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId']
         resource_path = "/dbSystems/{dbSystemId}"
         method = "DELETE"
         operation_name = "delete_db_system"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/DeleteDbSystem"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -1039,23 +1062,27 @@ class PostgresqlClient(object):
 
     def failover_db_system(self, db_system_id, failover_db_system_details, **kwargs):
         """
-        Runs a failover operation. Optionally user can specify the desired AD for 3AD regions.
+        Runs a failover operation. Optionally, specify the desired AD for regions with three ADs.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param oci.psql.models.FailoverDbSystemDetails failover_db_system_details: (required)
             The information to be updated.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param obj retry_strategy: (optional)
             A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
@@ -1073,14 +1100,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/failover_db_system.py.html>`__ to see an example of how to use failover_db_system API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/failover_db_system.py.html>`__ to see an example of how to use failover_db_system API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId']
         resource_path = "/dbSystems/{dbSystemId}/actions/failover"
         method = "POST"
         operation_name = "failover_db_system"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/FailoverDbSystem"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -1151,11 +1178,11 @@ class PostgresqlClient(object):
 
     def get_backup(self, backup_id, **kwargs):
         """
-        Gets a Backup by identifier
+        Gets a backup by identifier.
 
 
         :param str backup_id: (required)
-            unique Backup identifier
+            A unique identifier for the backup.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -1176,14 +1203,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/get_backup.py.html>`__ to see an example of how to use get_backup API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/get_backup.py.html>`__ to see an example of how to use get_backup API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['backupId']
         resource_path = "/backups/{backupId}"
         method = "GET"
         operation_name = "get_backup"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Backup/GetBackup"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -1249,11 +1276,11 @@ class PostgresqlClient(object):
 
     def get_configuration(self, configuration_id, **kwargs):
         """
-        Gets a Configuration by identifier
+        Gets a configuration by identifier.
 
 
         :param str configuration_id: (required)
-            unique Configuration identifier
+            A unique identifier for the configuration.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -1274,14 +1301,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/get_configuration.py.html>`__ to see an example of how to use get_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/get_configuration.py.html>`__ to see an example of how to use get_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['configurationId']
         resource_path = "/configurations/{configurationId}"
         method = "GET"
         operation_name = "get_configuration"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Configuration/GetConfiguration"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -1347,11 +1374,11 @@ class PostgresqlClient(object):
 
     def get_connection_details(self, db_system_id, **kwargs):
         """
-        Gets the DbSystem connection details.
+        Gets the database system connection details.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -1372,14 +1399,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/get_connection_details.py.html>`__ to see an example of how to use get_connection_details API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/get_connection_details.py.html>`__ to see an example of how to use get_connection_details API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId']
         resource_path = "/dbSystems/{dbSystemId}/connectionDetails"
         method = "GET"
         operation_name = "get_connection_details"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/ConnectionDetails/GetConnectionDetails"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -1445,17 +1472,17 @@ class PostgresqlClient(object):
 
     def get_db_system(self, db_system_id, **kwargs):
         """
-        Gets a DbSystem by identifier
+        Gets a database system by identifier.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
 
         :param list[str] excluded_fields: (optional)
-            A filter to exclude DB config  when this query param is set to OverrideDbConfig
+            A filter to exclude database configuration when this query parameter is set to OverrideDbConfig.
 
             Allowed values are: "dbConfigurationParams"
 
@@ -1475,14 +1502,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/get_db_system.py.html>`__ to see an example of how to use get_db_system API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/get_db_system.py.html>`__ to see an example of how to use get_db_system API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId']
         resource_path = "/dbSystems/{dbSystemId}"
         method = "GET"
         operation_name = "get_db_system"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/GetDbSystem"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -1564,11 +1591,11 @@ class PostgresqlClient(object):
 
     def get_default_configuration(self, default_configuration_id, **kwargs):
         """
-        Gets a Default Configuration by identifier
+        Gets a default configuration by identifier.
 
 
         :param str default_configuration_id: (required)
-            unique Configuration identifier
+            A unique identifier for the configuration.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -1589,14 +1616,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/get_default_configuration.py.html>`__ to see an example of how to use get_default_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/get_default_configuration.py.html>`__ to see an example of how to use get_default_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['defaultConfigurationId']
         resource_path = "/defaultConfigurations/{defaultConfigurationId}"
         method = "GET"
         operation_name = "get_default_configuration"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DefaultConfiguration/GetDefaultConfiguration"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -1662,11 +1689,11 @@ class PostgresqlClient(object):
 
     def get_primary_db_instance(self, db_system_id, **kwargs):
         """
-        Gets the primary DbInstance details.
+        Gets the primary database instance node details.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -1687,14 +1714,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/get_primary_db_instance.py.html>`__ to see an example of how to use get_primary_db_instance API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/get_primary_db_instance.py.html>`__ to see an example of how to use get_primary_db_instance API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId']
         resource_path = "/dbSystems/{dbSystemId}/primaryDbInstance"
         method = "GET"
         operation_name = "get_primary_db_instance"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/GetPrimaryDbInstance"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -1785,14 +1812,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/get_work_request.py.html>`__ to see an example of how to use get_work_request API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/get_work_request.py.html>`__ to see an example of how to use get_work_request API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['workRequestId']
         resource_path = "/workRequests/{workRequestId}"
         method = "GET"
         operation_name = "get_work_request"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/WorkRequest/GetWorkRequest"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -1858,20 +1885,24 @@ class PostgresqlClient(object):
 
     def list_backups(self, **kwargs):
         """
-        Returns a list of Backup.
+        Returns a list of backups.
 
 
         :param str compartment_id: (optional)
             The ID of the compartment in which to list resources.
 
         :param datetime time_started: (optional)
-            The start date for getting  backups. An RFC3339 formatted datetime string
+            The start date for getting backups. An `RFC 3339`__ formatted datetime string.
+
+            __ https://tools.ietf.org/rfc/rfc3339
 
         :param datetime time_ended: (optional)
-            The End date for getting  backups. An RFC3339 formatted datetime string.
+            The end date for getting backups. An `RFC 3339`__ formatted datetime string.
+
+            __ https://tools.ietf.org/rfc/rfc3339
 
         :param str lifecycle_state: (optional)
-            A filter to return only resources their lifecycleState matches the given lifecycleState.
+            A filter to return only resources if their `lifecycleState` matches the given `lifecycleState`.
 
             Allowed values are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED"
 
@@ -1879,10 +1910,10 @@ class PostgresqlClient(object):
             A filter to return only resources that match the entire display name given.
 
         :param str backup_id: (optional)
-            unique Backup identifier
+            A unique identifier for the backup.
 
         :param str id: (optional)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param int limit: (optional)
             The maximum number of items to return.
@@ -1919,14 +1950,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/list_backups.py.html>`__ to see an example of how to use list_backups API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/list_backups.py.html>`__ to see an example of how to use list_backups API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
         resource_path = "/backups"
         method = "GET"
         operation_name = "list_backups"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/BackupCollection/ListBackups"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -2029,14 +2060,14 @@ class PostgresqlClient(object):
 
     def list_configurations(self, **kwargs):
         """
-        Returns a list of Configurations.
+        Returns a list of configurations.
 
 
         :param str compartment_id: (optional)
             The ID of the compartment in which to list resources.
 
         :param str lifecycle_state: (optional)
-            A filter to return only resources their lifecycleState matches the given lifecycleState.
+            A filter to return only resources if their `lifecycleState` matches the given `lifecycleState`.
 
             Allowed values are: "ACTIVE", "DELETING", "DELETED", "FAILED"
 
@@ -2044,13 +2075,14 @@ class PostgresqlClient(object):
             A filter to return only resources that match the entire display name given.
 
         :param str db_version: (optional)
-            Verison of the Postgresql DB like 14.5
+            Verison of the PostgreSQL database, such as 14.9.
 
         :param str shape: (optional)
-            Shape name of the compute like VM.Standard.E4.Flex or VM.Standard3.Flex
+            The name of the shape for the configuration.
+            Example: `VM.Standard.E4.Flex`
 
         :param str configuration_id: (optional)
-            unique Configuration identifier
+            A unique identifier for the configuration.
 
         :param int limit: (optional)
             The maximum number of items to return.
@@ -2087,14 +2119,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/list_configurations.py.html>`__ to see an example of how to use list_configurations API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/list_configurations.py.html>`__ to see an example of how to use list_configurations API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
         resource_path = "/configurations"
         method = "GET"
         operation_name = "list_configurations"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/ConfigurationCollection/ListConfigurations"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -2195,14 +2227,14 @@ class PostgresqlClient(object):
 
     def list_db_systems(self, **kwargs):
         """
-        Returns a list of DbSystems.
+        Returns a list of database systems.
 
 
         :param str compartment_id: (optional)
             The ID of the compartment in which to list resources.
 
         :param str lifecycle_state: (optional)
-            A filter to return only resources their lifecycleState matches the given lifecycleState.
+            A filter to return only resources if their `lifecycleState` matches the given `lifecycleState`.
 
             Allowed values are: "CREATING", "UPDATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", "FAILED", "NEEDS_ATTENTION"
 
@@ -2210,7 +2242,7 @@ class PostgresqlClient(object):
             A filter to return only resources that match the entire display name given.
 
         :param str id: (optional)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param int limit: (optional)
             The maximum number of items to return.
@@ -2247,14 +2279,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/list_db_systems.py.html>`__ to see an example of how to use list_db_systems API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/list_db_systems.py.html>`__ to see an example of how to use list_db_systems API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
         resource_path = "/dbSystems"
         method = "GET"
         operation_name = "list_db_systems"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystemCollection/ListDbSystems"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -2351,11 +2383,11 @@ class PostgresqlClient(object):
 
     def list_default_configurations(self, **kwargs):
         """
-        Returns a list of Default Configurations.
+        Returns a list of default configurations.
 
 
         :param str lifecycle_state: (optional)
-            A filter to return only resources their lifecycleState matches the given lifecycleState.
+            A filter to return only resources if their `lifecycleState` matches the given `lifecycleState`.
 
             Allowed values are: "ACTIVE", "DELETING", "DELETED", "FAILED"
 
@@ -2363,13 +2395,14 @@ class PostgresqlClient(object):
             A filter to return only resources that match the entire display name given.
 
         :param str db_version: (optional)
-            Verison of the Postgresql DB like 14.5
+            Verison of the PostgreSQL database, such as 14.9.
 
         :param str shape: (optional)
-            Shape name of the compute like VM.Standard.E4.Flex or VM.Standard3.Flex
+            The name of the shape for the configuration.
+            Example: `VM.Standard.E4.Flex`
 
         :param str configuration_id: (optional)
-            unique Configuration identifier
+            A unique identifier for the configuration.
 
         :param int limit: (optional)
             The maximum number of items to return.
@@ -2406,14 +2439,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/list_default_configurations.py.html>`__ to see an example of how to use list_default_configurations API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/list_default_configurations.py.html>`__ to see an example of how to use list_default_configurations API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
         resource_path = "/defaultConfigurations"
         method = "GET"
         operation_name = "list_default_configurations"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DefaultConfigurationCollection/ListDefaultConfigurations"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -2556,14 +2589,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/list_shapes.py.html>`__ to see an example of how to use list_shapes API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/list_shapes.py.html>`__ to see an example of how to use list_shapes API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
         resource_path = "/shapes"
         method = "GET"
         operation_name = "list_shapes"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/ShapeSummary/ListShapes"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -2690,14 +2723,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/list_work_request_errors.py.html>`__ to see an example of how to use list_work_request_errors API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/list_work_request_errors.py.html>`__ to see an example of how to use list_work_request_errors API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['workRequestId']
         resource_path = "/workRequests/{workRequestId}/errors"
         method = "GET"
         operation_name = "list_work_request_errors"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/WorkRequestError/ListWorkRequestErrors"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -2832,14 +2865,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/list_work_request_logs.py.html>`__ to see an example of how to use list_work_request_logs API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/list_work_request_logs.py.html>`__ to see an example of how to use list_work_request_logs API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['workRequestId']
         resource_path = "/workRequests/{workRequestId}/logs"
         method = "GET"
         operation_name = "list_work_request_logs"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/WorkRequestLogEntry/ListWorkRequestLogs"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -2943,7 +2976,7 @@ class PostgresqlClient(object):
             The ID of the asynchronous work request.
 
         :param str status: (optional)
-            A filter to return only resources their lifecycleState matches the given OperationStatus.
+            A filter to return only resources if their `lifecycleState` matches the given OperationStatus.
 
             Allowed values are: "ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED"
 
@@ -2985,14 +3018,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/list_work_requests.py.html>`__ to see an example of how to use list_work_requests API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/list_work_requests.py.html>`__ to see an example of how to use list_work_requests API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
         resource_path = "/workRequests"
         method = "GET"
         operation_name = "list_work_requests"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/WorkRequest/ListWorkRequests"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -3089,17 +3122,18 @@ class PostgresqlClient(object):
 
     def patch_db_system(self, db_system_id, patch_db_system_details, **kwargs):
         """
-        Patching operation allows to add DbInstances to the DbSystem or remove them.
+        Modifies the database system by adding or removing database instance nodes.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param oci.psql.models.PatchDbSystemDetails patch_db_system_details: (required)
-            The information to be patched.
+            The information to be modified.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -3120,14 +3154,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/patch_db_system.py.html>`__ to see an example of how to use patch_db_system API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/patch_db_system.py.html>`__ to see an example of how to use patch_db_system API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId']
         resource_path = "/dbSystems/{dbSystemId}"
         method = "PATCH"
         operation_name = "patch_db_system"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/PatchDbSystem"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -3195,23 +3229,27 @@ class PostgresqlClient(object):
 
     def reset_master_user_password(self, db_system_id, reset_master_user_password_details, **kwargs):
         """
-        Resets the Db system's master password.
+        Resets the database system's master password.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param oci.psql.models.ResetMasterUserPasswordDetails reset_master_user_password_details: (required)
             The information to be updated.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param obj retry_strategy: (optional)
             A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
@@ -3229,14 +3267,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/reset_master_user_password.py.html>`__ to see an example of how to use reset_master_user_password API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/reset_master_user_password.py.html>`__ to see an example of how to use reset_master_user_password API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId']
         resource_path = "/dbSystems/{dbSystemId}/actions/resetMasterUserPassword"
         method = "POST"
         operation_name = "reset_master_user_password"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/ResetMasterUserPassword"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -3307,23 +3345,27 @@ class PostgresqlClient(object):
 
     def restart_db_instance_in_db_system(self, db_system_id, restart_db_instance_in_db_system_details, **kwargs):
         """
-        Restarts the running DbInstance.
+        Restarts the running database instance node.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param oci.psql.models.RestartDbInstanceInDbSystemDetails restart_db_instance_in_db_system_details: (required)
-            DdInstance restart parameters.
+            Database instance node restart parameters.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param obj retry_strategy: (optional)
             A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
@@ -3341,14 +3383,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.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.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.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.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId']
         resource_path = "/dbSystems/{dbSystemId}/actions/restartDbInstance"
         method = "POST"
         operation_name = "restart_db_instance_in_db_system"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/RestartDbInstanceInDbSystem"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -3419,23 +3461,27 @@ class PostgresqlClient(object):
 
     def restore_db_system(self, db_system_id, restore_db_system_details, **kwargs):
         """
-        Restore the Db System.
+        Restore the database system.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param oci.psql.models.RestoreDbSystemDetails restore_db_system_details: (required)
-            DB System restore parameters.
+            Database system restore parameters.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param obj retry_strategy: (optional)
             A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
@@ -3453,14 +3499,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/restore_db_system.py.html>`__ to see an example of how to use restore_db_system API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/restore_db_system.py.html>`__ to see an example of how to use restore_db_system API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId']
         resource_path = "/dbSystems/{dbSystemId}/actions/restore"
         method = "POST"
         operation_name = "restore_db_system"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/RestoreDbSystem"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -3531,17 +3577,18 @@ class PostgresqlClient(object):
 
     def update_backup(self, backup_id, update_backup_details, **kwargs):
         """
-        Updates the Backup
+        Updates the backup.
 
 
         :param str backup_id: (required)
-            unique Backup identifier
+            A unique identifier for the backup.
 
         :param oci.psql.models.UpdateBackupDetails update_backup_details: (required)
             The information to be updated.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -3562,14 +3609,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/update_backup.py.html>`__ to see an example of how to use update_backup API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/update_backup.py.html>`__ to see an example of how to use update_backup API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['backupId']
         resource_path = "/backups/{backupId}"
         method = "PUT"
         operation_name = "update_backup"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Backup/UpdateBackup"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -3639,20 +3686,24 @@ class PostgresqlClient(object):
 
     def update_configuration(self, configuration_id, update_configuration_details, **kwargs):
         """
-        Updates a display name or description of the Configuration Set.
+        Updates a display name or description of the configuration.
 
 
         :param str configuration_id: (required)
-            unique Configuration identifier
+            A unique identifier for the configuration.
 
         :param oci.psql.models.UpdateConfigurationDetails update_configuration_details: (required)
-            Details for Updating display name or description for Configuration.
+            Details for updating display name or description for a configuration.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
@@ -3673,14 +3724,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/update_configuration.py.html>`__ to see an example of how to use update_configuration API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/update_configuration.py.html>`__ to see an example of how to use update_configuration API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['configurationId']
         resource_path = "/configurations/{configurationId}"
         method = "PUT"
         operation_name = "update_configuration"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/Configuration/UpdateConfiguration"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -3753,23 +3804,27 @@ class PostgresqlClient(object):
 
     def update_db_system(self, db_system_id, update_db_system_details, **kwargs):
         """
-        Updates the DbSystem
+        Updates the database system.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param oci.psql.models.UpdateDbSystemDetails update_db_system_details: (required)
             The information to be updated.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param obj retry_strategy: (optional)
             A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
@@ -3787,14 +3842,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/update_db_system.py.html>`__ to see an example of how to use update_db_system API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/update_db_system.py.html>`__ to see an example of how to use update_db_system API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId']
         resource_path = "/dbSystems/{dbSystemId}"
         method = "PUT"
         operation_name = "update_db_system"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/UpdateDbSystem"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -3865,26 +3920,30 @@ class PostgresqlClient(object):
 
     def update_db_system_db_instance(self, db_system_id, db_instance_id, update_db_system_db_instance_details, **kwargs):
         """
-        Updates the DbInstance.
+        Updates the database instance node.
 
 
         :param str db_system_id: (required)
-            unique DbSystem identifier
+            A unique identifier for the database system.
 
         :param str db_instance_id: (required)
-            unique DbInstance identifier
+            A unique identifier for the database instance node.
 
         :param oci.psql.models.UpdateDbSystemDbInstanceDetails update_db_system_db_instance_details: (required)
-            DdInstance update parameters.
+            Database instance node update parameters.
 
         :param str if_match: (optional)
-            For optimistic concurrency control. In the PUT or DELETE call
+            For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource.
+            The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
 
         :param str opc_request_id: (optional)
             The client request ID for tracing.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
+            server error without risk of executing that same action again. Retry tokens expire after 24
+            hours, but can be invalidated before then due to conflicting operations. For example, if a resource
+            has been deleted and purged from the system, `retrytoken` could be expired or invalidated.
 
         :param obj retry_strategy: (optional)
             A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
@@ -3902,14 +3961,14 @@ class PostgresqlClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.116.0/psql/update_db_system_db_instance.py.html>`__ to see an example of how to use update_db_system_db_instance API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.0/psql/update_db_system_db_instance.py.html>`__ to see an example of how to use update_db_system_db_instance API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['dbSystemId', 'dbInstanceId']
         resource_path = "/dbSystems/{dbSystemId}/dbinstances/{dbInstanceId}"
         method = "PUT"
         operation_name = "update_db_system_db_instance"
-        api_reference_link = ""
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/postgresql/20220915/DbSystem/UpdateDbSystemDbInstance"
 
         # Don't accept unknown kwargs
         expected_kwargs = [