Power Platform per gli amministratori

Power Platform Management Connector fornisce l'accesso alle funzionalità di gestione del ciclo di vita dell'ambiente, alla gestione dei criteri DLP e ad altre funzionalità di amministrazione fornite nell'API BAP.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Normale	Tutte le aree di Power Automate
Power Apps	Normale	Tutte le aree di Power Apps
Power Automate	Normale	Tutte le aree di Power Automate

Contatto
Nome	Supporto di Microsoft Power Apps
URL	https://powerapps.microsoft.com/en-us/support/

Metadati del connettore
Editore	Microsoft
Sito web	https://admin.powerplatform.microsoft.com/
Informativa sulla privacy	https://privacy.microsoft.com/en-us/privacystatement

Power Platform for Admins è un'interfaccia connettore per accedere all'API BAP (Business Applications Platform), che viene usata per gestire le risorse correlate all'amministratore di Power Platform, ovvero la stessa API che gestisce l'interfaccia di amministrazione di Power Platform. Sono incluse la gestione del ciclo di vita e delle autorizzazioni dell'ambiente, le operazioni di provisioning di Dataverse, i criteri DLP e la sincronizzazione utente.

Prerequisiti

Qualsiasi utente può creare una connessione autenticata con ID Entra Microsoft a questo connettore, i dati verranno restituiti in base all'ambito dell'utente.

• Gli amministratori del servizio Power Platform avranno accesso a tutte le risorse e le operazioni disponibili nel tenant da questo endpoint.
• Gli amministratori dell'ambiente avranno accesso solo ai dati e alle operazioni nei propri ambienti, i criteri di prevenzione della perdita dei dati che possono gestire o sono interessati da .

Problemi noti e limitazioni

1. Non passare un valore Null o Blank() come gruppo di connettori API (matrice) durante la creazione o l'aggiornamento di un criterio DLP, potrebbe interrompere il criterio e diventare inutilizzabile con altre conseguenze impreviste. Se il gruppo non deve contenere connettori, passare un set vuoto di parentesi quadre [ ].
2. Le operazioni DLP precedenti non funzionano con i gruppi bloccati DLP aggiornati e sono deprecate. Usare le versioni "V2" di tutte le operazioni DLP.
3. I gruppi di criteri di prevenzione della perdita dei dati non vengono popolati automaticamente con i connettori, quindi dovranno essere recuperati, formattati e aggiunti come parametri di input:
   • Creare una variabile di matrice per archiviare i connettori.
   • Salvare l'ID ambiente predefinito del tenant in una variabile.
   • Usare l'operazione GetConnectors da Power Platform per autori di app per recuperare tutti i connettori per un ambiente (usare il filtro "environment eq '{environmentName}' ", dove il nome dell'ambiente è del passaggio precedente).
   • Usare l'operazione Select per usare solo i campi id, name e type della risposta GetConnectors (usare l'ultima opzione di contenuto dinamico 'value'). Inserire ID, nome e digitare sul lato sinistro e mappare l'ID, displayName e digitare il lato destro dell'azione di selezione.
   • Salvare l'output di Select nella variabile di matrice
   • Aggiungere questi connettori hardcoded alla variabile di matrice (non vengono visualizzati nella risposta GetConnectors):

     [
         {
           "id": "/providers/Microsoft.PowerApps/apis/shared_microsoftspatialservices",
           "name": "Spatial Services",
           "type": "Microsoft.PowerApps/apis"
         },
         {
           "id": "HttpRequestReceived",
           "name": "When a HTTP request is received",
           "type": "Microsoft.PowerApps/apis"
         },
         {
           "id": "HttpWebhook",
           "name": "HTTP Webhook",
           "type": "Microsoft.PowerApps/apis"
         },
           {
           "id": "Http",
           "name": "HTTP",
           "type": "Microsoft.PowerApps/apis"
         }
     ]
     

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi

Azioni

