Compartir a través de

AvePoint Cloud Governance

  • Reference

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

Operation ID:
Flow_GetRequestById

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

Operation ID:
Flow_GetOffice365Setting

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

Operation ID:
Flow_ListWorkspace

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

Operation ID:
Flow_WorkspaceActions

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

Operation ID:
Flow_SubmitRequest

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

Operation ID:
Flow_EditRequest

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

Operation ID:
Flow_UpdateOffice365Setting

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

Operation ID:
Flow_CreateHookForCommon

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

Operation ID:
Flow_CreateHookForRenewalTaskException

This operation triggers when a renewal process encounters an exception.

Returns

Body
FlowRenewalExceptionHookMessage

When a renewal task is completed

Operation ID:
Flow_CreateHookForRenewalTaskCompleted

This operation triggers when a renewal task is completed.

Returns

Body
FlowRenewalHookMessage

When a renewal task is overdue

Operation ID:
Flow_CreateHookForRenewalTaskOverdue

This operation triggers when a renewal task is overdue.

Returns

Body
FlowRenewalTaskHookMessage

When a request is approved

Operation ID:
Flow_CreateHookForTaskApproved

This operation triggers when a request is approved.

Returns

Body
FlowTaskCompletedHookMessage

When a request is canceled

Operation ID:
Flow_CreateHookForRequestCancelled

This operation triggers when a request is canceled.

Returns

Body
FlowRequestHookMessage

When a request is completed

Operation ID:
Flow_CreateHookForRequestCompleted

This operation triggers when a request is completed.

Returns

Body
FlowRequestHookMessage

When a request is rejected

Operation ID:
Flow_CreateHookForTaskRejected

This operation triggers when a request is rejected.

Returns

Body
FlowTaskCompletedHookMessage

When a request is submitted

Operation ID:
Flow_CreateHookForRequestSubmitted

This operation triggers when a request is submitted.

Returns

Body
FlowRequestHookMessage

When an approval task is assigned

Operation ID:
Flow_CreateHookForTaskCreated

This operation triggers when an approval task is assigned.

Returns

Body
FlowTaskCreatedHookMessage

When an end user completes a governance details confirmation task

Operation ID:
Flow_CreateHookForConfirmDetailCompleted

This operation triggers when an end user completes a governance details confirmation task for a workspace.

Returns

Body
FlowAutoImportHookMessage

When an error task is generated

Operation ID:
Flow_CreateHookForErrorTaskCreated

This operation triggers when an error task is generated.

Returns

Body
FlowErrorTaskCreatedHookMessage

When an error task is retried

Operation ID:
Flow_CreateHookForErrorTaskRetried

This operation triggers when the retry action is performed on an error task.

Returns

Body
FlowTaskCompletedHookMessage

When an error task is skipped

Operation ID:
Flow_CreateHookForErrorTaskSkipped

This operation triggers when the skip action is performed on an error task.

Returns

Body
FlowTaskCompletedHookMessage

When an import process with pre-defined governance details is completed

Operation ID:
Flow_CreateHookForFullyAutoImportCompleted

This operation triggers when an import process with pre-defined governance details is completed.

Returns

Body
FlowAutoImportHookMessage

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