oci 2.125.3__py3-none-any.whl → 2.126.1__py3-none-any.whl

oci/os_management_hub/management_station_client.py

@@ -22,7 +22,8 @@ missing = Sentinel("Missing")
 
 class ManagementStationClient(object):
     """
-    Use the OS Management Hub API to manage and monitor updates and patches for the operating system environments in your private data centers through a single management console. For more information, see [Overview of OS Management Hub](https://docs.cloud.oracle.com/iaas/osmh/doc/overview.htm).
+    Use the OS Management Hub API to manage and monitor updates and patches for instances in OCI, your private data center, or 3rd-party clouds.
+    For more information, see [Overview of OS Management Hub](https://docs.cloud.oracle.com/iaas/osmh/doc/overview.htm).
     """
 
     def __init__(self, config, **kwargs):
@@ -116,13 +117,137 @@ class ManagementStationClient(object):
         self.retry_strategy = kwargs.get('retry_strategy')
         self.circuit_breaker_callback = kwargs.get('circuit_breaker_callback')
 
+    def change_management_station_compartment(self, management_station_id, change_management_station_compartment_details, **kwargs):
+        """
+        Moves a managment station to a different compartment.
+
+
+        :param str management_station_id: (required)
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+        :param oci.os_management_hub.models.ChangeManagementStationCompartmentDetails change_management_station_compartment_details: (required)
+            The `OCID`__ of the compartment to move the management station to.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+        :param str opc_request_id: (optional)
+            Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
+
+        :param str if_match: (optional)
+            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_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, then a retry of the original creation request
+            might be rejected.
+
+        :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.
+
+            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.
+            The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
+
+            To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
+
+        :param bool allow_control_chars: (optional)
+            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 None
+        :rtype: :class:`~oci.response.Response`
+
+        :example:
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.126.1/osmanagementhub/change_management_station_compartment.py.html>`__ to see an example of how to use change_management_station_compartment API.
+        """
+        # Required path and query arguments. These are in camelCase to replace values in service endpoints.
+        required_arguments = ['managementStationId']
+        resource_path = "/managementStations/{managementStationId}/actions/changeCompartment"
+        method = "POST"
+        operation_name = "change_management_station_compartment"
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/osmh/20220901/ManagementStation/ChangeManagementStationCompartment"
+
+        # Don't accept unknown kwargs
+        expected_kwargs = [
+            "allow_control_chars",
+            "retry_strategy",
+            "opc_request_id",
+            "if_match",
+            "opc_retry_token"
+        ]
+        extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
+        if extra_kwargs:
+            raise ValueError(
+                f"change_management_station_compartment got unknown kwargs: {extra_kwargs!r}")
+
+        path_params = {
+            "managementStationId": management_station_id
+        }
+
+        path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
+
+        for (k, v) in six.iteritems(path_params):
+            if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
+                raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
+
+        header_params = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "opc-request-id": kwargs.get("opc_request_id", missing),
+            "if-match": kwargs.get("if_match", missing),
+            "opc-retry-token": kwargs.get("opc_retry_token", missing)
+        }
+        header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
+
+        retry_strategy = self.base_client.get_preferred_retry_strategy(
+            operation_retry_strategy=kwargs.get('retry_strategy'),
+            client_retry_strategy=self.retry_strategy
+        )
+        if retry_strategy is None:
+            retry_strategy = retry.DEFAULT_RETRY_STRATEGY
+
+        if retry_strategy:
+            if not isinstance(retry_strategy, retry.NoneRetryStrategy):
+                self.base_client.add_opc_retry_token_if_needed(header_params)
+                self.base_client.add_opc_client_retries_header(header_params)
+                retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
+            return retry_strategy.make_retrying_call(
+                self.base_client.call_api,
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                body=change_management_station_compartment_details,
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+        else:
+            return self.base_client.call_api(
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                body=change_management_station_compartment_details,
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+
     def create_management_station(self, create_management_station_details, **kwargs):
         """
-        Creates a management station.
+        Create a management station. You must provide proxy and mirror configuration information.
 
 
         :param oci.os_management_hub.models.CreateManagementStationDetails create_management_station_details: (required)
-            Details for the new ManagementStation.
+            Provides the information used to create a management station.
 
         :param str opc_retry_token: (optional)
             A token that uniquely identifies a request so it can be retried in case of a timeout or
@@ -150,7 +275,7 @@ class ManagementStationClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.3/osmanagementhub/create_management_station.py.html>`__ to see an example of how to use create_management_station API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.126.1/osmanagementhub/create_management_station.py.html>`__ to see an example of how to use create_management_station API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -220,7 +345,9 @@ class ManagementStationClient(object):
 
 
         :param str management_station_id: (required)
-            The OCID of the management station.
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param str if_match: (optional)
             For optimistic concurrency control. In the PUT or DELETE call
@@ -248,7 +375,7 @@ class ManagementStationClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.3/osmanagementhub/delete_management_station.py.html>`__ to see an example of how to use delete_management_station API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.126.1/osmanagementhub/delete_management_station.py.html>`__ to see an example of how to use delete_management_station API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['managementStationId']
@@ -325,7 +452,9 @@ class ManagementStationClient(object):
 
 
         :param str management_station_id: (required)
-            The OCID of the management station.
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param str opc_request_id: (optional)
             Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
@@ -346,7 +475,7 @@ class ManagementStationClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.3/osmanagementhub/get_management_station.py.html>`__ to see an example of how to use get_management_station API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.126.1/osmanagementhub/get_management_station.py.html>`__ to see an example of how to use get_management_station API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['managementStationId']
@@ -423,23 +552,23 @@ class ManagementStationClient(object):
 
 
         :param str compartment_id: (optional)
-            The OCID of the compartment that contains the resources to list.
+            The OCID of the compartment that contains the resources to list. This filter returns only resources contained within the specified compartment.
 
         :param str display_name: (optional)
-            A user-friendly name. Does not have to be unique, and it's changeable.
-
-            Example: `My new resource`
+            A filter to return resources that match the given user-friendly name.
 
         :param str display_name_contains: (optional)
             A filter to return resources that may partially match the given display name.
 
         :param str lifecycle_state: (optional)
-            The current lifecycle state for the object.
+            A filter that returns information for management stations in the specified state.
 
             Allowed values are: "CREATING", "UPDATING", "ACTIVE", "DELETING", "DELETED", "FAILED"
 
         :param str managed_instance_id: (optional)
-            The OCID of the managed instance for which to list resources.
+            The `OCID`__ of the managed instance. This filter returns resources associated with this managed instance.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param int limit: (optional)
             For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call.
@@ -471,7 +600,9 @@ class ManagementStationClient(object):
             Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
 
         :param str id: (optional)
-            The OCID of the management station.
+            The `OCID`__ of the management station. A filter that returns information about the specified management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :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.
@@ -489,7 +620,7 @@ class ManagementStationClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.3/osmanagementhub/list_management_stations.py.html>`__ to see an example of how to use list_management_stations API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.126.1/osmanagementhub/list_management_stations.py.html>`__ to see an example of how to use list_management_stations API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -601,12 +732,12 @@ class ManagementStationClient(object):
 
 
         :param str management_station_id: (required)
-            The OCID of the management station.
+            The `OCID`__ of the management station.
 
-        :param str display_name: (optional)
-            A user-friendly name. Does not have to be unique, and it's changeable.
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
-            Example: `My new resource`
+        :param str display_name: (optional)
+            A filter to return resources that match the given user-friendly name.
 
         :param str display_name_contains: (optional)
             A filter to return resources that may partially match the given display name.
@@ -661,7 +792,7 @@ class ManagementStationClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.3/osmanagementhub/list_mirrors.py.html>`__ to see an example of how to use list_mirrors API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.126.1/osmanagementhub/list_mirrors.py.html>`__ to see an example of how to use list_mirrors API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['managementStationId']
@@ -774,13 +905,132 @@ class ManagementStationClient(object):
                 api_reference_link=api_reference_link,
                 required_arguments=required_arguments)
 
+    def refresh_management_station_config(self, management_station_id, **kwargs):
+        """
+        Refreshes the list of software sources mirrored by the management station to support the associated instances.
+
+
+        :param str management_station_id: (required)
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+        :param str opc_request_id: (optional)
+            Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
+
+        :param str if_match: (optional)
+            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_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, then a retry of the original creation request
+            might be rejected.
+
+        :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.
+
+            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.
+            The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
+
+            To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
+
+        :param bool allow_control_chars: (optional)
+            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 None
+        :rtype: :class:`~oci.response.Response`
+
+        :example:
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.126.1/osmanagementhub/refresh_management_station_config.py.html>`__ to see an example of how to use refresh_management_station_config API.
+        """
+        # Required path and query arguments. These are in camelCase to replace values in service endpoints.
+        required_arguments = ['managementStationId']
+        resource_path = "/managementStations/{managementStationId}/actions/refresh"
+        method = "POST"
+        operation_name = "refresh_management_station_config"
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/osmh/20220901/ManagementStation/RefreshManagementStationConfig"
+
+        # Don't accept unknown kwargs
+        expected_kwargs = [
+            "allow_control_chars",
+            "retry_strategy",
+            "opc_request_id",
+            "if_match",
+            "opc_retry_token"
+        ]
+        extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
+        if extra_kwargs:
+            raise ValueError(
+                f"refresh_management_station_config got unknown kwargs: {extra_kwargs!r}")
+
+        path_params = {
+            "managementStationId": management_station_id
+        }
+
+        path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
+
+        for (k, v) in six.iteritems(path_params):
+            if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
+                raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
+
+        header_params = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "opc-request-id": kwargs.get("opc_request_id", missing),
+            "if-match": kwargs.get("if_match", missing),
+            "opc-retry-token": kwargs.get("opc_retry_token", missing)
+        }
+        header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
+
+        retry_strategy = self.base_client.get_preferred_retry_strategy(
+            operation_retry_strategy=kwargs.get('retry_strategy'),
+            client_retry_strategy=self.retry_strategy
+        )
+        if retry_strategy is None:
+            retry_strategy = retry.DEFAULT_RETRY_STRATEGY
+
+        if retry_strategy:
+            if not isinstance(retry_strategy, retry.NoneRetryStrategy):
+                self.base_client.add_opc_retry_token_if_needed(header_params)
+                self.base_client.add_opc_client_retries_header(header_params)
+                retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
+            return retry_strategy.make_retrying_call(
+                self.base_client.call_api,
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+        else:
+            return self.base_client.call_api(
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+
     def synchronize_mirrors(self, management_station_id, synchronize_mirrors_details, **kwargs):
         """
-        Synchronizes the specified mirrors associated with the management station.
+        Synchronize the specified software sources mirrors on the management station.
 
 
         :param str management_station_id: (required)
-            The OCID of the management station.
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.SynchronizeMirrorsDetails synchronize_mirrors_details: (required)
             Details for syncing mirrors
@@ -818,7 +1068,7 @@ class ManagementStationClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.3/osmanagementhub/synchronize_mirrors.py.html>`__ to see an example of how to use synchronize_mirrors API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.126.1/osmanagementhub/synchronize_mirrors.py.html>`__ to see an example of how to use synchronize_mirrors API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['managementStationId']
@@ -896,11 +1146,13 @@ class ManagementStationClient(object):
 
     def synchronize_single_mirrors(self, management_station_id, mirror_id, **kwargs):
         """
-        Synchronize the specified mirror associated with a management station.
+        Synchronize the specified software source mirrors on the management station.
 
 
         :param str management_station_id: (required)
-            The OCID of the management station.
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param str mirror_id: (required)
             Unique Software Source identifier
@@ -938,7 +1190,7 @@ class ManagementStationClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.3/osmanagementhub/synchronize_single_mirrors.py.html>`__ to see an example of how to use synchronize_single_mirrors API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.126.1/osmanagementhub/synchronize_single_mirrors.py.html>`__ to see an example of how to use synchronize_single_mirrors API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['managementStationId', 'mirrorId']
@@ -1019,10 +1271,12 @@ class ManagementStationClient(object):
 
 
         :param str management_station_id: (required)
-            The OCID of the management station.
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.UpdateManagementStationDetails update_management_station_details: (required)
-            The information to be updated.
+            The information used to update the management station.
 
         :param str if_match: (optional)
             For optimistic concurrency control. In the PUT or DELETE call
@@ -1050,7 +1304,7 @@ class ManagementStationClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.125.3/osmanagementhub/update_management_station.py.html>`__ to see an example of how to use update_management_station API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.126.1/osmanagementhub/update_management_station.py.html>`__ to see an example of how to use update_management_station API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['managementStationId']

oci/os_management_hub/management_station_client_composite_operations.py

@@ -31,7 +31,7 @@ class ManagementStationClientCompositeOperations(object):
         to enter the given state(s).
 
         :param oci.os_management_hub.models.CreateManagementStationDetails create_management_station_details: (required)
-            Details for the new ManagementStation.
+            Provides the information used to create a management station.
 
         :param list[str] wait_for_states:
             An array of states to wait on. These should be valid values for :py:attr:`~oci.os_management_hub.models.ManagementStation.lifecycle_state`
@@ -73,7 +73,9 @@ class ManagementStationClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str management_station_id: (required)
-            The OCID of the management station.
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param list[str] wait_for_states:
             An array of states to wait on. These should be valid values for :py:attr:`~oci.os_management_hub.models.ManagementStation.lifecycle_state`
@@ -126,13 +128,56 @@ class ManagementStationClientCompositeOperations(object):
         except Exception as e:
             raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e)
 
+    def refresh_management_station_config_and_wait_for_state(self, management_station_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}):
+        """
+        Calls :py:func:`~oci.os_management_hub.ManagementStationClient.refresh_management_station_config` and waits for the :py:class:`~oci.os_management_hub.models.WorkRequest`
+        to enter the given state(s).
+
+        :param str management_station_id: (required)
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+        :param list[str] wait_for_states:
+            An array of states to wait on. These should be valid values for :py:attr:`~oci.os_management_hub.models.WorkRequest.status`
+
+        :param dict operation_kwargs:
+            A dictionary of keyword arguments to pass to :py:func:`~oci.os_management_hub.ManagementStationClient.refresh_management_station_config`
+
+        :param dict waiter_kwargs:
+            A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds``
+            as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait
+        """
+        operation_result = self.client.refresh_management_station_config(management_station_id, **operation_kwargs)
+        if not wait_for_states:
+            return operation_result
+        lowered_wait_for_states = [w.lower() for w in wait_for_states]
+        if 'opc-work-request-id' not in operation_result.headers:
+            return operation_result
+        wait_for_resource_id = operation_result.headers['opc-work-request-id']
+
+        try:
+            waiter_result = oci.wait_until(
+                self.client,
+                self.client.get_work_request(wait_for_resource_id),
+                evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_wait_for_states,
+                **waiter_kwargs
+            )
+            result_to_return = waiter_result
+
+            return result_to_return
+        except Exception as e:
+            raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e)
+
     def synchronize_mirrors_and_wait_for_state(self, management_station_id, synchronize_mirrors_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}):
         """
         Calls :py:func:`~oci.os_management_hub.ManagementStationClient.synchronize_mirrors` and waits for the :py:class:`~oci.os_management_hub.models.WorkRequest`
         to enter the given state(s).
 
         :param str management_station_id: (required)
-            The OCID of the management station.
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.SynchronizeMirrorsDetails synchronize_mirrors_details: (required)
             Details for syncing mirrors
@@ -174,7 +219,9 @@ class ManagementStationClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str management_station_id: (required)
-            The OCID of the management station.
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param str mirror_id: (required)
             Unique Software Source identifier
@@ -216,10 +263,12 @@ class ManagementStationClientCompositeOperations(object):
         to enter the given state(s).
 
         :param str management_station_id: (required)
-            The OCID of the management station.
+            The `OCID`__ of the management station.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param oci.os_management_hub.models.UpdateManagementStationDetails update_management_station_details: (required)
-            The information to be updated.
+            The information used to update the management station.
 
         :param list[str] wait_for_states:
             An array of states to wait on. These should be valid values for :py:attr:`~oci.os_management_hub.models.ManagementStation.lifecycle_state`