Aggiornare i criteri di prevenzione della perdita dei dati dei tenant	Aggiorna i campi in un criterio di prevenzione della perdita dei dati.
Aggiornare i criteri DLP dell'ambiente	Aggiorna un criterio di prevenzione della perdita dei dati dell'ambiente.
Aggiornare i criteri DLP V2	Aggiorna un criterio di prevenzione della perdita dei dati.
Aggiornare l'ambiente	Aggiorna le proprietà di un ambiente.
Convalidare l'eliminazione dell'ambiente	Usato per verificare se è possibile eliminare un ambiente.
Crea ambiente	Crea un nuovo ambiente.
Creare criteri di prevenzione della perdita dei dati del tenant	Crea un nuovo criterio di prevenzione della perdita dei dati del tenant.
Creare criteri di prevenzione della perdita dei dati dell'ambiente	Crea un criterio di prevenzione della perdita dei dati dell'ambiente.
Creare criteri DLP V2	Crea un nuovo criterio DLP.
Creare un database CDS	Crea una nuova istanza cds nell'ambiente specificato.
Elencare gli ambienti come amministratore	Restituisce un elenco di ambienti.
Elencare i connettori sbloccabili	Restituisce un elenco di connettori che non possono essere bloccati con un criterio di prevenzione della perdita dei dati.
Elencare i connettori virtuali	Restituisce un elenco di connettori virtuali.
Elencare i criteri di prevenzione della perdita dei dati	Restituisce un elenco di tutti i criteri DLP del tenant e dell'ambiente.
Elencare i criteri DLP V2	Restituisce un elenco di tutti i criteri DLP a cui l'account può accedere.
Elencare i percorsi supportati	Restituisce un elenco di percorsi in cui è supportato il servizio BAP.
Elencare le assegnazioni di ruolo dell'ambiente	Restituisce un elenco di autorizzazioni per un ambiente senza CDS per le app.
Elencare le lingue dell'ambiente supportate	Restituisce un elenco di lingue supportate in base alla posizione.
Elencare le valute dell'ambiente supportate	Restituisce un elenco di valute supportate in base alla posizione.
Eliminare i criteri di prevenzione della perdita dei dati dei tenant	Elimina un criterio di prevenzione della perdita dei dati del tenant.
Eliminare i criteri di prevenzione della perdita dei dati dell'ambiente	Elimina un criterio di prevenzione della perdita dei dati dell'ambiente.
Eliminare i criteri DLP V2	Elimina un criterio di prevenzione della perdita dei dati.
Eliminare l'ambiente	Elimina un ambiente.
Forzare l'utente di sincronizzazione	Usato per sincronizzare l'utente di PowerApps con CRM.
Modifica assegnazione ruolo ambiente	Imposta le autorizzazioni per un ambiente.
Ottenere i criteri di prevenzione della perdita dei dati dei tenant	Restituisce un criterio di prevenzione della perdita dei dati del tenant.
Ottenere i criteri di prevenzione della perdita dei dati dell'ambiente	Restituisce un criterio di prevenzione della perdita dei dati dell'ambiente.
Ottenere i criteri DLP V2	Restituisce un criterio DLP.
Ottenere l'ambiente come amministratore	Restituisce un singolo ambiente come amministratore.
Ottenere lo stato del provisioning del database	Consente di controllare lo stato di un'operazione di provisioning.
Ottenere lo stato dell'operazione del ciclo di vita	Restituisce lo stato corrente dell'operazione del ciclo di vita che si verifica dopo una patch dell'ambiente.
Ottenere lo stato dell'operazione di ambiente (anteprima)	Usato per controllare lo stato di un'operazione di ambiente, sucn come eliminazione.
Ottenere lo stato di provisioning di CDS	Consente di controllare lo stato di un'operazione di provisioning.

Aggiornare i criteri di prevenzione della perdita dei dati dei tenant

ID operazione:

Edit-AdminDlpPolicy

Aggiorna i campi in un criterio di prevenzione della perdita dei dati.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Policy	policy	True	string	Campo nome del criterio.
Versione dell'API	api-version		string	Valore della data dell'API.
Nome visualizzato	displayName	True	string	Nome visualizzato di Criteri API.
Versione schema	$schema	True	string	Definizione di Criteri API $schema.
Tipo di vincolo	type	True	string	Tipo di vincolo dei criteri, lasciare vuoto per applicare i criteri a tutti gli ambienti.
Nome	name	True	string	Campo Nome ambiente criteri.
Documento d'identità	id	True	string	Campo ID ambiente criteri.
TIPO	type	True	string	Campo Tipo ambiente criteri.
Tipo di filtro dell'ambiente	filterType	True	string	Api Policy constraint environmentFilter1 parameter filterType.Api Policy constraint environmentFilter1 parameter filterType.
Descrizione dei dati business	description		string	Descrizione del gruppo di dati business dei criteri.
ID del connettore	id		string	Campo ID connettore dati business.
Nome del connettore	name		string	Campo nome connettore dati business.
Tipo connettore	type		string	Campo tipo connettore dati business.
Descrizione dei dati non business	description		string	Descrizione del gruppo di dati non business.
ID del connettore	id		string	Campo ID connettore non Business Data.
Nome del connettore	name		string	Campo Nome connettore dati non business.
Tipo connettore	type		string	Campo Tipo connettore dati non business.
Gruppo predefinito	defaultApiGroup	True	string	Il raggruppamento di un nuovo connettore viene aggiunto automaticamente a.
type	type	True	string	Tipo apiGroupRule della regola dei criteri.
apiGroup	apiGroup	True	string	ApiGroupRule parameter apiGroup.
Tipo di azione blocca	type	True	string	Tipo di azione Blocca, lasciare vuoto se non si desidera aggiungere un blocco.

Restituisce

Corpo

Policy

Aggiornare i criteri DLP dell'ambiente

ID operazione:

EditEnvironmentPolicy

