#Connect to AvePoint Cloud Governance in Power Automate

The AvePoint Cloud Governance connector in Power Automate offers automation and integration of Cloud Governance functions through Power Automate. You can use the Cloud Governance connector in Power Automate to automate your working processes. The Cloud Governance connector is available in the commercial and GCC versions of Power Automate.

#Prepare for Authentication

To connect to Cloud Governance in Power Automate, authentication with Cloud Governance API is required. Complete the following steps to obtain a client secret to authenticate with the Cloud Governance API:

1. Navigate to AvePoint Cloud Governance System settings > API authentication profiles and click Create on the ribbon.

2. Enter a name for the profile.

3. Configure a duration for the client secret. The start time is the profile created time. Enter a number in the text box and select Days, Weeks, Months, or Years as the unit.

4. Choose whether to Define what services can be called using this Cloud Governance API access token. With this option enabled, click Add, select the services that can be called using this Cloud Governance API access token from the Services panel, and then click Add to define the services.

   You can also delete a service already added to the list by clicking the delete () button.

5. Click Save to save your configurations.

6. After you click Save, the Note window appears for you to view the API authentication details. Click the copy () button to copy the client secret to your clipboard. The client secret will be used when you connect to Cloud Governance in Power Automate.

   NOTE

   The client secret will only be displayed one time, and you cannot retrieve it after you close the window.

   

#Create a Flow from a Cloud Governance Template

AvePoint Cloud Governance provides several templates in Power Automate and each template contains specific triggers or actions. Apart from Cloud Governance triggers or actions, the templates also contain the triggers or actions of other connectors, such as SharePoint and Microsoft Teams.

To create a flow from a Cloud Governance template, complete the following steps:

1. Navigate to the Power Automate Home page or click Templates on the left navigation pane.

2. Enter AvePoint Cloud Governance in the search box and press Enter on the keyboard. You can see all Cloud Governance templates.

3. Read the template titles and choose a template that meets your business process. Click the template to create a flow from this template.

4. View the template details. If you are using the Cloud Governance connector in Power Automate for the first time, you need to set up a connection. Configure the following settings to set up the connection:

   • Connection name – Enter a name for the connection.

   • Username – Enter your username, for example: someone@contoso.com. Note that you must be a Cloud Governance administrator.

   • Password – Enter the client secret that you got after configuring the API authentication profile.

5. Click Continue.

6. Configure the required fields in each step. You can also add additional triggers and actions as you require and configure the corresponding fields.

7. After you configure the whole flow, click Save to save all your configurations.

#Add Cloud Governance Triggers or Actions in a Flow

To add Cloud Governance triggers or actions to your business flow in Power Automate, go to Power Automate, and then complete the following steps:

1. Select one of the following options:

   • Click Connectors on the left navigation pane. Then, enter AvePoint Cloud Governance in the search box and press Enter on the keyboard. Click the Cloud Governance connector in the search result, and then a list of Cloud Governance triggers is displayed. Click a trigger to start a flow.

   • When you configure a step in a flow, enter AvePoint Cloud Governance in the search box and press Enter on the keyboard. A list of Cloud Governance triggers appears on the Triggers tab and a list of Cloud Governance actions appears on the Actions tab. Click a trigger or action to add it to the flow.

2. If you are using the Cloud Governance connector in Power Automate for the first time, you need to set up a connection with Cloud Governance before configuring the Cloud Governance triggers or actions. You can select the Microsoft Entra ID or Client Secret as the Authentication Type to be used for authentication. The user account used for authentication must be a Cloud Governance application administrator.

   • After you select Microsoft Entra ID, click Sign in to consent to the Cloud Governance Connector app. As an IT administrator, when you consent to the app, we recommend that you select the Consent on behalf of your organization option and consent with the Microsoft 365 Global Administrator account. Thus, other users in your tenant do not need to consent to the app.

   • After you select Client Secret, configure the following settings to set up the connection:

     • Username – Enter your username, for example: someone@contoso.com. Note that you must be a Cloud Governance administrator.

     • Client Secret – Enter the client secret that you got after configuring the API authentication profile.

3. To configure a flow, you can add multiple triggers and actions. Once you add a step, configure the corresponding required fields for a trigger or action.

4. After you configure the whole flow, click Save to save all your configurations.

The following sections list the supported triggers and actions.

#Cloud Governance Triggers

Trigger	Description
Conditional trigger	This operation triggers when:An election process is completed, or a contact is manually assigned.When all stages of an election process are overdue.
When a renewal process encounters an exception	This operation triggers when a renewal process encounters an exception.
When a renewal task is completed	This operation triggers when a renewal task is completed.
When a renewal task is overdue	This operation triggers when a renewal task is overdue.
When a request is approved	This operation triggers when a request is approved.
When a request is canceled	This operation triggers when a request is canceled.
When a request is completed	This operation triggers when a request is completed.
When a request is rejected	This operation triggers when a request is rejected.
When a request is submitted	This operation triggers when a request is submitted.
When an approval task is assigned	This operation triggers when an approval task is assigned.
When an end user completes a confirm governance details task	This operation triggers when an end user completes a confirm governance details task for a workspace.
When an error task is generated	This operation triggers when an error task is generated.
When an error task is retried	This operation triggers when the retry action is performed on an error task.
When an error task is skipped	This operation triggers when the skip action is performed on an error task.
When an import process with predefined governance details is completed	This operation triggers when an import process with predefined governance details is completed.

For more details on the triggers, refer to AvePoint Cloud Governance Connector in Power Automate.

#Cloud Governance Actions

Action	Description	Note
List workspaces	Retrieve a list of workspaces managed by Cloud Governance.	The following workspace types can be listed: Microsoft 365 Group, Microsoft Team, and site collection.
Get Microsoft 365 external sharing domain list	Gets the Microsoft 365 external sharing allowed/blocked domains.	The information of the following workspace types can be got: Microsoft 365 Group, Microsoft Team, and site collection.
Update Microsoft 365 Settings	Update Microsoft 365 settings.	Microsoft 365 settings of the following workspace types can be updated: Microsoft 365 Group, Microsoft Team, and site collection.
Manage a workspace	Manage an AvePoint Cloud Governance managed workspace.	The Restart renewal action type is currently available to be selected.The following workspace types can be managed: Microsoft 365 Group, Microsoft Team, and site collection.

For more details on the actions, refer to AvePoint Cloud Governance Connector in Power Automate.