pyegeria 5.3.10__py3-none-any.whl → 5.4.0__py3-none-any.whl

pyegeria/governance_officer_omvs.py

@@ -0,0 +1,2367 @@
+"""PDX-License-Identifier: Apache-2.0
+Copyright Contributors to the ODPi Egeria project.
+
+This module provides access to the Governance Officer OMVS module.
+
+
+"""
+
+import asyncio
+import os
+import sys
+from typing import Dict, List, Union
+
+from httpx import Response
+
+from pyegeria._validators import validate_guid
+from pyegeria._client import Client
+from pyegeria._globals import NO_ELEMENTS_FOUND
+from pyegeria.output_formatter import generate_output, extract_mermaid_only
+from pyegeria.utils import body_slimmer
+
+sys.path.insert(0, os.path.abspath(os.path.dirname(__file__)))
+
+DEFAULT_BODY_SKELETON = {
+    "effective_time": None, "limitResultsByStatus": ["ACTIVE"], "asOfTime": None, "sequencingOrder": None,
+    "sequencingProperty": None, "filter": None,
+    }
+
+
+def query_seperator(current_string):
+    if current_string == "":
+        return "?"
+    else:
+        return "&"
+
+
+# ("params are in the form of [(paramName, value), (param2Name, value)] if the value is not None, it will be added to "
+# "the query string")
+
+
+def query_string(params):
+    result = ""
+    for i in range(len(params)):
+        if params[i][1] is not None:
+            result = f"{result}{query_seperator(result)}{params[i][0]}={params[i][1]}"
+    return result
+
+
+def base_path(client, view_server: str):
+    return f"{client.platform_url}/servers/governance-officer/api/open-metadata/metadata-explorer"
+
+
+class GovernanceOfficer(Client):
+    """GovernanceOfficer is a class that extends the Client class. The Governance Officer OMVS provides APIs for
+      defining and managing governance definitions.
+
+    Attributes:
+
+        view_server: str
+            The name of the View Server to connect to.
+        platform_url : str
+            URL of the server platform to connect to
+        user_id : str
+            The identity of the user calling the method - this sets a
+            default optionally used by the methods when the user
+            doesn't pass the user_id on a method call.
+        user_pwd: str
+            The password associated with the user_id. Defaults to None
+
+
+    """
+
+    def __init__(self, view_server: str, platform_url: str, user_id: str = None, user_pwd: str = None,
+                 token: str = None, ):
+        self.view_server = view_server
+        self.platform_url = platform_url
+        self.user_id = user_id
+        self.user_pwd = user_pwd
+
+        Client.__init__(self, view_server, platform_url, user_id=user_id, user_pwd=user_pwd, token=token)
+        self.url_marker = "governance-officer"
+
+    #
+    # Extract properties functions
+    #
+    def generate_governance_definition_output(self, elements: list | dict, search_string: str,
+                                              output_format: str = 'MD') -> str | list:
+        """
+        Generate output for solution components in the specified format.
+
+        Given a set of elements representing solution components (either as a list or a dictionary),
+        this function generates output in the specified format. The output includes various
+        attributes of the solution components, such as their names, descriptions, types, and
+        related information like blueprints, parents, and extended properties.
+
+        Args:
+            elements: Dictionary or list of dictionaries containing solution component elements
+            search_string: The search string used to find the elements
+            output_format: The desired output format (MD, FORM, REPORT, LIST, DICT, MERMAID, HTML)
+
+        Returns:
+            Formatted output as string or list of dictionaries
+        """
+        # Handle MERMAID and DICT formats
+        if output_format == "MERMAID":
+            return extract_mermaid_only(elements)
+        elif output_format == "DICT":
+            return self._extract_gov_def_list(elements)  # return extract_basic_dict(elements)  # add more to the body
+        elif output_format == "HTML":
+            return generate_output(elements=elements, search_string=search_string, entity_type="Governance Definition",
+                output_format="HTML", extract_properties_func=self._extract_gov_def_properties)
+        # For other formats (MD, FORM, REPORT, LIST), use generate_output
+        elif output_format in ["MD", "FORM", "REPORT", "LIST"]:
+            # Define columns for LIST format
+            columns = [{'name': 'Governance Definition', 'key': 'title'}, {'name': 'Type Name', 'key': 'typeName'},
+                {'name': 'Scope', 'key': 'scope'}, {'name': 'Qualified Name', 'key': 'documentIdentifier'},
+                {'name': 'Summary', 'key': 'summary', 'format': True}, {'name': 'Importance', 'key': 'importance'}, ]
+
+            return generate_output(elements=elements, search_string=search_string, entity_type="Governance Definition",
+                output_format=output_format, extract_properties_func=self._extract_gov_def_properties,
+                columns=columns if output_format == 'LIST' else None)
+
+        # Default case
+        return None
+
+    #
+    #
+    #
+
+
+    def _extract_gov_def_properties(self, element: dict) -> dict:
+        """
+        Extract properties from an information governance definition element.
+
+        Args:
+            element: Dictionary containing element data
+
+        Returns:
+            Dictionary with extracted properties
+        """
+        guid = element['elementHeader'].get("guid", None)
+        properties = element['properties']
+        properties['GUID'] = guid
+        mermaid = element.get('mermaidGraph', "") or ""
+        properties['Mermaid'] = mermaid
+        del properties['class']
+
+        #
+        #
+        # qualified_name = properties.get("qualifiedName", None)
+        # display_name = properties.get("displayName", None)
+        # description = properties.get("description", None)
+        # scope = properties.get("scope", None)
+        # purposes = properties.get("purposes", [])
+        # purpose_md = ""
+        # if len(purposes) > 0:
+        #     for purpose in purposes:
+        #         purpose_md += f"{purpose},\n"
+        # extended_properties = properties.get("extendedProperties", {})
+        # additional_properties = properties.get("additionalProperties", {})
+        #
+
+        return properties
+
+    def _extract_gov_def_list(self, element: Union[Dict, List[Dict]]) -> List[Dict]:
+        """
+        Normalize for a list of dictionaries.
+        Args:
+            element: Dict or List
+
+        Returns:
+            list of Dict
+
+        """
+        if isinstance(element, dict):
+            return [self._extract_gov_def_properties(element)]
+        elif isinstance(element, list):
+            def_list = []
+            for i in range(len(element)):
+                def_list.append(self._extract_gov_def_properties(element[i]))
+            return def_list
+        else:
+            return []
+
+    def _extract_solution_components_properties(self, element: Union[Dict, List[Dict]]) -> dict:
+        """
+        Extract properties from a solution component element.
+
+        Args:
+            element: Dictionary containing element data
+
+        Returns:
+            Dictionary with extracted properties
+        """
+
+        guid = element['elementHeader'].get("guid", None)
+        properties = element.get('glossaryCategoryProperties', element.get('properties', {}))
+        display_name = properties.get("displayName", None)
+        description = properties.get("description", None)
+        component_type = properties.get("solutionComponentType", properties.get("componentType", None))
+        version = properties.get("version", None)
+        qualified_name = properties.get("qualifiedName", None)
+
+        # Extract extended properties
+        extended_props = properties.get("extendedProperties", None)
+        extended_props_md = ""
+        if extended_props:
+            for key in extended_props.keys():
+                extended_props_md += "{" + f" {key}: {extended_props[key]}" + " }, "
+
+        # Extract additional properties
+        additional_props = properties.get("additionalProperties", None)
+        additional_props_md = ""
+        if additional_props:
+            for key in additional_props.keys():
+                additional_props_md += "{" + f" {key}: {additional_props[key]}" + " }, "
+
+        # Extract blueprints
+        blueprints_md = ""
+        blueprints = element.get('blueprints', None)
+        if blueprints:
+            for blueprint in blueprints:
+                if 'relatedElement' in blueprint:
+                    bp_q_name = blueprint["relatedElement"]['properties']['qualifiedName']
+                    blueprints_md += f" {bp_q_name}, \n"
+                elif 'blueprint' in blueprint:
+                    bp_prop = blueprint['blueprint']['properties']
+                    bp_name = bp_prop.get("displayName", None)
+                    bp_desc = bp_prop.get("description", None)
+                    blueprints_md += "{" + f" {bp_name}:\t {bp_desc}" + " },\n"
+
+        # Extract parent components
+        parent_comp_md = ""
+        context = element.get("context", None)
+        if context:
+            parent_components = element.get('parentComponents', None)
+            if parent_components:
+                for parent_component in parent_components:
+                    parent_comp_prop = parent_component['parentComponent']['properties']
+                    parent_comp_name = parent_comp_prop.get("name", None)
+                    parent_comp_desc = parent_comp_prop.get("description", None)
+                    parent_comp_md += f" {parent_comp_name}"
+
+        # Extract sub components
+        sub_comp_md = ""
+        sub_components = element.get('subComponents', None)
+        if sub_components:
+            for sub_component in sub_components:
+                sub_comp_prop = sub_component['properties']
+                sub_comp_name = sub_comp_prop.get("displayName", None)
+                sub_comp_desc = sub_comp_prop.get("description", None)
+                sub_comp_md += f" {sub_comp_name}"
+
+        comp_graph = element.get('mermaidGraph', None)
+
+        return {
+            'guid': guid, 'qualified_name': qualified_name, 'display_name': display_name, 'description': description,
+            'component_type': component_type, 'version': version, 'blueprints': blueprints_md,
+            'parent_components': parent_comp_md, 'sub_components': sub_comp_md,
+            'additional_properties': additional_props_md, 'extended_properties': extended_props_md,
+            'mermaid_graph': comp_graph
+            }
+
+    #
+    # Markdown output support
+    #
+
+    async def _async_create_governance_definition(self, body: dict) -> str:
+        """ Create a governance definition. There are many kinds of governance definition and
+            while the overall body structure is the same, many will have different property
+            structures nested within them. A list is shown in the notes below.
+
+        It may be of type:
+            * BusinessImperative
+            * RegulationArticle
+            * Threat
+            * GovernancePrinciple
+            * GovernanceObligation
+            * GovernanceApproach
+            * GovernanceProcessingPurpose
+            The type is added to the "typeName" property.
+
+            Async Version.
+
+        Parameters
+        ----------
+        body: dict
+            A dictionary containing the definition of the governance definition to create.
+
+        Returns
+        -------
+
+        str - guid of the definition created.
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+        Governance definitions can be simple or anchored to a parent element -  Both are shown below. depending on
+        which structure is used for the body.
+
+        Many kinds of governance definition have additional properties added. Details are described in the UML diagrams
+        on the website and summarized in the table below which shows the property class name and which types
+        of governance definitions use it. The test_governance_officer module offers some usage examples.
+
+        Property Class Name     |       Definition Types
+        ===================================================================================
+        GovernanceDefinitionProperties | BusinessImperative, RegulationArticle, Threat, GovernanceProcessingPurpose,
+                                       | GovernancePrinciple, GovernanceObligation, GovernanceApproach
+        GovernanceStrategyProperties   | GovernanceStrategy
+        RegulationProperties           | Regulation
+        GovernanceControlProperties    | GovernanceControl
+        SecurityGroupProperties        | SecurityGroup
+        NamingStandardRuleProperties   | NamingStandardRule
+        CertificationTypeProperties    | CertificationType
+        LicenseTyoeProperties          | LicenseType
+        GovernanceApproachProperties   | GovernanceApproach
+
+
+        Generic simple governance body structure:
+        {
+          "class": "NewElementRequestBody",
+          "properties": {
+            "class" : "GovernanceDefinitionProperties",
+            "typeName" : "enter the type of the governance definition",
+            "domainIdentifier": 0,
+            "documentIdentifier": "add unique name here",
+            "title": "add short name here",
+            "summary": "add summary here",
+            "description": "add description here",
+            "scope": "add scope of effect for this definition",
+            "importance": "add importance for this definition",
+            "implications": [],
+            "outcomes": [],
+            "results": [],
+            "additionalProperties": {
+              "property1" : "propertyValue1",
+              "property2" : "propertyValue2"
+            }
+          },
+          "initialStatus": "DRAFT"
+        }
+
+        Generic governance Body structure with Parent:
+        {
+          "class" : "NewGovernanceDefinitionRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "anchorGUID" : "add guid here",
+          "isOwnAnchor": false,
+          "parentGUID": "add guid here",
+          "parentRelationshipTypeName": "add type name here",
+          "parentRelationshipProperties": {
+            "class": "ElementProperties",
+            "propertyValueMap" : {
+              "description" : {
+                "class": "PrimitiveTypePropertyValue",
+                "typeName": "string",
+                "primitiveValue" : "New description"
+              }
+            }
+          },
+          "parentAtEnd1": false,
+          "properties": {
+            "class" : "GovernanceDefinitionProperties",
+            "typeName" : "enter the type of the governance definition",
+            "domainIdentifier": 0,
+            "documentIdentifier": "add unique name here",
+            "title": "add short name here",
+            "summary": "add summary here",
+            "description": "add description here",
+            "scope": "add scope of effect for this definition",
+            "importance": "add importance for this definition",
+            "implications": [],
+            "outcomes": [],
+            "results": [],
+            "additionalProperties": {
+              "property1" : "propertyValue1",
+              "property2" : "propertyValue2"
+            },
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          },
+          "initialStatus": "DRAFT"
+        }
+
+       """
+        url = (f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/"
+               f"{self.url_marker}/governance-definitions")
+
+        response = await self._async_make_request("POST", url, body_slimmer(body))
+
+        return response.json().get("guid", "Governance Definition not created")
+
+    def create_governance_definition(self, body: dict) -> str:
+        """ Create a governance definition. It may be of type:
+            * BusinessImperative
+            * RegulationArticle
+            * Threat
+            * GovernancePrinciple
+            * GovernanceObligation
+            * GovernanceApproach
+            * GovernanceProcessingPurpose
+            The type is added to the "typeName" property.
+
+        Parameters
+        ----------
+ 
+        body: dict
+            A dictionary containing the definition of the governance definition to create.
+
+        Returns
+        -------
+
+        str - guid of the definition created.
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+       Governance definitions can be simple or anchored to a parent element -  Both are shown below. depending on
+        which structure is used for the body.
+
+        Many kinds of governance definition have additional properties added. Details are described in the UML diagrams
+        on the website and summarized in the table below which shows the property class name and which types
+        of governance definitions use it. The test_governance_officer module offers some usage examples.
+
+        Property Class Name     |       Definition Types
+        ===================================================================================
+        GovernanceDefinitionProperties | BusinessImperative, RegulationArticle, Threat, GovernanceProcessingPurpose,
+                                       | GovernancePrinciple, GovernanceObligation, GovernanceApproach
+        GovernanceStrategyProperties   | GovernanceStrategy
+        RegulationProperties           | Regulation
+        GovernanceControlProperties    | GovernanceControl
+        SecurityGroupProperties        | SecurityGroup
+        NamingStandardRuleProperties   | NamingStandardRule
+        CertificationTypeProperties    | CertificationType
+        LicenseTyoeProperties          | LicenseType
+        GovernanceApproachProperties   | GovernanceApproach
+
+        Simple body structure:
+        {
+          "class": "NewElementRequestBody",
+          "properties": {
+            "class" : "GovernanceDefinitionProperties",
+            "typeName" : "enter the type of the governance definition",
+            "domainIdentifier": 0,
+            "documentIdentifier": "add unique name here",
+            "title": "add short name here",
+            "summary": "add summary here",
+            "description": "add description here",
+            "scope": "add scope of effect for this definition",
+            "importance": "add importance for this definition",
+            "implications": [],
+            "outcomes": [],
+            "results": [],
+            "additionalProperties": {
+              "property1" : "propertyValue1",
+              "property2" : "propertyValue2"
+            }
+          },
+          "initialStatus": "DRAFT"
+        }
+
+        Body structure with Parent:
+        {
+          "class" : "NewGovernanceDefinitionRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "anchorGUID" : "add guid here",
+          "isOwnAnchor": false,
+          "parentGUID": "add guid here",
+          "parentRelationshipTypeName": "add type name here",
+          "parentRelationshipProperties": {
+            "class": "ElementProperties",
+            "propertyValueMap" : {
+              "description" : {
+                "class": "PrimitiveTypePropertyValue",
+                "typeName": "string",
+                "primitiveValue" : "New description"
+              }
+            }
+          },
+          "parentAtEnd1": false,
+          "properties": {
+            "class" : "GovernanceDefinitionProperties",
+            "typeName" : "enter the type of the governance definition",
+            "domainIdentifier": 0,
+            "documentIdentifier": "add unique name here",
+            "title": "add short name here",
+            "summary": "add summary here",
+            "description": "add description here",
+            "scope": "add scope of effect for this definition",
+            "importance": "add importance for this definition",
+            "implications": [],
+            "outcomes": [],
+            "results": [],
+            "additionalProperties": {
+              "property1" : "propertyValue1",
+              "property2" : "propertyValue2"
+            },
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          },
+          "initialStatus": "DRAFT"
+        }
+
+
+       """
+
+        loop = asyncio.get_event_loop()
+        response = loop.run_until_complete(self._async_create_governance_definition(body))
+        return response
+
+    async def _async_create_governance_definition_from_template(self, body: dict) -> str:
+        """ Create a new metadata element to represent a governance definition using an existing metadata element
+            as a template. The template defines additional classifications and relationships that should be added to
+            the new element. Async version.
+
+        Parameters
+        ----------
+ 
+        body: dict
+            A dictionary containing the definition of the governance definition to create.
+
+        Returns
+        -------
+
+        str - guid of the governance definition created.
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+        https://egeria-project.org/concepts/governance-definition
+
+        Body structure:
+
+        {
+          "class" : "TemplateRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "anchorGUID" : "add guid here",
+          "isOwnAnchor": false,
+          "parentGUID": "add guid here",
+          "parentRelationshipTypeName": "add type name here",
+          "parentRelationshipProperties": {
+            "class": "ElementProperties",
+            "propertyValueMap" : {
+              "description" : {
+                "class": "PrimitiveTypePropertyValue",
+                "typeName": "string",
+                "primitiveValue" : "New description"
+              }
+            }
+          },
+          "parentAtEnd1": false,
+          "templateGUID": "add guid here",
+          "replacementProperties": {
+            "class": "ElementProperties",
+            "propertyValueMap" : {
+              "description" : {
+                "class": "PrimitiveTypePropertyValue",
+                "typeName": "string",
+                "primitiveValue" : "New description"
+              }
+            }
+          },
+          "placeholderPropertyValues":  {
+            "placeholder1" : "propertyValue1",
+            "placeholder2" : "propertyValue2"
+          }
+        }
+
+       """
+        url = (f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/"
+               f"{self.url_marker}/governance-definitions/from-template")
+
+        response = await self._async_make_request("POST", url, body_slimmer(body))
+
+        return response.json().get("guid", "Governance definition not created")
+
+    def create_governance_definition_from_template(self, body: dict) -> str:
+        """ Create a new metadata element to represent a governance definition using an existing metadata element
+            as a template. The template defines additional classifications and relationships that should be added to
+            the new element.
+
+        Parameters
+        ----------
+ 
+        body: dict
+            A dictionary containing the definition of the governance definition to create.
+
+        Returns
+        -------
+
+        str - guid of the governance definition created.
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+        https://egeria-project.org/concepts/governance-definition
+
+        Body structure:
+ 
+        {
+          "class" : "TemplateRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "anchorGUID" : "add guid here",
+          "isOwnAnchor": false,
+          "parentGUID": "add guid here",
+          "parentRelationshipTypeName": "add type name here",
+          "parentRelationshipProperties": {
+            "class": "ElementProperties",
+            "propertyValueMap" : {
+              "description" : {
+                "class": "PrimitiveTypePropertyValue",
+                "typeName": "string",
+                "primitiveValue" : "New description"
+              }
+            }
+          },
+          "parentAtEnd1": false,
+          "templateGUID": "add guid here",
+          "replacementProperties": {
+            "class": "ElementProperties",
+            "propertyValueMap" : {
+              "description" : {
+                "class": "PrimitiveTypePropertyValue",
+                "typeName": "string",
+                "primitiveValue" : "New description"
+              }
+            }
+          },
+          "placeholderPropertyValues":  {
+            "placeholder1" : "propertyValue1",
+            "placeholder2" : "propertyValue2"
+          }
+        }
+
+       """
+
+        loop = asyncio.get_event_loop()
+        response = loop.run_until_complete(self._async_create_governance_definition_from_template(body))
+        return response
+
+    async def _async_update_governance_definition(self, guid: str, body: dict,
+                                                  replace_all_properties: bool = False) -> None:
+        """ Update the properties of a governance definition. Async Version.
+
+        Parameters
+        ----------
+        guid: str
+            guid of the governance definition to update.
+        body: dict
+            A dictionary containing the updates to the governance definition.
+        replace_all_properties: bool, optional
+            Whether to replace all properties with those provided in the body or to merge with existing properties.
+
+        Returns
+        -------
+
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class" : "UpdateElementRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "properties": {
+            "class" : "GovernanceDefinitionProperties",
+            "typeName" : "Add type name here",
+            "qualifiedName": "add unique name here",
+            "displayName": "add short name here",
+            "description": "add description here",
+            "namespace": "add namespace for this structure",
+            "versionIdentifier": "add version for this structure",
+            "additionalProperties": {
+              "property1" : "propertyValue1",
+              "property2" : "propertyValue2"
+            },
+            "extendedProperties": {
+              "property1" : "propertyValue1",
+              "property2" : "propertyValue2"
+            },
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          }
+        }
+        """
+        validate_guid(guid)
+        replace_all_properties_s = str(replace_all_properties).lower()
+        url = (
+            f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/{self.url_marker}/governance-definitions/"
+            f"{guid}/update?replaceAllProperties={replace_all_properties_s}")
+        if body:
+            await self._async_make_request("POST", url, body_slimmer(body))
+        else:
+            await self._async_make_request("POST", url)
+
+    def update_governance_definition(self, guid: str, body: dict, replace_all_properties: bool = False) -> None:
+        """ Update the properties of a governance definition.
+
+        Parameters
+        ----------
+        guid: str
+            guid of the governance definition to update.
+        body: dict
+            A dictionary containing the updates to the governance definition.
+        replace_all_properties: bool, optional
+            Whether to replace all properties with those provided in the body or to merge with existing properties.
+
+        Returns
+        -------
+
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class" : "UpdateElementRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "properties": {
+            "class" : "GovernanceDefinitionProperties",
+            "typeName" : "Add type name here",
+            "qualifiedName": "add unique name here",
+            "displayName": "add short name here",
+            "description": "add description here",
+            "namespace": "add namespace for this structure",
+            "versionIdentifier": "add version for this structure",
+            "additionalProperties": {
+              "property1" : "propertyValue1",
+              "property2" : "propertyValue2"
+            },
+            "extendedProperties": {
+              "property1" : "propertyValue1",
+              "property2" : "propertyValue2"
+            },
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          }
+        }
+        """
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(self._async_update_governance_definition(guid, body, replace_all_properties))
+
+    async def _async_update_governance_definition_status(self, guid: str, body: dict,
+                                                         replace_all_properties: bool = False) -> None:
+        """ Update the status of a governance definition. Async Version.
+
+        Parameters
+        ----------
+        guid: str
+            guid of the governance definition to update.
+
+        body: dict
+            A dictionary containing the updates to the governance definition.
+        replace_all_properties: bool, optional
+            Whether to replace all properties with those provided in the body or to merge with existing properties.
+
+        Returns
+        -------
+
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class": "UpdateGovernanceDefinitionRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime": "{{$isoTimestamp}}",
+          "forLineage": false,
+          "forDuplicateProcessing": false,
+          "status": "ACTIVE"
+        }
+        """
+        validate_guid(guid)
+        replace_all_properties_s = str(replace_all_properties).lower()
+        url = (
+            f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/{self.url_marker}/governance-defnitions/"
+            f"{guid}/update-status?replaceAllProperties={replace_all_properties_s}")
+
+        await self._async_make_request("POST", url, body_slimmer(body))
+
+    def update_governance_definition_status(self, guid: str, body: dict, replace_all_properties: bool = False) -> None:
+        """ Update the status of a governance definition.
+
+            Parameters
+            ----------
+            guid: str
+                guid of the information governance definition to update.
+            body: dict
+                A dictionary containing the updates to the governance definition.
+            replace_all_properties: bool, optional
+                Whether to replace all properties with those provided in the body or to merge with existing properties.
+
+            Returns
+            -------
+
+            None
+
+            Raises
+            ------
+            InvalidParameterException
+                one of the parameters is null or invalid or
+            PropertyServerException
+                There is a problem adding the element properties to the metadata repository or
+            UserNotAuthorizedException
+                the requesting user is not authorized to issue this request.
+
+            Notes
+            ----
+
+            Body structure:
+            {
+              "class" : "UpdateGovernanceDefinitionRequestBody",
+              "externalSourceGUID": "add guid here",
+              "externalSourceName": "add qualified name here",
+              "effectiveTime" : "{{$isoTimestamp}}",
+              "forLineage" : false,
+              "forDuplicateProcessing" : false,
+              "status": "ACTIVE"
+            }
+            """
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(self._async_update_governance_definition_status(guid, body, replace_all_properties))
+
+    async def _async_link_peer_definitions(self, definition_guid1: str, relationship_type: str, definition_guid2: str,
+                                           body: dict = None) -> None:
+        """ Attach two peer governance definitions. Request body is optional. Async Version.
+
+        Parameters
+        ----------
+        definition_guid1: str
+            guid of the first governance definition to link.
+        definition_guid2: str
+            guid of the second governance definition to link.
+        relationship_type: str
+            Relationship type name linking the governance definitions..
+        body: dict
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+        The relationshipTypeNme can be:
+        * GovernanceDriverLink between governance drivers (GovernanceStrategy, BusinessImperitive, Regulation, RegulationArticle, Threat).
+        * GovernancePolicyLink between governance policies (GovernancePrinciple, GovernanceObligation, GovernanceApproach).
+        * GovernanceControlLink between governance controls (GovernanceRule, GovernanceProcess, GovernanceResponsibility, GovernanceProcedure, SecurityAccessControl, SecurityGroup).
+
+        Body structure:
+        {
+          "class" : "RelationshipRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "properties": {
+            "class": "PeerDefinitionProperties",
+            "description": "",
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          }
+        }
+        """
+        validate_guid(definition_guid1)
+        validate_guid(definition_guid2)
+
+        url = (
+            f"{self.platform_url}/s"
+            f"ervers/{self.view_server}/api/open-metadata/governance-officer/governance-definitions/"
+            f"{definition_guid1}/peer-definitions/{relationship_type}/{definition_guid2}/attach")
+
+        await self._async_make_request("POST", url, body_slimmer(body))
+
+    def link_peer_definitions(self, definition_guid1: str, relationship_type: str, definition_guid2: str,
+                              body: dict = None) -> None:
+        """ Attach two peer governance definitions. Async Version.
+
+        Parameters
+        ----------
+        definition_guid1: str
+            guid of the first governance definition to link.
+        definition_guid2: str
+            guid of the second governance definition to link.
+        relationship_type: str
+            Relationship type name linking the governance definitions..
+        body: dict
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+        The relationshipTypeNme can be:
+        * GovernanceDriverLink between governance drivers (GovernanceStrategy, BusinessImperitive, Regulation, RegulationArticle, Threat).
+        * GovernancePolicyLink between governance policies (GovernancePrinciple, GovernanceObligation, GovernanceApproach).
+        * GovernanceControlLink between governance controls (GovernanceRule, GovernanceProcess, GovernanceResponsibility, GovernanceProcedure, SecurityAccessControl, SecurityGroup).
+
+        Body structure:
+        {
+          "class" : "RelationshipRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "properties": {
+            "class": "PeerDefinitionProperties",
+            "description": "",
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          }
+        }
+        """
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(
+            self._async_link_peer_definitions(definition_guid1, relationship_type, definition_guid2, body))
+
+    async def _async_detach_peer_definitions(self, definition_guid1: str, relationship_type: str, definition_guid2: str,
+                                             body: dict = None) -> None:
+        """ Detach two peer governance definitions. Request body is optional. Async Version.
+
+        Parameters
+        ----------
+        definition_guid1: str
+            guid of the first governance definition to link.
+        definition_guid2: str
+            guid of the second governance definition to link.
+        relationship_type: str
+            Relationship type name linking the governance definitions..
+        body: dict, optional
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+
+        {
+          "class": "MetadataSourceRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime": "{{$isoTimestamp}}",
+          "forLineage": false,
+          "forDuplicateProcessing": false
+        }
+        """
+        validate_guid(definition_guid1)
+        validate_guid(definition_guid2)
+
+        url = (
+            f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/"
+            f"{self.url_marker}/governance-definitions/"
+            f"{definition_guid1}/peer-definitions/{relationship_type}/{definition_guid2}/detach")
+
+        await self._async_make_request("POST", url, body_slimmer(body))
+
+    def detach_peer_definitions(self, definition_guid1: str, relationship_type: str, definition_guid2: str,
+                                body: dict = None) -> None:
+        """ Detach two peer governance definitions. Request body is optional.
+
+        Parameters
+        ----------
+        definition_guid1: str
+            guid of the first governance definition to link.
+        definition_guid2: str
+            guid of the second governance definition to link.
+        relationship_type: str
+            Relationship type name linking the governance definitions..
+        body: dict, optional
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+
+        {
+          "class": "MetadataSourceRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime": "{{$isoTimestamp}}",
+          "forLineage": false,
+          "forDuplicateProcessing": false
+        }
+        """
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(
+            self._async_detach_peer_definitions(definition_guid1, relationship_type, definition_guid2, body))
+
+    async def _async_attach_supporting_definitions(self, definition_guid1: str, relationship_type: str,
+                                                   definition_guid2: str, body: dict = None) -> None:
+        """ Attach a supporting governance definition. Request body is optional.
+            The relationshipTypeNme can be:
+            * GovernanceResponse between governance drivers (GovernanceStrategy, BusinessImperative, Regulation,
+            RegulationArticle, Threat) and governance policies (GovernancePrinciple, GovernanceObligation,
+            GovernanceApproach).
+            * GovernanceImplementation between governance policies (GovernancePrinciple, GovernanceObligation,
+            GovernanceApproach) and governance controls (GovernanceRule, GovernanceProcess, GovernanceResponsibility,
+            GovernanceProcedure, SecurityAccessControl, SecurityGroup).
+
+        Async Version.
+
+        Parameters
+        ----------
+        definition_guid1: str
+            guid of the first governance definition to link.
+        definition_guid2: str
+            guid of the second governance definition to link.
+        relationship_type: str
+            Relationship type name linking the governance definitions..
+        body: dict
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+         {
+          "class" : "RelationshipRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "properties": {
+            "class": "SupportingDefinitionProperties",
+            "rationale": "",
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          }
+        }
+        """
+        validate_guid(definition_guid1)
+        validate_guid(definition_guid2)
+
+        url = (
+            f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/"
+            f"{self.url_marker}/governance-definitions/"
+            f"{definition_guid1}/supporting-definitions/{relationship_type}/{definition_guid2}/attach")
+
+        await self._async_make_request("POST", url, body_slimmer(body))
+
+    def attach_supporting_definitions(self, definition_guid1: str, relationship_type: str, definition_guid2: str,
+                                      body: dict = None) -> None:
+        """ Attach a supporting governance definition. Request body is optional.
+            The relationshipTypeNme can be:
+            * GovernanceResponse between governance drivers (GovernanceStrategy, BusinessImperative, Regulation,
+            RegulationArticle, Threat) and governance policies (GovernancePrinciple, GovernanceObligation,
+            GovernanceApproach).
+            * GovernanceImplementation between governance policies (GovernancePrinciple, GovernanceObligation,
+            GovernanceApproach) and governance controls (GovernanceRule, GovernanceProcess, GovernanceResponsibility,
+            GovernanceProcedure, SecurityAccessControl, SecurityGroup).
+
+        Parameters
+        ----------
+        definition_guid1: str
+            guid of the first governance definition to link.
+        definition_guid2: str
+            guid of the second governance definition to link.
+        relationship_type: str
+            Relationship type name linking the governance definitions..
+        body: dict
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class" : "RelationshipRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "properties": {
+            "class": "SupportingDefinitionProperties",
+            "rationale": "",
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          }
+        }
+        """
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(
+            self._async_attach_supporting_definitions(definition_guid1, relationship_type, definition_guid2, body))
+
+    async def _async_detach_supporting_definitions(self, definition_guid1: str, relationship_type: str,
+                                                   definition_guid2: str, body: dict = None) -> None:
+        """ Detach a governance definition from a supporting governance definition.
+            Request body is optional. Async Version.
+
+        Parameters
+        ----------
+        definition_guid1: str
+            guid of the first governance definition to unlink.
+        definition_guid2: str
+            guid of the second governance definition to unlink.
+        relationship_type: str
+            Relationship type name linking the governance definitions..
+        body: dict, optional
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class": "MetadataSourceRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime": "{{$isoTimestamp}}",
+          "forLineage": false,
+          "forDuplicateProcessing": false
+        }
+        """
+        validate_guid(definition_guid1)
+        validate_guid(definition_guid2)
+
+        url = (
+            f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/"
+            f"{self.url_marker}/governance-definitions/"
+            f"{definition_guid1}/supporting-definitions/{relationship_type}/{definition_guid2}/detach")
+
+        await self._async_make_request("POST", url, body_slimmer(body))
+
+    def detach_supporting_definitions(self, definition_guid1: str, relationship_type: str, definition_guid2: str,
+                                      body: dict = None) -> None:
+        """ Detach a governance definition from a supporting governance definition.
+            Request body is optional.
+
+        Parameters
+        ----------
+        definition_guid1: str
+            guid of the first governance definition to unlink.
+        definition_guid2: str
+            guid of the second governance definition to unlink.
+        relationship_type: str
+            Relationship type name linking the governance definitions..
+        body: dict, optional
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class" : "MetadataSourceRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false
+        }
+        """
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(
+            self._async_detach_supporting_definitions(definition_guid1, relationship_type, definition_guid2, body))
+
+    async def _async_delete_governance_definition(self, guid: str, body: dict = None) -> str:
+        """ Delete an information supply. Async version.
+
+        Parameters
+        ----------
+        guid: str
+            GUID of the governance definition to delete.
+ 
+        body: dict, optional
+            A dictionary containing the definition of the governance definition to create.
+
+        Returns
+        -------
+
+        str - guid of the governance definition created.
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+        https://egeria-project.org/concepts/governance-definition
+
+        Body structure:
+        {
+          "class": "MetadataSourceRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime": "{{$isoTimestamp}}",
+          "forLineage": false,
+          "forDuplicateProcessing": false
+        }
+
+       """
+        url = (f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/"
+               f"{self.url_marker}/governance-definitions/{guid}/delete")
+
+        await self._async_make_request("POST", url, body_slimmer(body))
+
+    def delete_governance_definition(self, guid: str, body: dict = None) -> str:
+        """ Delete an information supply. Request body is optional. Async version.
+
+        Parameters
+        ----------
+        guid: str
+            GUID of the governance definition to delete.
+ 
+        body: dict, optionl
+            A dictionary containing the definition of the governance definition to create.
+
+        Returns
+        -------
+
+        str - guid of the governance definition created.
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+        https://egeria-project.org/concepts/governance-definition
+
+        Body structure:
+        {
+          "class": "MetadataSourceRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime": "{{$isoTimestamp}}",
+          "forLineage": false,
+          "forDuplicateProcessing": false
+        }
+
+       """
+
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(self._async_delete_governance_definition(guid, body))
+
+    async def _async_find_governance_definitions(self, search_filter: str = "*", starts_with: bool = True,
+                                                 ends_with: bool = False, ignore_case: bool = False,
+                                                 start_from: int = 0, page_size: int = 0, body: dict = None,
+                                                 output_format: str = 'JSON') -> list[dict] | str:
+        """ Retrieve the list of governance definition metadata elements that contain the search string.
+            Async version.
+
+            Parameters
+            ----------
+            search_filter : str
+                - search_filter string to search for.
+            starts_with : bool, [default=False], optional
+                Starts with the supplied string.
+            ends_with : bool, [default=False], optional
+                Ends with the supplied string
+            ignore_case : bool, [default=False], optional
+                Ignore case when searching
+            body: dict, optional, default = None
+                - additional optional specifications for the search.
+            output_format: str, default = 'JSON'
+                Type of output to produce:
+                    JSON - output standard json
+                    MD - output standard markdown with no preamble
+                    FORM - output markdown with a preamble for a form
+                    REPORT - output markdown with a preamble for a report
+                    Mermaid - output markdown with a mermaid graph
+
+            Returns
+            -------
+            list[dict] | str
+                A list of information governance definition structures or a string if there are no elements found.
+
+            Raises
+            ------
+            InvalidParameterException
+                one of the parameters is null or invalid or
+            PropertyServerException
+                There is a problem adding the element properties to the metadata repository or
+            UserNotAuthorizedException
+                the requesting user is not authorized to issue this request.
+
+            Notes
+            -----
+            If a body is provided it overrides the search_filter parameter.
+            
+            Body structure:
+            {
+              "class": "FilterRequestBody",
+              "asOfTime": {{isotime}},
+              "effectiveTime": {{isotime}},
+              "forLineage": false,
+              "forDuplicateProcessing": false,
+              "limitResultsByStatus": ["ACTIVE"],
+              "sequencingOrder": "PROPERTY_ASCENDING",
+              "sequencingProperty": "qualifiedName",
+              "filter": "Add name here",
+              "templateFilter": "NO_TEMPLATES"
+            }
+            """
+
+        possible_query_params = query_string(
+            [("startFrom", start_from), ("pageSize", page_size), ("startsWith", str(starts_with).lower()),
+             ("endsWith", str(ends_with).lower()), ("ignoreCase", str(ignore_case).lower()), ])
+
+        if search_filter == "*":
+            search_filter = None
+
+        if body is None:
+            body = {
+                "filter": search_filter,
+                }
+
+        url = (
+            f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/"
+            f"{self.url_marker}/governance-definitions/"
+            f"by-search-string{possible_query_params}")
+
+        response: Response = await self._async_make_request("POST", url, body_slimmer(body))
+        element = response.json().get("elements", NO_ELEMENTS_FOUND)
+        if element == NO_ELEMENTS_FOUND:
+            return NO_ELEMENTS_FOUND
+        if output_format != 'JSON':  # return a simplified markdown representation
+            return self.generate_governance_definition_output(element, search_filter, output_format)
+        return response.json().get("elements", NO_ELEMENTS_FOUND)
+
+    def find_governance_definitions(self, search_filter: str = "*", starts_with: bool = True, ends_with: bool = False,
+                                    ignore_case: bool = False, start_from: int = 0, page_size: int = 0,
+                                    body: dict = None, output_format: str = 'JSON') -> list[dict] | str:
+        """ Retrieve the list of governance definition metadata elements that contain the search string.
+
+            Parameters
+            ----------
+            search_filter : str
+                - search_filter string to search for.
+            starts_with : bool, [default=False], optional
+                Starts with the supplied string.
+            ends_with : bool, [default=False], optional
+                Ends with the supplied string
+            ignore_case : bool, [default=False], optional
+                Ignore case when searching
+            body: dict, optional, default = None
+                - additional optional specifications for the search.
+            output_format: str, default = 'JSON'
+                Type of output to produce:
+                    JSON - output standard json
+                    MD - output standard markdown with no preamble
+                    FORM - output markdown with a preamble for a form
+                    REPORT - output markdown with a preamble for a report
+                    Mermaid - output markdown with a mermaid graph
+
+            Returns
+            -------
+            list[dict] | str
+                A list of information governance definition structures or a string if there are no elements found.
+
+            Raises
+            ------
+            InvalidParameterException
+                one of the parameters is null or invalid or
+            PropertyServerException
+                There is a problem adding the element properties to the metadata repository or
+            UserNotAuthorizedException
+                the requesting user is not authorized to issue this request.
+
+            Notes
+            -----
+            If a body is provided it overrides the search_filter parameter.
+
+            Body structure:
+            {
+              "class": "FilterRequestBody",
+              "asOfTime": {{isotime}},
+              "effectiveTime": {{isotime}},
+              "forLineage": false,
+              "forDuplicateProcessing": false,
+              "limitResultsByStatus": ["ACTIVE"],
+              "sequencingOrder": "PROPERTY_ASCENDING",
+              "sequencingProperty": "qualifiedName",
+              "filter": "Add name here",
+              "templateFilter": "NO_TEMPLATES"
+            }
+            """
+
+        loop = asyncio.get_event_loop()
+        response = loop.run_until_complete(
+            self._async_find_governance_definitions(search_filter, starts_with, ends_with, ignore_case, start_from,
+                                                    page_size, body, output_format))
+        return response
+
+    async def _async_get_governance_definitions_by_name(self, search_filter: str, body: dict = None,
+                                                        start_from: int = 0, page_size: int = 0,
+                                                        output_format: str = "JSON") -> dict | str:
+        """ Returns the list of governance definitions with a particular name. Async Version.
+
+            Parameters
+            ----------
+            search_filter: str
+                name of the information governance definition to retrieve.
+            body: dict, optional
+                A dictionary containing parameters of the retrieval.
+            output_format: str, default = 'JSON'
+                Type of output to produce include:
+                JSON - output standard json
+                MD - output standard markdown with no preamble
+                FORM - output markdown with a preamble for a form
+                REPORT - output markdown with a preamble for a report
+                MERMAID - output mermaid markdown
+
+            Returns
+            -------
+            [dict] | str
+                A list of information governance definitions matching the name.
+
+            Raises
+            ------
+            InvalidParameterException
+                one of the parameters is null or invalid or
+            PropertyServerException
+                There is a problem adding the element properties to the metadata repository or
+            UserNotAuthorizedException
+                the requesting user is not authorized to issue this request.
+
+            Notes
+            -----
+            If a body is provided it overrides the search_filter parameter.
+            Body structure:
+            {
+              "class": "FilterRequestBody",
+              "asOfTime": {{isotime}},
+              "effectiveTime": {{isotime}},
+              "forLineage": false,
+              "forDuplicateProcessing": false,
+              "limitResultsByStatus": ["ACTIVE"],
+              "sequencingOrder": "PROPERTY_ASCENDING",
+              "sequencingProperty": "qualifiedName",
+              "filter": "Add name here",
+              "templateFilter": "NO_TEMPLATES"
+            }
+
+        """
+        possible_query_params = query_string([("startFrom", start_from), ("pageSize", page_size)])
+
+        if body is None:
+            body = {
+                "filter": search_filter,
+                }
+
+        url = (
+            f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/"
+            f"{self.url_marker}/governance-definitions/"
+            f"by-name{possible_query_params}")
+
+        response: Response = await self._async_make_request("POST", url, body_slimmer(body))
+        element = response.json().get("elements", NO_ELEMENTS_FOUND)
+        if element == NO_ELEMENTS_FOUND:
+            return NO_ELEMENTS_FOUND
+        if output_format != 'JSON':  # return a simplified markdown representation
+            return self.generate_governance_definition_output(element, None, output_format)
+        return response.json().get("elements", NO_ELEMENTS_FOUND)
+
+    def get_governance_definitions_by_name(self, search_filter: str, body: dict = None, start_from: int = 0,
+                                           page_size: int = 0, output_format: str = "JSON") -> dict | str:
+        """ Returns the list of information governance definitions with a particular name. Async Version.
+
+            Parameters
+            ----------
+            search_filter: str
+                name of the information governance definition to retrieve.
+            body: dict, optional
+                A dictionary containing parameters of the retrieval.
+            add_implementation: bool, optional
+                Whether to add the implementation details to the response.
+            start_from: int, [default=0], optional
+                When multiple pages of results are available, the page number to start from.
+            page_size: int, [default=0], optional
+                The number of items to return in a single page. If not specified, the default will be taken from
+                the class instance.
+            output_format: str, default = 'JSON'
+                Type of output to produce:
+                JSON - output standard json
+                MD - output standard markdown with no preamble
+                FORM - output markdown with a preamble for a form
+                REPORT - output markdown with a preamble for a report
+                MERMAID - output mermaid markdown
+
+            Returns
+            -------
+            [dict] | str
+                A list of information governance definitions matching the name.
+
+            Raises
+            ------
+            InvalidParameterException
+                one of the parameters is null or invalid or
+            PropertyServerException
+                There is a problem adding the element properties to the metadata repository or
+            UserNotAuthorizedException
+                the requesting user is not authorized to issue this request.
+
+            Notes
+            -----
+            Body structure:
+            {
+              "class": "FilterRequestBody",
+              "asOfTime": {{isotime}},
+              "effectiveTime": {{isotime}},
+              "forLineage": false,
+              "forDuplicateProcessing": false,
+              "limitResultsByStatus": ["ACTIVE"],
+              "sequencingOrder": "PROPERTY_ASCENDING",
+              "sequencingProperty": "qualifiedName",
+              "filter": "Add name here",
+              "templateFilter": "NO_TEMPLATES"
+            }
+
+        """
+        loop = asyncio.get_event_loop()
+        response = loop.run_until_complete(
+            self._async_get_governance_definitions_by_name(search_filter, body, start_from, page_size, output_format))
+        return response
+
+    async def _async_get_governance_definition_by_guid(self, guid: str, body: dict = None, output_format: str = "JSON") -> dict | str:
+
+        """ Get governance definition by guid.
+            Async version.
+
+        Parameters
+        ----------
+        guid: str
+            GUID of the governance definition to get.
+ 
+        body: dict, optional
+            A dictionary containing the definition of the governance definition to create.
+        output_format: str
+            The output format to use.
+
+        Returns
+        -------
+
+        dict | str
+                A list of information governance definition structures or a string if there are no elements found.
+
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+        https://egeria-project.org/concepts/governance-definition
+
+        Body structure:
+        {
+          "class": "AnyTimeRequestBody",
+          "asOfTime": "{{$isoTimestamp}}",
+          "effectiveTime": "{{$isoTimestamp}}",
+          "forLineage": false,
+          "forDuplicateProcessing": false
+        }
+
+       """
+
+        url = (
+            f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/"
+            f"{self.url_marker}/governance-definitions/"
+            f"{guid}/retrieve")
+
+        if body:
+            response = await self._async_make_request("POST", url, body_slimmer(body))
+        else:
+            response = await self._async_make_request("POST", url)
+
+        element = response.json().get("element", NO_ELEMENTS_FOUND)
+        if element == NO_ELEMENTS_FOUND:
+            return NO_ELEMENTS_FOUND
+        if output_format != 'JSON':  # return a simplified markdown representation
+            return self.generate_governance_definition_output(element, guid, output_format)
+        return response.json().get("element", NO_ELEMENTS_FOUND)
+
+    def get_governance_definition_by_guid(self, guid: str, body: dict = None, output_format: str = "JSON") -> dict | str:
+
+        """ Get governance definition by guid.
+
+        Parameters
+        ----------
+        guid: str
+            GUID of the governance definition to get.
+ 
+        body: dict, optional
+            A dictionary containing the definition of the governance definition to create.
+        output_format: str, default = "JSON"
+            The output format to use.
+
+        Returns
+        -------
+
+        dict | str
+                A list of information governance definition structures or a string if there are no elements found.
+
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+        https://egeria-project.org/concepts/governance-definition
+        Body structure:
+        {
+          "class": "AnyTimeRequestBody",
+          "asOfTime": "{{$isoTimestamp}}",
+          "effectiveTime": "{{$isoTimestamp}}",
+          "forLineage": false,
+          "forDuplicateProcessing": false
+        }
+
+       """
+
+        loop = asyncio.get_event_loop()
+        response = loop.run_until_complete(self._async_get_governance_definition_by_guid(guid, body, output_format))
+        return response
+
+    async def _async_link_design_to_implementation(self, design_desc_guid: str, implementation_guid: str,
+                                                   body: dict = None) -> None:
+        """ Attach a design object such as a solution component or governance definition to its implementation via the
+            ImplementedBy relationship. Request body is optional. Async Version.
+            https://egeria-project.org/types/7/0737-Solution-Implementation/
+
+        Parameters
+        ----------
+        design_desc_guid: str
+            guid of the design element to link.
+        implementation_guid: str
+            guid of the implementation definition to link.
+        body: dict, optional
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class" : "RelationshipRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "properties": {
+            "class": "ImplementedByProperties",
+            "designStep": "",
+            "role": "",
+            "transformation": "",
+            "description": "",
+            "iscQualifiedName": "",
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          }
+        }
+        """
+        validate_guid(design_desc_guid)
+        validate_guid(implementation_guid)
+
+        url = (f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/{self.url_marker}/designs/"
+               f"{design_desc_guid}/implementations/{implementation_guid}/attach")
+
+        if body:
+            await self._async_make_request("POST", url, body_slimmer(body))
+        else:
+            await self._async_make_request("POST", url)
+
+    def link_design_to_implementation(self, design_desc_guid: str, implementation_guid: str, body: dict = None) -> None:
+        """ Attach a design object such as a solution component or governance definition to its implementation via the
+            ImplementedBy relationship. Request body is optional.
+            https://egeria-project.org/types/7/0737-Solution-Implementation/
+
+        Parameters
+        ----------
+        design_desc_guid: str
+            guid of the design element to link.
+        implementation_guid: str
+            guid of the implementation definition to link.
+        body: dict, optional
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class" : "RelationshipRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "properties": {
+            "class": "ImplementedByProperties",
+            "designStep": "",
+            "role": "",
+            "transformation": "",
+            "description": "",
+            "iscQualifiedName": "",
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          }
+        }
+        """
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(self._async_link_design_to_implementation(design_desc_guid, implementation_guid, body))
+
+    async def _async_detach_design_from_implementation(self, design_desc_guid: str, implementation_guid: str,
+                                                       body: dict = None) -> None:
+        """ Detach a governance definition from its implementation. Async Version.
+
+        Parameters
+        ----------
+        design_desc_guid: str
+            guid of the technical control to link.
+        implementation_guid: str
+            guid of the implementation definition to unlink.
+        body: dict
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class": "MetadataSourceRequestBody",
+          "externalSourceGUID": "string",
+          "externalSourceName": "string",
+          "forLineage": true,
+          "forDuplicateProcessing": true,
+          "effectiveTime": "2025-06-13T15:13:31.339Z"
+        }
+        """
+        validate_guid(design_desc_guid)
+        validate_guid(implementation_guid)
+
+        url = (f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/{self.url_marker}/designs/"
+               f"{design_desc_guid}/implementations/{implementation_guid}/detach")
+
+        await self._async_make_request("POST", url, body_slimmer(body))
+
+    def detach_design_from_implementation(self, technical_control_guid: str, implementation_guid: str,
+                                          body: dict = None) -> None:
+        """ Detach a governance definition from its implementation. Request body is optional.
+
+        Parameters
+        ----------
+        technical_control_guid: str
+            guid of the technical control to unlink.
+        relationship_type: str
+            Relationship type name linking the governance definitions..
+        implementation_guid: str
+            guid of the implementation definition to unlink.
+        body: dict, optional
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "externalSourceGUID": "string",
+          "externalSourceName": "string",
+          "forLineage": true,
+          "forDuplicateProcessing": true,
+          "effectiveTime": "2025-06-13T15:13:31.339Z"
+        }
+        """
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(
+            self._async_detach_design_from_implementation(technical_control_guid, implementation_guid, body))
+
+    async def _async_link_implementation_resource(self, design_desc_guid: str, implementation_guid: str,
+                                                  body: dict = None) -> None:
+        """ Attach a design object such as a solution component or governance definition to one of its implementation
+            resource via the ImplementationResource relationship. Request body is optional.
+            https://egeria-project.org/types/7/0737-Solution-Implementation/
+
+        Parameters
+        ----------
+        design_desc_guid: str
+            guid of the design element to link.
+        implementation_guid: str
+            guid of the implementation definition to link.
+        body: dict, optional
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class" : "RelationshipRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "properties": {
+            "class": "ImplementedByProperties",
+            "designStep": "",
+            "role": "",
+            "transformation": "",
+            "description": "",
+            "iscQualifiedName": "",
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          }
+        }
+        """
+        validate_guid(design_desc_guid)
+        validate_guid(implementation_guid)
+
+        url = (f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/{self.url_marker}/designs/"
+               f"{design_desc_guid}/implementation-resources/{implementation_guid}/attach")
+
+        await self._async_make_request("POST", url, body_slimmer(body))
+
+    def link_implementation_resource(self, design_desc_guid: str, implementation_guid: str, body: dict = None) -> None:
+        """ Attach a design object such as a solution component or governance definition to its implementation via the
+            ImplementedBy relationship. Request body is optional.
+            https://egeria-project.org/types/7/0737-Solution-Implementation/
+
+        Parameters
+        ----------
+        design_desc_guid: str
+            guid of the design element to link.
+        implementation_guid: str
+            guid of the implementation definition to link.
+        body: dict, optional
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class" : "RelationshipRequestBody",
+          "externalSourceGUID": "add guid here",
+          "externalSourceName": "add qualified name here",
+          "effectiveTime" : "{{$isoTimestamp}}",
+          "forLineage" : false,
+          "forDuplicateProcessing" : false,
+          "properties": {
+            "class": "ImplementedByProperties",
+            "designStep": "",
+            "role": "",
+            "transformation": "",
+            "description": "",
+            "iscQualifiedName": "",
+            "effectiveFrom": "{{$isoTimestamp}}",
+            "effectiveTo": "{{$isoTimestamp}}"
+          }
+        }
+        """
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(self._async_link_implementation_resource(design_desc_guid, implementation_guid, body))
+
+    async def _async_detach_implementation_resource(self, design_desc_guid: str, implementation_guid: str,
+                                                    body: dict = None) -> None:
+        """ Detach a design object such as a solution component or governance definition from one of its implementation
+            resources. Request body is optional. Async version.
+
+        Parameters
+        ----------
+        design_desc_guid: str
+            guid of the technical control to link.
+        implementation_guid: str
+            guid of the implementation definition to unlink.
+        body: dict
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class": "MetadataSourceRequestBody",
+          "externalSourceGUID": "string",
+          "externalSourceName": "string",
+          "forLineage": true,
+          "forDuplicateProcessing": true,
+          "effectiveTime": "2025-06-13T15:13:31.339Z"
+        }
+        """
+        validate_guid(design_desc_guid)
+        validate_guid(implementation_guid)
+
+        url = (f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/{self.url_marker}/designs/"
+               f"{design_desc_guid}/implementation-resources/{implementation_guid}/detach")
+
+        await self._async_make_request("POST", url, body_slimmer(body))
+
+    def detach_implementation_resource(self, design_desc_guid: str, implementation_guid: str, body: dict = None) -> None:
+        """ Detach a design object such as a solution component or governance definition from one of its implementation
+            resources. Request body is optional.
+
+        Parameters
+        ----------
+        design_desc_guid: str
+            guid of the technical control to link.
+        implementation_guid: str
+            guid of the implementation definition to unlink.
+        body: dict, optional
+            The body describing the link between the two segments.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+
+        Notes
+        ----
+
+        Body structure:
+        {
+          "class": "MetadataSourceRequestBody",
+          "externalSourceGUID": "string",
+          "externalSourceName": "string",
+          "forLineage": true,
+          "forDuplicateProcessing": true,
+          "effectiveTime": "2025-06-13T15:13:31.339Z"
+        }
+        """
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(self._async_detach_implementation_resource(design_desc_guid, implementation_guid, body))
+
+    async def _async_get_gov_def_in_context(self, guid: str, body: dict = None, output_format: str = "JSON", start_from: int = 0,
+                                            page_size: int = 0) -> list[dict] | str:
+        """ Get governance definition in context. Brings back the graph.
+            Async version.
+
+            Parameters
+            ----------
+            guid: str
+                GUID of the governance definition to get.
+
+            body: dict
+                A dictionary containing the definition of the governance definition to get.
+            output_format: str
+                The output format to use.
+            start_from: int, default= 0
+                Indicates the start of the page range.
+            page_size: int, default = 0
+                The page size to use.
+
+            Returns
+            -------
+
+            list[dict] | str
+                    A list of information governance definition structures or a string if there are no elements found.
+
+
+            Raises
+            ------
+            InvalidParameterException
+                one of the parameters is null or invalid or
+            PropertyServerException
+                There is a problem adding the element properties to the metadata repository or
+            UserNotAuthorizedException
+                the requesting user is not authorized to issue this request.
+
+            Notes
+            ----
+            https://egeria-project.org/concepts/governance-definition
+
+            Body structure:
+            {
+              "forLineage": true,
+              "forDuplicateProcessing": true,
+              "effectiveTime": "2025-06-13T14:12:44.896Z",
+              "limitResultsByStatus": [
+                "InstanceStatus{ordinal=0, name='<Unknown>', description='Unknown instance status.'}"
+              ],
+              "asOfTime": "2025-06-13T14:12:44.896Z",
+              "sequencingOrder": "SequencingOrder{Any Order}",
+              "sequencingProperty": "string"
+            }
+
+           """
+        possible_query_params = query_string([("startFrom", start_from), ("pageSize", page_size)])
+
+        url = (
+            f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/"
+            f"{self.url_marker}/governance-definitions/"
+            f"{guid}/in-context{possible_query_params}")
+
+        if body:
+            response = await self._async_make_request("POST", url, body_slimmer(body))
+        else:
+            response = await self._async_make_request("POST", url)
+
+        element = response.json().get("element", NO_ELEMENTS_FOUND)
+        if output_format != 'JSON':  # return a simplified markdown representation
+            return self.generate_governance_definition_output(element, "", output_format)
+        return response.json().get("element", NO_ELEMENTS_FOUND)
+
+    def get_gov_def_in_context(self, guid: str, body: dict = None, output_format: str = "JSON", start_from: int = 0,
+                               page_size: int = 0) -> list[dict] | str:
+        """ Get governance definition in context. Brings back the graph.
+
+            Parameters
+            ----------
+            guid: str
+                GUID of the governance definition to get.
+
+            body: dict
+                A dictionary containing the definition of the governance definition to get.
+            output_format: str
+                The output format to use.
+            start_from: int, default= 0
+                Indicates the start of the page range.
+            page_size: int, default = 0
+                The page size to use.
+
+            Returns
+            -------
+
+            list[dict] | str
+                    A list of information governance definition structures or a string if there are no elements found.
+
+
+            Raises
+            ------
+            InvalidParameterException
+                one of the parameters is null or invalid or
+            PropertyServerException
+                There is a problem adding the element properties to the metadata repository or
+            UserNotAuthorizedException
+                the requesting user is not authorized to issue this request.
+
+            Notes
+            ----
+            https://egeria-project.org/concepts/governance-definition
+
+            Body structure:
+            {
+              "forLineage": true,
+              "forDuplicateProcessing": true,
+              "effectiveTime": "2025-06-13T14:12:44.896Z",
+              "limitResultsByStatus": [
+                "InstanceStatus{ordinal=0, name='<Unknown>', description='Unknown instance status.'}"
+              ],
+              "asOfTime": "2025-06-13T14:12:44.896Z",
+              "sequencingOrder": "SequencingOrder{Any Order}",
+              "sequencingProperty": "string"
+            }
+
+           """
+
+        loop = asyncio.get_event_loop()
+        response = loop.run_until_complete(
+            self._async_get_gov_def_in_context(guid, body, output_format, start_from, page_size))
+        return response
+
+
+if __name__ == "__main__":
+    print("Main-Metadata Explorer")