Aggiorna un criterio di prevenzione della perdita dei dati dell'ambiente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Policy	policy	True	string	Campo nome del criterio.
Versione dell'API	api-version		string	Valore della data dell'API.
Nome visualizzato	displayName	True	string	Nome visualizzato di Criteri API.
Versione schema	$schema	True	string	Definizione di Criteri API $schema.
Nome	name	True	string	Campo Nome ambiente criteri.
Documento d'identità	id	True	string	Campo ID ambiente criteri.
TIPO	type	True	string	Campo Tipo ambiente criteri.
Descrizione dei dati business	description		string	Descrizione del gruppo di dati business dei criteri.
ID del connettore	id		string	Campo ID connettore dati business.
Nome del connettore	name		string	Campo nome connettore dati business.
Tipo connettore	type		string	Campo tipo connettore dati business.
Descrizione dei dati non business	description		string	Descrizione del gruppo di dati non business.
ID del connettore	id		string	Campo ID connettore non Business Data.
Nome del connettore	name		string	Campo Nome connettore dati non business.
Tipo connettore	type		string	Campo Tipo connettore dati non business.
Gruppo predefinito	defaultApiGroup	True	string	Il raggruppamento di un nuovo connettore viene aggiunto automaticamente a.
type	type	True	string	Tipo apiGroupRule della regola dei criteri.
apiGroup	apiGroup	True	string	ApiGroupRule parameter apiGroup.
Tipo di azione blocca	type	True	string	Tipo di azione Blocca, lasciare vuoto se non si desidera aggiungere un blocco.

Restituisce

Corpo

Policy

Aggiornare i criteri DLP V2

ID operazione:

UpdatePolicyV2

Aggiorna un criterio di prevenzione della perdita dei dati.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Policy	policy	True	string	Campo nome del criterio.
Versione dell'API	api-version		string	Valore della data dell'API.
Nome visualizzato	displayName		string
Classificazione dei connettori predefiniti	defaultConnectorsClassification		string
classificazione	classification	True	string
id	id	True	string
type	type	True	string
nome	name	True	string
Tipo di ambiente dei criteri	environmentType		string
id	id	True	string
type	type	True	string
nome	name	True	string

Restituisce

Corpo

PolicyV2

Aggiornare l'ambiente

ID operazione:

UpdateEnvironment

Aggiorna le proprietà di un ambiente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Versione dell'API	api-version		string	Valore della data dell'API.
descrizione	description		string
nome visualizzato	displayName		string
securityGroupId	securityGroupId		string

Convalidare l'eliminazione dell'ambiente

ID operazione:

ValidateDelete

Usato per verificare se è possibile eliminare un ambiente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

Corpo

ValidateDeleteResponse

Crea ambiente

ID operazione:

NewAdminEnvironment

Crea un nuovo ambiente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Versione dell'API	api-version	True	string	Valore della data dell'API.
Posizione	location	True	string	Area in cui viene distribuito l'ambiente.
Nome visualizzato	displayName	True	string	Nome di vanità dell'ambiente.
Sku dell'ambiente	environmentSku	True	string	Tipo di ambiente.

Restituisce

Oggetto Environment.

Corpo

Environment

Creare criteri di prevenzione della perdita dei dati del tenant

ID operazione:

NewTenantPolicy

Crea un nuovo criterio di prevenzione della perdita dei dati del tenant.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Versione dell'API	api-version		string	Valore della data dell'API.
Nome visualizzato	displayName	True	string	Nome visualizzato di Criteri API.
Versione schema	$schema	True	string	Definizione di Criteri API $schema.
Tipo di vincolo	type	True	string	Tipo di vincolo dei criteri, lasciare vuoto per applicare i criteri a tutti gli ambienti.
Nome	name	True	string	Campo Nome ambiente criteri.
Documento d'identità	id	True	string	Campo ID ambiente criteri.
TIPO	type	True	string	Campo Tipo ambiente criteri.
Tipo di filtro dell'ambiente	filterType	True	string	Api Policy constraint environmentFilter1 parameter filterType.Api Policy constraint environmentFilter1 parameter filterType.
Descrizione dei dati business	description		string	Descrizione del gruppo di dati business dei criteri.
ID del connettore	id		string	Campo ID connettore dati business.
Nome del connettore	name		string	Campo nome connettore dati business.
Tipo connettore	type		string	Campo tipo connettore dati business.
Descrizione dei dati non business	description		string	Descrizione del gruppo di dati non business.
ID del connettore	id		string	Campo ID connettore non Business Data.
Nome del connettore	name		string	Campo Nome connettore dati non business.
Tipo connettore	type		string	Campo Tipo connettore dati non business.
Gruppo predefinito	defaultApiGroup	True	string	Il raggruppamento di un nuovo connettore viene aggiunto automaticamente a.
type	type	True	string	Tipo apiGroupRule della regola dei criteri.
apiGroup	apiGroup	True	string	ApiGroupRule parameter apiGroup.
Tipo di azione blocca	type	True	string	Tipo di azione Blocca, lasciare vuoto se non si desidera aggiungere un blocco.

Restituisce

Corpo

Policy

Creare criteri di prevenzione della perdita dei dati dell'ambiente

ID operazione:

NewEnvironmentPolicy

