AvePoint Cloud Governance
Automate provisioning, management, and lifecycle for Teams, Groups, Communities, and Sites. Connect to AvePoint Cloud Governance to execute additional actions in Microsoft 365 such as creation of new content, add users, and update information in lists.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | AvePoint Support |
| URL | http://www.avepoint.com/support |
| support@avepoint.com |
| Connector Metadata | |
|---|---|
| Publisher | AvePoint, inc. |
| Website | https://www.avepoint.com |
| Privacy policy | http://www.avepoint.com/privacy-policy |
| Categories | Productivity |
AvePoint Cloud Governance
The AvePoint Cloud Governance connector 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.
Pre-requisites
You will need the following to proceed:
You need to be an AvePoint Cloud Governance administrator.
If using Client Secret authentication, you need to create an API Authentication Profile in AvePoint Cloud Governance to generate a client secret.
Supported Operations
The connector supports the following operations:
Get a request: Get details of a request.Submit a request: Submit a request for a specific service.List workspaces: Retrieve a list of workspaces managed by Cloud Governance.Update a request: Update an existing request.Update Microsoft 365 settings: Update Microsoft 365 settings.
Deployment instructions
Please refer to these instructions to deploy this connector as custom connector in Microsoft Power Automate and Power Apps.
Creating a connection
The connector supports the following authentication types:
| Azure Active Directory | Sign in with Azure Active Directory | Azure Government and US Government (GCC) only | Shareable |
| Client Secret | Sign in with Secret Secret | All regions | Shareable |
| Microsoft Entra ID | Sign in with Microsoft Entra ID | All regions except Azure Government and US Government (GCC) | Shareable |
| Default [DEPRECATED] | This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility. | All regions | Not shareable |
Azure Active Directory
Auth ID: oauth
Applicable: Azure Government and US Government (GCC) only
Sign in with Azure Active Directory
This is shareable connection. If the power app is shared with another user, connection is shared as well. For more information, please see the Connectors overview for canvas apps - Power Apps | Microsoft Docs
Client Secret
Auth ID: basic
Applicable: All regions
Sign in with Secret Secret
This is shareable connection. If the power app is shared with another user, connection is shared as well. For more information, please see the Connectors overview for canvas apps - Power Apps | Microsoft Docs
| Name | Type | Description | Required |
|---|---|---|---|
| Username | securestring | Enter your username. You must be an AvePoint Cloud Governance administrator. | True |
| Client Secret | securestring | Enter the client secret to authenticate with AvePoint Cloud Governance API. | True |
Microsoft Entra ID
Auth ID: oauth
Applicable: All regions except Azure Government and US Government (GCC)
Sign in with Microsoft Entra ID
This is shareable connection. If the power app is shared with another user, connection is shared as well. For more information, please see the Connectors overview for canvas apps - Power Apps | Microsoft Docs
Default [DEPRECATED]
Applicable: All regions
This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| Username | securestring | Enter your username. You must be an AvePoint Cloud Governance administrator. | True |
| Client Secret | securestring | Enter the client secret to authenticate with AvePoint Cloud Governance API. | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Get a request |
Get details of a request. |
| Get Microsoft 365 settings |
Get Microsoft 365 settings. |
| List workspaces |
Retrieve a list of workspaces managed by Cloud Governance. |
| Manage a workspace |
Manage an AvePoint Cloud Governance managed workspace. |
| Submit a request |
Submit a request for a specific service. |
| Update a request |
Update an existing request. |
| Update Microsoft 365 settings |
Update Microsoft 365 settings. |
Get a request
Get details of a request.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Service Type
|
serviceType | True | string |
Type of the service. |
|
Service Name
|
serviceId | True | string |
Name of the service. |
|
Request ID
|
requestId | True | uuid |
Unique ID of the request. |
Returns
Get Microsoft 365 settings
Get Microsoft 365 settings.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Action Type
|
actionType | True | string |
Specify an action type. |
|
body
|
body | True | dynamic |
Returns
List workspaces
Retrieve a list of workspaces managed by Cloud Governance.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace Type
|
workspaceType | string |
Filter by the workspace type. |
|
|
Primary Workspace Contact
|
primaryContact | string |
Filter by the primary workspace contact. |
|
|
Workspace Status
|
status | string |
Filter by the workspace status. |
|
|
Workspace URL or Email Address
|
urlorIdorEmail | string |
Filter by the workspace URL or email address. |
|
|
Secondary Workspace Contact
|
secondaryContact | string |
Filter by the secondary workspace contact. |
|
|
Workspace Count
|
top | integer |
Number of workspaces to retrieve (default = 2000, maximum = 3000). |
|
|
Next Token
|
nextLink | string |
Use the next token to retrieve remaining workspaces that have not been listed here. |
Returns
Manage a workspace
Manage an AvePoint Cloud Governance managed workspace.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace Type
|
workspaceType | True | string |
Select a workspace type. |
|
Action Type
|
workspaceAction | True | string |
Choose how to manage a workspace. |
|
body
|
body | True | dynamic |
Returns
- response
- uuid
Submit a request
Submit a request for a specific service.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Service Type
|
serviceType | True | string |
Type of the service. |
|
Service Name
|
serviceId | True | string |
Name of the service. |
|
Requester Username
|
DelegateUserPrincipalName | string |
Username of the requester. |
|
|
body
|
body | True | dynamic |
Returns
- response
- uuid
Update a request
Update an existing request.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Service Type
|
serviceType | True | string |
Type of the service. |
|
Service Name
|
serviceId | True | string |
Name of the service. |
|
Request ID
|
id | True | uuid |
Unique ID of the request. |
|
body
|
body | True | dynamic |
Update Microsoft 365 settings
Update Microsoft 365 settings.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Action Type
|
actionType | True | string |
Specify an action type. |
|
body
|
body | True | dynamic |
Triggers
| Conditional Trigger |
This operation triggers when the selected event occurs. |
| 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 governance details confirmation task |
This operation triggers when an end user completes a governance details confirmation 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 pre-defined governance details is completed |
This operation triggers when an import process with pre-defined governance details is completed. |
Conditional Trigger
This operation triggers when the selected event occurs.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Trigger Event
|
flowTriggerType | True | string |
Select a trigger event. |
Returns
When a renewal process encounters an exception
This operation triggers when a renewal process encounters an exception.
Returns
When a renewal task is completed
When a renewal task is overdue
When a request is approved
When a request is canceled
When a request is completed
When a request is rejected
When a request is submitted
When an approval task is assigned
When an end user completes a governance details confirmation task
This operation triggers when an end user completes a governance details confirmation task for a workspace.
Returns
When an error task is generated
This operation triggers when an error task is generated.
Returns
When an error task is retried
This operation triggers when the retry action is performed on an error task.
Returns
When an error task is skipped
This operation triggers when the skip action is performed on an error task.
Returns
When an import process with pre-defined governance details is completed
This operation triggers when an import process with pre-defined governance details is completed.
Returns
Definitions
FlowAutoImportHookMessage
| Name | Path | Type | Description |
|---|---|---|---|
|
Automatic Import Profile
|
autoImportProfileName | string |
Name of the automatic import profile. |
|
Workspace Name
|
objectTitle | string |
Name of the workspace. |
|
Workspace Type
|
objectType | string |
Type of workspace. |
|
Workspace Email Address
|
groupEmail | string |
Email address of the workspace. |
|
Trigger Time
|
triggerTime | string |
The time that this trigger works. |
|
Site URL
|
objectUrl | string |
URL of the site. |
|
Workspace ID
|
objectId | string |
Unique ID of the workspace. |
FlowErrorTaskCreatedHookMessage
| Name | Path | Type | Description |
|---|---|---|---|
|
Request Summary
|
summary | string |
Summary of the request. |
|
Task ID
|
taskId | string |
Unique ID of the task. |
|
Task Link
|
taskLink | string |
Link of the task. |
|
Assignee Display Name
|
assigneeDisplayName | string |
Display name of the task assignee. |
|
Assignee Username
|
assigneeIdentityName | string |
Username of the task assignee. |
|
Error Details
|
message | string |
Details of the error task. |
|
Request Ticket Number
|
requestId | string |
Ticket number of the request. |
|
Request ID
|
requestGuid | string |
Unique ID of the request. |
|
Requester Username
|
requesterIdentityName | string |
Username of the requester. |
|
Requester Display Name
|
requester | string |
Display name of the requester. |
|
Service Type
|
serviceType | string |
Type of the service. |
|
Trigger Time
|
triggerTime | string |
The time that this trigger works. |
|
Site URL
|
objectUrl | string |
URL of the site. |
|
Workspace ID
|
objectId | string |
Unique ID of the workspace. |
FlowRenewalExceptionHookMessage
| Name | Path | Type | Description |
|---|---|---|---|
|
Workspace Name
|
objectTitle | string |
Name of the workspace. |
|
Workspace Type
|
objectType | string |
Type of workspace. |
|
Workspace Email Address
|
groupEmail | string |
Email address of the workspace. |
|
Renewal Process Start Time
|
phaseStartTime | string |
Start time of the renewal process. |
|
Renewal Process Due Date
|
dueDate | string |
Due date of the renewal process. |
|
Renewal Task Assignee Display Name
|
assigneeDisplayName | string |
Display name of the renewal task assignee. |
|
Renewal Task Assignee Username
|
assigneeIdentityName | string |
Username of the renewal task assignee. |
|
Renewal Profile
|
renewalProfileName | string |
Name of the renewal profile. |
|
Renewal Task Link
|
taskLink | string |
Link of the renewal task. |
|
Renewal Error Details
|
message | string |
Details of the renewal exception. |
|
Trigger Time
|
triggerTime | string |
The time that this trigger works. |
|
Site URL
|
objectUrl | string |
URL of the site. |
|
Workspace ID
|
objectId | string |
Unique ID of the workspace. |
FlowRenewalHookMessage
| Name | Path | Type | Description |
|---|---|---|---|
|
Workspace Name
|
objectTitle | string |
Name of the workspace. |
|
Workspace Type
|
objectType | string |
Type of workspace. |
|
Workspace Email Address
|
groupEmail | string |
Email address of the workspace. |
|
Renewal Process Start Time
|
phaseStartTime | string |
Start time of the renewal process. |
|
Renewal Profile
|
renewalProfileName | string |
Name of the renewal profile. |
|
Trigger Time
|
triggerTime | string |
The time that this trigger works. |
|
Site URL
|
objectUrl | string |
URL of the site. |
|
Workspace ID
|
objectId | string |
Unique ID of the workspace. |
FlowRenewalTaskHookMessage
| Name | Path | Type | Description |
|---|---|---|---|
|
Workspace Name
|
objectTitle | string |
Name of the workspace. |
|
Workspace Type
|
objectType | string |
Type of workspace. |
|
Workspace Email Address
|
groupEmail | string |
Email address of the workspace. |
|
Renewal Process Start Time
|
phaseStartTime | string |
Start time of the renewal process. |
|
Renewal Process Due Date
|
dueDate | string |
Due date of the renewal process. |
|
Renewal Task Assignee Display Name
|
assigneeDisplayName | string |
Display name of the renewal task assignee. |
|
Renewal Task Assignee Username
|
assigneeIdentityName | string |
Username of the renewal task assignee. |
|
Renewal Profile
|
renewalProfileName | string |
Name of the renewal profile. |
|
Renewal Task Link
|
taskLink | string |
Link of the renewal task. |
|
Trigger Time
|
triggerTime | string |
The time that this trigger works. |
|
Site URL
|
objectUrl | string |
URL of the site. |
|
Workspace ID
|
objectId | string |
Unique ID of the workspace. |
FlowRequestHookMessage
| Name | Path | Type | Description |
|---|---|---|---|
|
Request Summary
|
summary | string |
Summary of the request. |
|
Request Ticket Number
|
requestId | string |
Ticket number of the request. |
|
Request ID
|
requestGuid | string |
Unique ID of the request. |
|
Requester Username
|
requesterIdentityName | string |
Username of the requester. |
|
Requester Display Name
|
requester | string |
Display name of the requester. |
|
Service Type
|
serviceType | string |
Type of the service. |
|
Service Name
|
serviceName | string |
Name of the service. |
|
Service ID
|
serviceId | string |
Unique ID of the service. |
|
Trigger Time
|
triggerTime | string |
The time that this trigger works. |
|
Site URL
|
objectUrl | string |
URL of the site. |
|
Workspace ID
|
objectId | string |
Unique ID of the workspace. |
FlowTaskCompletedHookMessage
| Name | Path | Type | Description |
|---|---|---|---|
|
Request Summary
|
summary | string |
Summary of the request. |
|
Task ID
|
taskId | string |
Unique ID of the task. |
|
Task Link
|
taskLink | string |
Link of the task. |
|
Approver Display Name
|
approverDisplayName | string |
Display name of the approver. |
|
Approver Username
|
approverIdentityName | string |
Username of the approver. |
|
Request Ticket Number
|
requestId | string |
Ticket number of the request. |
|
Request ID
|
requestGuid | string |
Unique ID of the request. |
|
Requester Username
|
requesterIdentityName | string |
Username of the requester. |
|
Requester Display Name
|
requester | string |
Display name of the requester. |
|
Service Type
|
serviceType | string |
Type of the service. |
|
Trigger Time
|
triggerTime | string |
The time that this trigger works. |
|
Site URL
|
objectUrl | string |
URL of the site. |
|
Workspace ID
|
objectId | string |
Unique ID of the workspace. |
FlowTaskCreatedHookMessage
| Name | Path | Type | Description |
|---|---|---|---|
|
Request Summary
|
summary | string |
Summary of the request. |
|
Task ID
|
taskId | string |
Unique ID of the task. |
|
Task Link
|
taskLink | string |
Link of the task. |
|
Assignee Display Name
|
assigneeDisplayName | string |
Display name of the task assignee. |
|
Assignee Username
|
assigneeIdentityName | string |
Username of the task assignee. |
|
Request Ticket Number
|
requestId | string |
Ticket number of the request. |
|
Request ID
|
requestGuid | string |
Unique ID of the request. |
|
Requester Username
|
requesterIdentityName | string |
Username of the requester. |
|
Requester Display Name
|
requester | string |
Display name of the requester. |
|
Service Type
|
serviceType | string |
Type of the service. |
|
Trigger Time
|
triggerTime | string |
The time that this trigger works. |
|
Site URL
|
objectUrl | string |
URL of the site. |
|
Workspace ID
|
objectId | string |
Unique ID of the workspace. |