Partilhar via


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
Email 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

The outputs of this operation are dynamic.

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

The outputs of this operation are dynamic.

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

The outputs of this operation are dynamic.

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

The outputs of this operation are dynamic.

When a renewal process encounters an exception

This operation triggers when a renewal process encounters an exception.

Returns

When a renewal task is completed

This operation triggers when a renewal task is completed.

Returns

When a renewal task is overdue

This operation triggers when a renewal task is overdue.

Returns

When a request is approved

This operation triggers when a request is approved.

Returns

When a request is canceled

This operation triggers when a request is canceled.

Returns

When a request is completed

This operation triggers when a request is completed.

Returns

When a request is rejected

This operation triggers when a request is rejected.

Returns

When a request is submitted

This operation triggers when a request is submitted.

Returns

When an approval task is assigned

This operation triggers when an approval task is assigned.

Returns

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.

uuid