Crea un criterio di prevenzione della perdita dei dati dell'ambiente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Versione dell'API	api-version		string	Valore della data dell'API.
Ambiente	environment	True	string	Nome dell'ambiente.
Nome visualizzato	displayName	True	string	Nome visualizzato di Criteri API.
Versione schema	$schema	True	string	Definizione di Criteri API $schema.
Nome	name	True	string	Campo Nome ambiente criteri.
Documento d'identità	id	True	string	Campo ID ambiente criteri.
TIPO	type	True	string	Campo Tipo ambiente criteri.
Descrizione dei dati business	description		string	Descrizione del gruppo di dati business dei criteri.
ID del connettore	id		string	Campo ID connettore dati business.
Nome del connettore	name		string	Campo nome connettore dati business.
Tipo connettore	type		string	Campo tipo connettore dati business.
Descrizione dei dati non business	description		string	Descrizione del gruppo di dati non business.
ID del connettore	id		string	Campo ID connettore non Business Data.
Nome del connettore	name		string	Campo Nome connettore dati non business.
Tipo connettore	type		string	Campo Tipo connettore dati non business.
Gruppo predefinito	defaultApiGroup	True	string	Il raggruppamento di un nuovo connettore viene aggiunto automaticamente a.
type	type	True	string	Tipo apiGroupRule della regola dei criteri.
apiGroup	apiGroup	True	string	ApiGroupRule parameter apiGroup.
Tipo di azione blocca	type	True	string	Tipo di azione Blocca, lasciare vuoto se non si desidera aggiungere un blocco.

Restituisce

Corpo

Policy

Creare criteri DLP V2

ID operazione:

CreatePolicyV2

Crea un nuovo criterio DLP.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome visualizzato	displayName		string
Classificazione dei connettori predefiniti	defaultConnectorsClassification		string
classificazione	classification	True	string
id	id	True	string
type	type	True	string
nome	name	True	string
Tipo di ambiente dei criteri	environmentType		string
id	id	True	string
type	type	True	string
nome	name	True	string

Restituisce

Corpo

PolicyV2

Creare un database CDS

ID operazione:

ProvisionInstance

Crea una nuova istanza cds nell'ambiente specificato.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Lingua di base	baseLanguage		integer	Qualsiasi lingua restituita da List Environment Languages.Any language returned from List Environment Languages.
Codice valuta	code		string	Qualsiasi codice di valuta restituito da List Environment Currencies.Any currency code returned from List Environment Currencies.
Modelli	templates		array of string	Elenco convalidato di modelli CRM da passare alla chiamata di provisioning.

Restituisce

Oggetto Environment.

Corpo

Environment

Elencare gli ambienti come amministratore

ID operazione:

Get-AdminEnvironment

Restituisce un elenco di ambienti.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Versione dell'API	api-version		string	Valore della data dell'API.
Ignora token	$skiptoken		string	Input utilizzato per ottenere la pagina successiva della risposta.
Dimensioni pagina	$top		integer	Numero di ambienti nella risposta.
Espandere le proprietà	$expand		string	Consente l'accesso per espandere le proprietà della risposta.

Restituisce

Corpo

ResourceArray[Environment]

Elencare i connettori sbloccabili

ID operazione:

ListUnblockableConnectors

Restituisce un elenco di connettori che non possono essere bloccati con un criterio di prevenzione della perdita dei dati.

Restituisce

Nome	Percorso	Tipo	Descrizione
		array of object
id	id	string
sbloccabile	metadata.unblockable	boolean

Elencare i connettori virtuali

ID operazione:

ListVirtualConnectors

Restituisce un elenco di connettori virtuali.

Restituisce

Nome	Percorso	Tipo	Descrizione
		array of object
id	id	string
virtualConnector	metadata.virtualConnector	boolean
nome	metadata.name	string
type	metadata.type	string
iconUri	metadata.iconUri	string
nome visualizzato	metadata.displayName	string

Elencare i criteri di prevenzione della perdita dei dati

ID operazione:

Get-AdminDlpPolicies

Restituisce un elenco di tutti i criteri DLP del tenant e dell'ambiente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

Corpo

ResourceArray[Policy]

Elencare i criteri DLP V2

ID operazione:

ListPoliciesV2

Restituisce un elenco di tutti i criteri DLP a cui l'account può accedere.

Restituisce

Corpo

ResourceArray[PolicyV2]

Elencare i percorsi supportati

ID operazione:

ListSupportedLocations

Restituisce un elenco di percorsi in cui è supportato il servizio BAP.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

Corpo

Locations

Elencare le assegnazioni di ruolo dell'ambiente

ID operazione:

Get-AdminEnvironmentRoleAssignment

Restituisce un elenco di autorizzazioni per un ambiente senza CDS per le app.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

Corpo

ResourceArray[RoleAssignment]

Elencare le lingue dell'ambiente supportate

ID operazione:

ListEnvironmentLanguages

Restituisce un elenco di lingue supportate in base alla posizione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Posizione	environmentLocation	True	string	Posizione dell'ambiente.
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

Corpo

Languages

Elencare le valute dell'ambiente supportate

ID operazione:

ListEnvironmentCurrencies

Restituisce un elenco di valute supportate in base alla posizione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Posizione	environmentLocation	True	string	Posizione dell'ambiente.
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

Corpo

Currencies

Eliminare i criteri di prevenzione della perdita dei dati dei tenant

ID operazione:

RemoveTenantPolicy

Elimina un criterio di prevenzione della perdita dei dati del tenant.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Policy	policy	True	string	Campo nome del criterio.
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

response

object

Eliminare i criteri di prevenzione della perdita dei dati dell'ambiente

ID operazione:

RemoveEnvironmentPolicy

Elimina un criterio di prevenzione della perdita dei dati dell'ambiente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Policy	policy	True	string	Campo nome del criterio.
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

response

object

Eliminare i criteri DLP V2

ID operazione:

DeletePolicyV2

Elimina un criterio di prevenzione della perdita dei dati.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Policy	policy	True	string	Campo nome del criterio.

Restituisce

response

object

Eliminare l'ambiente

ID operazione:

Remove-AdminEnvironment

Elimina un ambiente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

response

object

Forzare l'utente di sincronizzazione

ID operazione:

Add-AdminPowerAppsSyncUser

Usato per sincronizzare l'utente di PowerApps con CRM.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
ObjectId	ObjectId	True	string	ID oggetto utente.
Versione dell'API	api-version		string	Valore della data dell'API.

Modifica assegnazione ruolo ambiente

ID operazione:

Edit-AdminEnvironmentRoleAssignment

Imposta le autorizzazioni per un ambiente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Versione dell'API	api-version		string	Valore della data dell'API.
Indirizzo di posta elettronica principale	email		string	Indirizzo di posta elettronica principale dell'utente.
ID tenant principale	tenantId		string	ID tenant principale dell'utente.
ID oggetto Principal	id		string	ID oggetto principale dell'utente.
Tipo di entità	type		string	Tipo principale dell'utente.
ID definizione ruolo	id		string	ID definizione del ruolo. Formato: /providers/Microsoft.BusinessAppPlatform/scopes/admin/environments/{environment}/{roleName}.
id	id		string	Campo ID.

Restituisce

Corpo

RoleAssignment

Ottenere i criteri di prevenzione della perdita dei dati dei tenant

ID operazione:

GetTenantPolicy

Restituisce un criterio di prevenzione della perdita dei dati del tenant.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Policy	policy	True	string	Campo nome del criterio.
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

Corpo

Policy

Ottenere i criteri di prevenzione della perdita dei dati dell'ambiente

ID operazione:

GetEnvironmentPolicy

Restituisce un criterio di prevenzione della perdita dei dati dell'ambiente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Policy	policy	True	string	Campo nome del criterio.
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

Corpo

Policy

Ottenere i criteri DLP V2

ID operazione:

GetPolicyV2

Restituisce un criterio DLP.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Policy	policy	True	string	Campo nome del criterio.

Restituisce

Corpo

PolicyV2

Ottenere l'ambiente come amministratore

ID operazione:

GetSingleEnvironment

Restituisce un singolo ambiente come amministratore.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Versione dell'API	api-version		string	Valore della data dell'API.

Restituisce

Oggetto Environment.

Corpo

Environment

Ottenere lo stato del provisioning del database

ID operazione:

GetProvisionOperationV2

Consente di controllare lo stato di un'operazione di provisioning.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Operation	operationName	True	string	Nome dell'operazione. L'intero URI verrà restituito come intestazione Location da /provisionInstance e includerà questo valore.
Versione dell'API	api-version		string	Valore della data dell'API.

Ottenere lo stato dell'operazione del ciclo di vita

ID operazione:

GetLifecycleOperationStatus

Restituisce lo stato corrente dell'operazione del ciclo di vita che si verifica dopo una patch dell'ambiente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Operazione del ciclo di vita	lifecycleOperationId	True	string	ID dell'operazione del ciclo di vita.
Versione dell'API	api-version		string	Valore della data dell'API.

Ottenere lo stato dell'operazione di ambiente (anteprima)

ID operazione:

GetEnvironmentOperation

Usato per controllare lo stato di un'operazione di ambiente, sucn come eliminazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Operation	operationName	True	string	Nome dell'operazione.
Versione dell'API	api-version		string	Valore della data dell'API.

Ottenere lo stato di provisioning di CDS

ID operazione:

GetProvisionOperation

Consente di controllare lo stato di un'operazione di provisioning.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Ambiente	environment	True	string	Nome dell'ambiente.
Operation	operationName	True	string	Nome dell'operazione.
Versione dell'API	api-version		string	Valore della data dell'API.

Definizioni

ResourceArray[Policy]

Nome	Percorso	Tipo	Descrizione
value	value	array of Policy

Policy

Nome	Percorso	Tipo	Descrizione
ID criterio	id	string	Campo ID criterio.
Tipo di criterio	type	string	Campo Tipo di criterio.
Nome criterio	name	string	Campo Nome criterio.
Nome visualizzato	properties.displayName	string	Nome visualizzato di Criteri API.
Tempo di creazione	properties.createdTime	date-time	Tempo di creazione di Criteri API.
Creato da	properties.createdBy	Principal[CreatedBy]	Criteri creati dall'oggetto principal.
Ora modificata	properties.lastModifiedTime	date-time	Ora modificata di Criteri API.
Modificato da	properties.lastModifiedBy	Principal[ModifiedBy]	Criteri modificati dall'oggetto principal.
Versione schema	properties.definition.$schema	PolicySchema	Definizione di Criteri API $schema.
TIPO	properties.definition.constraints.environmentFilter1.type	string	Ambiente dei criteriTipo filtro.
Environments	properties.definition.constraints.environmentFilter1.parameters.environments	PolicyEnvironments	Ambiente criteri.
Tipo di filtro	properties.definition.constraints.environmentFilter1.parameters.filterType	string	Api Policy constraint environmentFilter1 parameter filterType.Api Policy constraint environmentFilter1 parameter filterType.
apiGroups	properties.definition.apiGroups	PolicyApiGroups
Gruppo predefinito	properties.definition.defaultApiGroup	PolicyDefaultApiGroup	Il raggruppamento di un nuovo connettore viene aggiunto automaticamente a.
regole	properties.definition.rules	PolicyRules	Oggetto regole dei criteri.

ResourceArray[PolicyV2]

Nome	Percorso	Tipo	Descrizione
value	value	array of PolicyV2

PolicyV2

Nome	Percorso	Tipo	Descrizione
nome	name	string
nome visualizzato	displayName	string
defaultConnectorsClassification	defaultConnectorsClassification	string
connectorGroups	connectorGroups	array of object
classificazione	connectorGroups.classification	string
dell'account di integrazione	connectorGroups.connectors	array of object
id	connectorGroups.connectors.id	string
nome	connectorGroups.connectors.name	string
type	connectorGroups.connectors.type	string
ambienteTipo	environmentType	string
environments	environments	array of object
id	environments.id	string
type	environments.type	string
nome	environments.name	string
id	createdBy.id	string
nome visualizzato	createdBy.displayName	string
Ora di creazione	createdTime	string
id	lastModifiedBy.id	string
nome visualizzato	lastModifiedBy.displayName	string
OraUltimaModifica	lastModifiedTime	string
isLegacySchemaVersion	isLegacySchemaVersion	boolean

ResourceArray[Ambiente]

Nome	Percorso	Tipo	Descrizione
value	value	array of Environment	Matrice di oggetti valore di ambiente.
Collegamento successivo	nextLink	string	URL per ottenere la pagina successiva dell'elenco Ambienti.

Ambiente

Oggetto Environment.

Nome	Percorso	Tipo	Descrizione
Documento d'identità	id	string	Campo ID ambiente.
TIPO	type	string	Campo Tipo di ambiente.
Nome	name	string	Campo Nome ambiente.
Posizione	location	string	Campo Percorso ambiente.
Hint per l'area di Azure	properties.azureRegionHint	string	Campo azureRegionHint dell'ambiente.
Nome visualizzato	properties.displayName	string	Nome visualizzato dell'ambiente.
Ora di creazione	properties.createdTime	date-time	Ora di creazione dell'ambiente.
Creato da	properties.createdBy	Principal[CreatedBy]	Criteri creati dall'oggetto principal.
OraUltimaModifica	properties.lastModifiedTime	date-time	Data e ora dell'ambiente lastModified.
Modificato da	properties.lastModifiedBy	Principal[ModifiedBy]	Criteri modificati dall'oggetto principal.
Stato provisioning	properties.provisioningState	string	ProvisioningState dell'ambiente.
capacity	properties.capacity	array of object
capacityType	properties.capacity.capacityType	string
actualConsumption	properties.capacity.actualConsumption	number
ratedConsumption	properties.capacity.ratedConsumption	number
capacityUnit	properties.capacity.capacityUnit	string
updatedOn	properties.capacity.updatedOn	string
addons	properties.addons	array of object
addonType	properties.addons.addonType	string
allocato	properties.addons.allocated	number
addonUnit	properties.addons.addonUnit	string
Tipo di creazione	properties.creationType	string	Tipo di creazione dell'ambiente.
Sku dell'ambiente	properties.environmentSku	string	ID SKU dell'ambiente.
Tipo di ambiente	properties.environmentType	string	Tipo di ambiente.
Impostazione predefinita	properties.isDefault	boolean	L'ambiente predefinito è o meno.
Piattaforma di app aziendali	properties.runtimeEndpoints.microsoft.BusinessAppPlatform	string	Endpoint di runtime BusinessAppPlatform.
Common Data Model	properties.runtimeEndpoints.microsoft.CommonDataModel	string	Endpoint di runtime CommonDataModel.
PowerApps	properties.runtimeEndpoints.microsoft.PowerApps	string	Endpoint di runtime di PowerApps.
Flusso	properties.runtimeEndpoints.microsoft.Flow	string	Endpoint di runtime del flusso.
Tempo eliminato temporaneamente	properties.softDeletedTime	date-time	SoftDeletedTime dell'ambiente.
TIPO	properties.linkedEnvironmentMetadata.type	string	Tipo Environment linkedEnvironmentMetadata.
ID risorsa	properties.linkedEnvironmentMetadata.resourceId	string	Environment linkedEnvironmentMetadata resourceId.
Nome amichevole	properties.linkedEnvironmentMetadata.friendlyName	string	Environment linkedEnvironmentMetadata friendlyName.
Nome univoco	properties.linkedEnvironmentMetadata.uniqueName	string	Environment linkedEnvironmentMetadata uniqueName.
Nome dominio	properties.linkedEnvironmentMetadata.domainName	string	Environment linkedEnvironmentMetadata domainName.
Versione	properties.linkedEnvironmentMetadata.version	string	Ambiente collegatoEnvironmentMetadata versione.
URL istanza	properties.linkedEnvironmentMetadata.instanceUrl	string	Environment linkedEnvironmentMetadata instanceUrl.
URL dell'API dell'istanza	properties.linkedEnvironmentMetadata.instanceApiUrl	string	Ambiente collegatoEnvironmentMetadata instanceApiUrl.
Lingua di base	properties.linkedEnvironmentMetadata.baseLanguage	integer	Environment linkedEnvironmentMetadata baseLanguage.
Stato dell'istanza	properties.linkedEnvironmentMetadata.instanceState	string	Environment linkedEnvironmentMetadata instanceState.
Ora di creazione	properties.linkedEnvironmentMetadata.createdTime	date-time	Environment linkedEnvironmentMetadata createdTime.
Ora modifica	properties.linkedEnvironmentMetadata.modifiedTime	date-time	Environment linkedEnvironmentMetadata modifiedTime.
Suffisso nome host	properties.linkedEnvironmentMetadata.hostNameSuffix	string	Environment linkedEnvironmentMetadata hostNameSuffix.
ID soluzione BAP	properties.linkedEnvironmentMetadata.bapSolutionId	string	Environment linkedEnvironmentMetadata bapSolutionId.
Modelli di creazione	properties.linkedEnvironmentMetadata.creationTemplates	array of string	Environment linkedEnvironmentMetadata creationTemplates.
Versione del pacchetto di gestione	properties.linkedEnvironmentMetadata.managementPackageVersion	string	Environment linkedEnvironmentMetadata managementPackageVersion.

PolicyEnvironments

Ambiente criteri.

Nome	Percorso	Tipo	Descrizione
Nome	name	string	Campo Nome ambiente criteri.
Documento d'identità	id	string	Campo ID ambiente criteri.
TIPO	type	string	Campo Tipo ambiente criteri.

PolicyRules

Oggetto regole dei criteri.

Nome	Percorso	Tipo	Descrizione
type	apiGroupRule.type	string	Tipo apiGroupRule della regola dei criteri.
apiGroup	apiGroupRule.parameters.apiGroup	string	ApiGroupRule parameter apiGroup.
Tipo di azione blocca	apiGroupRule.actions.blockAction.type	string	Tipo di azione Blocca, lasciare vuoto se non si desidera aggiungere un blocco.

PolicySchema

Definizione di Criteri API $schema.

Definizione di Criteri API $schema.

Versione schema

string

PolicyApiGroups

Nome	Percorso	Tipo	Descrizione
hbi	hbi	PolicyHbi	Gruppo Hbi criteri.
lbi	lbi	PolicyLbi

PolicyHbi

Gruppo Hbi criteri.

Nome	Percorso	Tipo	Descrizione
Descrizione dei dati business	description	string	Descrizione del gruppo di dati business dei criteri.
Dati business	apis	array of object	API dati business.
ID del connettore	apis.id	string	Campo ID connettore dati business.
Nome del connettore	apis.name	string	Campo nome connettore dati business.
Tipo connettore	apis.type	string	Campo tipo connettore dati business.

PolicyLbi

Nome	Percorso	Tipo	Descrizione
Descrizione dei dati non business	description	string	Descrizione del gruppo di dati non business.
Dati non aziendali	apis	array of object	API non business data.
ID del connettore	apis.id	string	Campo ID connettore non Business Data.
Nome del connettore	apis.name	string	Campo Nome connettore dati non business.
Tipo connettore	apis.type	string	Campo Tipo connettore dati non business.

PolicyDefaultApiGroup

Il raggruppamento di un nuovo connettore viene aggiunto automaticamente a.

Il raggruppamento di un nuovo connettore viene aggiunto automaticamente a.

Gruppo predefinito

string

ValidateDeleteResponse

Nome	Percorso	Tipo	Descrizione
Può eliminare	canInitiateDelete	boolean	È possibile eliminare l'ambiente.
Matrice errori	errors	array of object	Matrice errori
Codice	errors.error.code	string	Codice di errore per convalidare l'eliminazione.
Message	errors.error.message	string	Messaggio di errore.
resourcesToBeDeleted	resourcesToBeDeleted	array of object
Documento d'identità	resourcesToBeDeleted.id	string	Risorsa da eliminare.
Nome	resourcesToBeDeleted.name	string	Nome della risorsa da eliminare.
TIPO	resourcesToBeDeleted.type	string	Risorsa da eliminare.

ResourceArray[RoleAssignment]

Nome	Percorso	Tipo	Descrizione
value	value	array of object	Matrice di oggetti valore assegnazione ruolo ambiente.
id	value.id	string	Campo Environment Role Assignment ID (ID assegnazione ruolo ambiente).
type	value.type	string	Campo Tipo di assegnazione ruolo ambiente.
nome	value.name	string	Nome del campo Assegnazione ruolo ambiente.
scopo	value.properties.scope	string	Ambito dell'assegnazione di ruolo dell'ambiente.
id	value.properties.roleDefinition.id	string	Campo Role Assignment roleDefinition ID dell'ambiente.
type	value.properties.roleDefinition.type	string	Campo Ruolo assegnazione ruolo ambienteTipo di definizione.
nome	value.properties.roleDefinition.name	string	Ruolo assegnazione ruolo ambienteNome campo definizione.
id	value.properties.principal.id	string	ID oggetto dell'entità assegnazione ruolo dell'ambiente.
nome visualizzato	value.properties.principal.displayName	string	Entità assegnazione ruolo ambiente displayName.
posta elettronica	value.properties.principal.email	string	Posta elettronica dell'entità assegnazione ruolo ambiente.
type	value.properties.principal.type	string	Tipo di entità Assegnazione ruolo ambiente.

AssegnazioneRuolo

Nome	Percorso	Tipo	Descrizione
add	add	array of object	Aggiunta dell'oggetto Assegnazione ruolo ambiente.
id	add.roleAssignment.id	string	Campo Environment Role Assignment (Ruolo assegnazione ruolo Ambiente) Campo ID di assegnazione del ruolo.
type	add.roleAssignment.type	string	Campo Ruolo assegnazione ruolo ambienteAssignment.
nome	add.roleAssignment.name	string	Campo Nome assegnazione ruolo ambienteAssignment.
scopo	add.roleAssignment.properties.scope	string	Ambito dell'assegnazione di ruolo dell'ambiente.
id	add.roleAssignment.properties.roleDefinition.id	string	Campo Role Assignment roleDefinition ID dell'ambiente.
type	add.roleAssignment.properties.roleDefinition.type	string	Campo Role Assignment roleDefinition ID dell'ambiente.
nome	add.roleAssignment.properties.roleDefinition.name	string	Campo Nome assegnazione ruolo di ambienteImpostamento ruolo.
id	add.roleAssignment.properties.principal.id	string	ID oggetto dell'entità assegnazione ruolo dell'ambiente.
nome visualizzato	add.roleAssignment.properties.principal.displayName	string	Entità assegnazione ruolo ambiente displayName.
posta elettronica	add.roleAssignment.properties.principal.email	string	Posta elettronica dell'entità assegnazione ruolo ambiente.
type	add.roleAssignment.properties.principal.type	string	Tipo di entità Assegnazione ruolo ambiente.
httpStato	add.httpStatus	string	Environment Role Assignment httpStatus.

Principal[ModifiedBy]

Criteri modificati dall'oggetto principal.

Nome	Percorso	Tipo	Descrizione
Documento d'identità	id	string	Modificato dall'ID oggetto principal.
Nome visualizzato	displayName	string	Modificato da principal displayName.
Email	email	string	Modificato dall'entità.
TIPO	type	string	Modificato dal tipo principal.
ID del locatario	tenantId	string	Modificato dall'ID tenant dell'entità.
UPN	userPrincipalName	string	Modificato da userPrincipalName.

Principal[CreatedBy]

Criteri creati dall'oggetto principal.

Nome	Percorso	Tipo	Descrizione
Documento d'identità	id	string	ID oggetto dell'entità autore di Criteri API.
Nome visualizzato	displayName	string	Api Policy Creator principal displayName.
Email	email	string	Indirizzo di posta elettronica principale dell'autore di Criteri API.
TIPO	type	string	Tipo di entità autore di Criteri API.
ID del locatario	tenantId	string	ID tenant dell'entità di creazione di Criteri API.
UPN	userPrincipalName	string	Api Policy creator userPrincipalName.

Posizioni

Nome	Percorso	Tipo	Descrizione
value	value	array of object
Documento d'identità	value.id	string	ID posizione.
Nome	value.name	string	Nome posizione.
Nome visualizzato	value.properties.displayName	string	Nome visualizzato della posizione.
Impostazione predefinita	value.properties.isDefault	boolean	Percorso predefinito.
Disabilitato	value.properties.isDisabled	boolean	Percorso disabilitato.

Valute

Nome	Percorso	Tipo	Descrizione
value	value	array of object
Documento d'identità	value.id	string	ID valuta.
Nome	value.name	string	Nome valuta.
ID locale	value.properties.localeId	integer	ID delle impostazioni locali della valuta.
Nome localizzato	value.properties.localizedName	string	Nome localizzato della valuta.
Nome visualizzato	value.properties.displayName	string	Nome visualizzato valuta.

Languages

Nome	Percorso	Tipo	Descrizione
value	value	array of object
Nome	value.name	string	Campo Nome lingua.
Documento d'identità	value.id	string	Campo ID lingua.
TIPO	value.type	string	Campo Tipo di lingua.
ID locale	value.properties.localeId	integer	Campo ID delle impostazioni locali della lingua.
Nome localizzato	value.properties.localizedName	string	Campo Nome localizzato lingua.
Nome visualizzato	value.properties.displayName	string	Campo Nome visualizzato lingua.
Impostazione predefinita del tenant	value.properties.isTenantDefault	boolean	La lingua è il campo predefinito del tenant.

oggetto

Si tratta del tipo 'object'.