Freigeben über


Power Platform für Administratoren

Power Platform Management Connector bietet Zugriff auf Umgebungslebenszyklus-Verwaltungsfunktionen, DLP-Richtlinienverwaltung und andere Administratorfunktionen, die in der BAP-API bereitgestellt werden.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Norm Alle Power Automate-Regionen
Power Apps Norm Alle Power Apps-Regionen
Power Automate Norm Alle Power Automate-Regionen
Kontakt
Name Microsoft Power Apps-Unterstützung
URL https://powerapps.microsoft.com/en-us/support/
Connectormetadaten
Herausgeber Microsoft
Webseite https://admin.powerplatform.microsoft.com/
Datenschutzrichtlinie https://privacy.microsoft.com/en-us/privacystatement

Power Platform for Admins ist eine Connectorschnittstelle für den Zugriff auf die Business Applications Platform (BAP)-API, die zum Verwalten der administratorbezogenen Ressourcen der Power Platform verwendet wird – die gleiche API, die das Power Platform Admin Center betreibt. Dies umfasst die Verwaltung von Umgebungslebenszyklus und Berechtigungen, Dataverse-Bereitstellungsvorgänge, DLP-Richtlinien und Benutzersynchronisierung.

Voraussetzungen

Jeder Benutzer kann eine authentifizierte Microsoft Entra-ID mit diesem Connector erstellen, die Daten werden basierend auf dem Umfang des Benutzers zurückgegeben.

  • Power Platform-Dienstadministratoren haben Zugriff auf alle Ressourcen und Vorgänge, die in ihrem Mandanten von diesem Endpunkt aus verfügbar sind.
  • Umgebungsadministratoren haben nur Zugriff auf Daten und Vorgänge in ihren Umgebungen, DLP-Richtlinien, die sie verwalten oder davon betroffen sind.

Bekannte Probleme und Einschränkungen

  1. Übergeben Sie keinen Null- oder Blank()-Wert als API-Connectorgruppe (Array), wenn Sie eine DLP-Richtlinie erstellen oder aktualisieren, kann sie die Richtlinie unterbrechen und mit anderen unbeabsichtigten Folgen nicht mehr verwendet werden. Wenn die Gruppe keine Verbinder enthalten soll, übergeben Sie einen leeren Satz eckigen Klammern [ ].
  2. Die alten DLP-Vorgänge funktionieren nicht mit den aktualisierten blockierten DLP-Gruppen und sind veraltet. Verwenden Sie die V2-Versionen aller DLP-Vorgänge.
  3. DLP-Richtliniengruppen werden nicht automatisch mit Connectors aufgefüllt, daher müssen sie als Eingabeparameter abgerufen, formatiert und hinzugefügt werden:
    • Erstellen Sie eine Arrayvariable, um die Connectors zu speichern.
    • Speichern Sie die Standardumgebungs-ID des Mandanten in einer Variablen.
    • Verwenden Sie den Vorgang "GetConnectors " aus der Power Platform für App Maker, um alle Connectors für eine Umgebung abzurufen (verwenden Sie den Filter "environment eq '{environmentName}' ", wobei der Umgebungsname aus dem vorherigen Schritt stammt).
    • Verwenden Sie den Auswahlvorgang, um nur die Felder "ID", "Name" und "Typ" aus der GetConnectors-Antwort zu verwenden (verwenden Sie die letzte dynamische Inhaltsoption "Wert"). Platzieren Sie die ID, den Namen und geben Sie sie auf der linken Seite ein, und ordnen Sie die ID, den DisplayName und die Eingabe auf der rechten Seite der Auswahlaktion zu.
    • Speichern der Ausgabe von Select in der Arrayvariable
    • Fügen Sie diese hartcodierten Connectors an die Arrayvariable an (sie werden in der GetConnectors-Antwort nicht angezeigt):
      [
          {
            "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"
          }
      ]
      

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abrufen des Datenbankbereitstellungsstatus

Wird verwendet, um den Status eines Bereitstellungsvorgangs zu überprüfen.

Abrufen einer DLP-Richtlinie für die Umgebung

Gibt eine DLP-Richtlinie für die Umgebung zurück.

Abrufen einer Mandanten-DLP-Richtlinie

Gibt eine Mandanten-DLP-Richtlinie zurück.

Abrufen von DLP-Richtlinie V2

Gibt eine DLP-Richtlinie zurück.

Aktualisieren der DLP-Richtlinie V2

Aktualisiert eine DLP-Richtlinie.

Aktualisieren der Mandanten-DLP-Richtlinie

Aktualisiert die Felder in einer DLP-Richtlinie.

Aktualisieren der Umgebung

Aktualisiert die Eigenschaften einer Umgebung.

Aufheben der Blockierung von Verbindern auflisten

Gibt eine Liste von Connectors zurück, die nicht mit einer DLP-Richtlinie blockiert werden können.

CdS-Bereitstellungsstatus abrufen

Wird verwendet, um den Status eines Bereitstellungsvorgangs zu überprüfen.

DLP-Richtlinie für Die Umgebung löschen

Löscht eine DLP-Umgebungsrichtlinie.

DLP-Richtlinie für die Updateumgebung

Aktualisiert eine DLP-Richtlinie für die Umgebung.

DLP-Richtlinie V2 löschen

Löscht eine DLP-Richtlinie.

DLP-Richtlinien auflisten

Gibt eine Liste aller DLP-Richtlinien für Mandanten und Umgebungen zurück.

DLP-Richtlinien auflisten V2

Gibt eine Liste aller DLP-Richtlinien zurück, auf die das Konto zugreifen kann.

Erstellen der Umgebung

Erstellt eine neue Umgebung.

Erstellen einer CDS-Datenbank

Erstellt eine neue CDS-Instanz in der angegebenen Umgebung.

Erstellen einer DLP-Richtlinie für die Umgebung

Erstellt eine DLP-Richtlinie für die Umgebung.

Erstellen einer DLP-Richtlinie V2

Erstellt eine neue DLP-Richtlinie.

Erstellen einer Mandanten-DLP-Richtlinie

Erstellt eine neue Mandanten-DLP-Richtlinie.

Erzwingen des Synchronisierungsbenutzers

Wird verwendet, um PowerApps-Benutzer mit CRM zu synchronisieren.

Lebenszyklusvorgangsstatus abrufen

Gibt den aktuellen Status des Lebenszyklusvorgangs zurück, der nach einem Umgebungspatch auftritt.

Löschen der Umgebung

Löscht eine Umgebung.

Löschen einer Mandanten-DLP-Richtlinie

Löscht eine Mandanten-DLP-Richtlinie.

Rollenzuweisungen für Listenumgebung

Gibt eine Liste der Berechtigungen für eine Umgebung ohne CDS für Apps zurück.

Umgebung als Administrator abrufen

Gibt eine einzelne Umgebung als Administrator zurück.

Umgebungen als Administrator auflisten

Gibt eine Liste von Umgebungen zurück.

Umgebungsrollenzuweisung bearbeiten

Legt Berechtigungen für eine Umgebung fest.

Umgebungsvorgangsstatus abrufen (Vorschau)

Wird verwendet, um den Status eines Umgebungsvorgangs zu überprüfen, der als Löschvorgang ausgeführt wird.

Unterstützte Speicherorte auflisten

Gibt eine Liste der Speicherorte zurück, an denen der BAP-Dienst unterstützt wird.

Unterstützte Umgebungssprachen auflisten

Gibt eine Liste der unterstützten Sprachen basierend auf dem Speicherort zurück.

Unterstützte Umgebungswährungen auflisten

Gibt eine Liste der unterstützten Währungen basierend auf dem Standort zurück.

Virtuelle Connectors auflisten

Gibt eine Liste der virtuellen Connectors zurück.

Überprüfen der Umgebungslöschung

Wird verwendet, um zu überprüfen, ob eine Umgebung gelöscht werden kann.

Abrufen des Datenbankbereitstellungsstatus

Wird verwendet, um den Status eines Bereitstellungsvorgangs zu überprüfen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

Operation
operationName True string

Der Name des Vorgangs. Dieser gesamte URI wird als Speicherortheader von /provisionInstance zurückgegeben und enthält diesen Wert.

API-Version
api-version string

Der Datumswert der API.

Abrufen einer DLP-Richtlinie für die Umgebung

Gibt eine DLP-Richtlinie für die Umgebung zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

Policy
policy True string

Das Namensfeld der Richtlinie.

API-Version
api-version string

Der Datumswert der API.

Gibt zurück

Body
Policy

Abrufen einer Mandanten-DLP-Richtlinie

Gibt eine Mandanten-DLP-Richtlinie zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Policy
policy True string

Das Namensfeld der Richtlinie.

API-Version
api-version string

Der Datumswert der API.

Gibt zurück

Body
Policy

Abrufen von DLP-Richtlinie V2

Gibt eine DLP-Richtlinie zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Policy
policy True string

Das Namensfeld der Richtlinie.

Gibt zurück

Body
PolicyV2

Aktualisieren der DLP-Richtlinie V2

Aktualisiert eine DLP-Richtlinie.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Policy
policy True string

Das Namensfeld der Richtlinie.

API-Version
api-version string

Der Datumswert der API.

Anzeigename
displayName string
Standardkonnektorenklassifizierung
defaultConnectorsClassification string
classification
classification True string
id
id True string
type
type True string
name
name True string
Richtlinienumgebungstyp
environmentType string
id
id True string
type
type True string
name
name True string

Gibt zurück

Body
PolicyV2

Aktualisieren der Mandanten-DLP-Richtlinie

Aktualisiert die Felder in einer DLP-Richtlinie.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Policy
policy True string

Das Namensfeld der Richtlinie.

API-Version
api-version string

Der Datumswert der API.

Anzeigename
displayName True string

Anzeigename der API-Richtlinie.

Schemaversion
$schema True string

Api-Richtliniendefinition $schema.

Einschränkungstyp
type True string

Geben Sie den Richtlinieneinschränkungstyp leer, um die Richtlinie auf alle Umgebungen anzuwenden.

Name
name True string

Feld "Richtlinienumgebungsname".

ID
id True string

Feld "Richtlinienumgebungs-ID".

Typ
type True string

Feld "Richtlinienumgebungstyp".

Umgebungsfiltertyp
filterType True string

Api Policy constraint environmentFilter1 parameter filterType.

Beschreibung von Geschäftsdaten
description string

Beschreibung der Geschäftsdatengruppe für Richtlinien.

Konnektor-ID
id string

Geschäftsdaten-Connector-ID-Feld.

Konnektorname
name string

Feld "Geschäftsdatenconnectorname".

Connectortyp
type string

Feld "Geschäftsdatenkonnektortyp".

Beschreibung von Nicht-Geschäftsdaten
description string

Beschreibung der Nicht-Geschäftsdatengruppe für Richtlinien.

Konnektor-ID
id string

Feld "Nicht geschäftsdatenkonnektor-ID".

Konnektorname
name string

Name-Feld für Nicht-Geschäftsdatenkonnektor.

Connectortyp
type string

Feld "Nicht geschäftsdatenkonnektortyp"

Standardgruppe
defaultApiGroup True string

Gruppieren Sie automatisch einen neuen Connector.

type
type True string

Richtlinienregel-APIGroupRule-Typ.

apiGruppe
apiGroup True string

ApiGroupRule-Parameter "ApiGroup" für Richtlinienregel.

Blockaktionstyp
type True string

Blockaktionstyp, leer lassen, wenn das Hinzufügen eines Blocks nicht gewünscht ist.

Gibt zurück

Body
Policy

Aktualisieren der Umgebung

Aktualisiert die Eigenschaften einer Umgebung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

API-Version
api-version string

Der Datumswert der API.

Beschreibung
description string
Anzeigename
displayName string
securityGroupId (englisch)
securityGroupId string

Aufheben der Blockierung von Verbindern auflisten

Gibt eine Liste von Connectors zurück, die nicht mit einer DLP-Richtlinie blockiert werden können.

Gibt zurück

Name Pfad Typ Beschreibung
array of object
id
id string
entsperrbar
metadata.unblockable boolean

CdS-Bereitstellungsstatus abrufen

Wird verwendet, um den Status eines Bereitstellungsvorgangs zu überprüfen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

Operation
operationName True string

Name des Vorgangs.

API-Version
api-version string

Der Datumswert der API.

DLP-Richtlinie für Die Umgebung löschen

Löscht eine DLP-Umgebungsrichtlinie.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

Policy
policy True string

Das Namensfeld der Richtlinie.

API-Version
api-version string

Der Datumswert der API.

Gibt zurück

response
object

DLP-Richtlinie für die Updateumgebung

Aktualisiert eine DLP-Richtlinie für die Umgebung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

Policy
policy True string

Das Namensfeld der Richtlinie.

API-Version
api-version string

Der Datumswert der API.

Anzeigename
displayName True string

Anzeigename der API-Richtlinie.

Schemaversion
$schema True string

Api-Richtliniendefinition $schema.

Name
name True string

Feld "Richtlinienumgebungsname".

ID
id True string

Feld "Richtlinienumgebungs-ID".

Typ
type True string

Feld "Richtlinienumgebungstyp".

Beschreibung von Geschäftsdaten
description string

Beschreibung der Geschäftsdatengruppe für Richtlinien.

Konnektor-ID
id string

Geschäftsdaten-Connector-ID-Feld.

Konnektorname
name string

Feld "Geschäftsdatenconnectorname".

Connectortyp
type string

Feld "Geschäftsdatenkonnektortyp".

Beschreibung von Nicht-Geschäftsdaten
description string

Beschreibung der Nicht-Geschäftsdatengruppe für Richtlinien.

Konnektor-ID
id string

Feld "Nicht geschäftsdatenkonnektor-ID".

Konnektorname
name string

Name-Feld für Nicht-Geschäftsdatenkonnektor.

Connectortyp
type string

Feld "Nicht geschäftsdatenkonnektortyp"

Standardgruppe
defaultApiGroup True string

Gruppieren Sie automatisch einen neuen Connector.

type
type True string

Richtlinienregel-APIGroupRule-Typ.

apiGruppe
apiGroup True string

ApiGroupRule-Parameter "ApiGroup" für Richtlinienregel.

Blockaktionstyp
type True string

Blockaktionstyp, leer lassen, wenn das Hinzufügen eines Blocks nicht gewünscht ist.

Gibt zurück

Body
Policy

DLP-Richtlinie V2 löschen

Löscht eine DLP-Richtlinie.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Policy
policy True string

Das Namensfeld der Richtlinie.

Gibt zurück

response
object

DLP-Richtlinien auflisten

Gibt eine Liste aller DLP-Richtlinien für Mandanten und Umgebungen zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
API-Version
api-version string

Der Datumswert der API.

Gibt zurück

DLP-Richtlinien auflisten V2

Gibt eine Liste aller DLP-Richtlinien zurück, auf die das Konto zugreifen kann.

Gibt zurück

Erstellen der Umgebung

Erstellt eine neue Umgebung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
API-Version
api-version True string

Der Datumswert der API.

Standort
location True string

Region, in der die Umgebung bereitgestellt wird.

Anzeigename
displayName True string

Vanity-Name der Umgebung.

Umgebungs-Sku
environmentSku True string

Typ der Umgebung.

Gibt zurück

Environment-Objekt.

Erstellen einer CDS-Datenbank

Erstellt eine neue CDS-Instanz in der angegebenen Umgebung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

Basissprache
baseLanguage integer

Jede Sprache, die von Listenumgebungssprachen zurückgegeben wird.

Währungscode
code string

Jeder Währungscode, der von "Währungen der Listenumgebung" zurückgegeben wird.

Vorlagen
templates array of string

Überprüfte Liste der CRM-Vorlagen, die an den Bereitstellungsaufruf übergeben werden sollen.

Gibt zurück

Environment-Objekt.

Erstellen einer DLP-Richtlinie für die Umgebung

Erstellt eine DLP-Richtlinie für die Umgebung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
API-Version
api-version string

Der Datumswert der API.

Umwelt
environment True string

Name der Umgebung.

Anzeigename
displayName True string

Anzeigename der API-Richtlinie.

Schemaversion
$schema True string

Api-Richtliniendefinition $schema.

Name
name True string

Feld "Richtlinienumgebungsname".

ID
id True string

Feld "Richtlinienumgebungs-ID".

Typ
type True string

Feld "Richtlinienumgebungstyp".

Beschreibung von Geschäftsdaten
description string

Beschreibung der Geschäftsdatengruppe für Richtlinien.

Konnektor-ID
id string

Geschäftsdaten-Connector-ID-Feld.

Konnektorname
name string

Feld "Geschäftsdatenconnectorname".

Connectortyp
type string

Feld "Geschäftsdatenkonnektortyp".

Beschreibung von Nicht-Geschäftsdaten
description string

Beschreibung der Nicht-Geschäftsdatengruppe für Richtlinien.

Konnektor-ID
id string

Feld "Nicht geschäftsdatenkonnektor-ID".

Konnektorname
name string

Name-Feld für Nicht-Geschäftsdatenkonnektor.

Connectortyp
type string

Feld "Nicht geschäftsdatenkonnektortyp"

Standardgruppe
defaultApiGroup True string

Gruppieren Sie automatisch einen neuen Connector.

type
type True string

Richtlinienregel-APIGroupRule-Typ.

apiGruppe
apiGroup True string

ApiGroupRule-Parameter "ApiGroup" für Richtlinienregel.

Blockaktionstyp
type True string

Blockaktionstyp, leer lassen, wenn das Hinzufügen eines Blocks nicht gewünscht ist.

Gibt zurück

Body
Policy

Erstellen einer DLP-Richtlinie V2

Erstellt eine neue DLP-Richtlinie.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anzeigename
displayName string
Standardkonnektorenklassifizierung
defaultConnectorsClassification string
classification
classification True string
id
id True string
type
type True string
name
name True string
Richtlinienumgebungstyp
environmentType string
id
id True string
type
type True string
name
name True string

Gibt zurück

Body
PolicyV2

Erstellen einer Mandanten-DLP-Richtlinie

Erstellt eine neue Mandanten-DLP-Richtlinie.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
API-Version
api-version string

Der Datumswert der API.

Anzeigename
displayName True string

Anzeigename der API-Richtlinie.

Schemaversion
$schema True string

Api-Richtliniendefinition $schema.

Einschränkungstyp
type True string

Geben Sie den Richtlinieneinschränkungstyp leer, um die Richtlinie auf alle Umgebungen anzuwenden.

Name
name True string

Feld "Richtlinienumgebungsname".

ID
id True string

Feld "Richtlinienumgebungs-ID".

Typ
type True string

Feld "Richtlinienumgebungstyp".

Umgebungsfiltertyp
filterType True string

Api Policy constraint environmentFilter1 parameter filterType.

Beschreibung von Geschäftsdaten
description string

Beschreibung der Geschäftsdatengruppe für Richtlinien.

Konnektor-ID
id string

Geschäftsdaten-Connector-ID-Feld.

Konnektorname
name string

Feld "Geschäftsdatenconnectorname".

Connectortyp
type string

Feld "Geschäftsdatenkonnektortyp".

Beschreibung von Nicht-Geschäftsdaten
description string

Beschreibung der Nicht-Geschäftsdatengruppe für Richtlinien.

Konnektor-ID
id string

Feld "Nicht geschäftsdatenkonnektor-ID".

Konnektorname
name string

Name-Feld für Nicht-Geschäftsdatenkonnektor.

Connectortyp
type string

Feld "Nicht geschäftsdatenkonnektortyp"

Standardgruppe
defaultApiGroup True string

Gruppieren Sie automatisch einen neuen Connector.

type
type True string

Richtlinienregel-APIGroupRule-Typ.

apiGruppe
apiGroup True string

ApiGroupRule-Parameter "ApiGroup" für Richtlinienregel.

Blockaktionstyp
type True string

Blockaktionstyp, leer lassen, wenn das Hinzufügen eines Blocks nicht gewünscht ist.

Gibt zurück

Body
Policy

Erzwingen des Synchronisierungsbenutzers

Wird verwendet, um PowerApps-Benutzer mit CRM zu synchronisieren.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

Objekt-ID
ObjectId True string

Benutzerobjekt-ID.

API-Version
api-version string

Der Datumswert der API.

Lebenszyklusvorgangsstatus abrufen

Gibt den aktuellen Status des Lebenszyklusvorgangs zurück, der nach einem Umgebungspatch auftritt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Lebenszyklusvorgang
lifecycleOperationId True string

Die ID des Lebenszyklusvorgangs.

API-Version
api-version string

Der Datumswert der API.

Löschen der Umgebung

Löscht eine Umgebung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

API-Version
api-version string

Der Datumswert der API.

Gibt zurück

response
object

Löschen einer Mandanten-DLP-Richtlinie

Löscht eine Mandanten-DLP-Richtlinie.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Policy
policy True string

Das Namensfeld der Richtlinie.

API-Version
api-version string

Der Datumswert der API.

Gibt zurück

response
object

Rollenzuweisungen für Listenumgebung

Gibt eine Liste der Berechtigungen für eine Umgebung ohne CDS für Apps zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

API-Version
api-version string

Der Datumswert der API.

Gibt zurück

Umgebung als Administrator abrufen

Gibt eine einzelne Umgebung als Administrator zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

API-Version
api-version string

Der Datumswert der API.

Gibt zurück

Environment-Objekt.

Umgebungen als Administrator auflisten

Gibt eine Liste von Umgebungen zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
API-Version
api-version string

Der Datumswert der API.

Token überspringen
$skiptoken string

Die Eingabe, die zum Abrufen der nächsten Seite der Antwort verwendet wird.

Seitenformat
$top integer

Anzahl der Umgebungen in der Antwort.

Erweitern von Eigenschaften
$expand string

Ermöglicht den Zugriff auf das Erweitern von Antworteigenschaften.

Gibt zurück

Umgebungsrollenzuweisung bearbeiten

Legt Berechtigungen für eine Umgebung fest.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

API-Version
api-version string

Der Datumswert der API.

Prinzipal-E-Mail
email string

Die Haupt-E-Mail des Benutzers.

Prinzipalmandanten-ID
tenantId string

Die Prinzipalmandanten-ID des Benutzers.

Principal-Objekt-ID
id string

Die Prinzipalobjekt-ID des Benutzers.

Prinzipaltyp
type string

Der Haupttyp des Benutzers.

Rollendefinitions-ID
id string

Die Rollendefinitions-ID. Format: /providers/Microsoft.BusinessAppPlatform/scopes/admin/environments/{environment}/{roleName}.

id
id string

Das ID-Feld.

Gibt zurück

Umgebungsvorgangsstatus abrufen (Vorschau)

Wird verwendet, um den Status eines Umgebungsvorgangs zu überprüfen, der als Löschvorgang ausgeführt wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

Operation
operationName True string

Name des Vorgangs.

API-Version
api-version string

Der Datumswert der API.

Unterstützte Speicherorte auflisten

Gibt eine Liste der Speicherorte zurück, an denen der BAP-Dienst unterstützt wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
API-Version
api-version string

Der Datumswert der API.

Gibt zurück

Body
Locations

Unterstützte Umgebungssprachen auflisten

Gibt eine Liste der unterstützten Sprachen basierend auf dem Speicherort zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
environmentLocation True string

Der Standort der Umgebung.

API-Version
api-version string

Der Datumswert der API.

Gibt zurück

Body
Languages

Unterstützte Umgebungswährungen auflisten

Gibt eine Liste der unterstützten Währungen basierend auf dem Standort zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Standort
environmentLocation True string

Der Standort der Umgebung.

API-Version
api-version string

Der Datumswert der API.

Gibt zurück

Body
Currencies

Virtuelle Connectors auflisten

Gibt eine Liste der virtuellen Connectors zurück.

Gibt zurück

Name Pfad Typ Beschreibung
array of object
id
id string
virtualConnector
metadata.virtualConnector boolean
name
metadata.name string
type
metadata.type string
iconUri
metadata.iconUri string
Anzeigename
metadata.displayName string

Überprüfen der Umgebungslöschung

Wird verwendet, um zu überprüfen, ob eine Umgebung gelöscht werden kann.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
environment True string

Name der Umgebung.

API-Version
api-version string

Der Datumswert der API.

Gibt zurück

Definitionen

ResourceArray[Policy]

Name Pfad Typ Beschreibung
value
value array of Policy

Policy

Name Pfad Typ Beschreibung
Richtlinien-ID
id string

Feld "Richtlinien-ID".

Richtlinientyp
type string

Feld "Richtlinientyp".

Richtlinienname
name string

Feld "Richtlinienname".

Anzeigename
properties.displayName string

Anzeigename der API-Richtlinie.

Erstellte Zeit
properties.createdTime date-time

Api-Richtlinie erstellt Zeit.

Erstellt von
properties.createdBy Principal[CreatedBy]

Vom Prinzipalobjekt erstellte Richtlinie.

Geänderte Zeit
properties.lastModifiedTime date-time

Änderungszeit der API-Richtlinie.

Geändert von
properties.lastModifiedBy Principal[ModifiedBy]

Vom Prinzipalobjekt geänderte Richtlinie.

Schemaversion
properties.definition.$schema PolicySchema

Api-Richtliniendefinition $schema.

Typ
properties.definition.constraints.environmentFilter1.type string

Policy environmentFilter-Typ.

Environments
properties.definition.constraints.environmentFilter1.parameters.environments PolicyEnvironments

Richtlinienumgebung.

Filtertyp
properties.definition.constraints.environmentFilter1.parameters.filterType string

Api Policy constraint environmentFilter1 parameter filterType.

apiGroups
properties.definition.apiGroups PolicyApiGroups
Standardgruppe
properties.definition.defaultApiGroup PolicyDefaultApiGroup

Gruppieren Sie automatisch einen neuen Connector.

Regeln
properties.definition.rules PolicyRules

Richtlinienregelnobjekt.

ResourceArray[PolicyV2]

Name Pfad Typ Beschreibung
value
value array of PolicyV2

PolicyV2

Name Pfad Typ Beschreibung
name
name string
Anzeigename
displayName string
defaultConnectorsClassification
defaultConnectorsClassification string
connectorGroups
connectorGroups array of object
classification
connectorGroups.classification string
connectors
connectorGroups.connectors array of object
id
connectorGroups.connectors.id string
name
connectorGroups.connectors.name string
type
connectorGroups.connectors.type string
Umgebungstyp
environmentType string
environments
environments array of object
id
environments.id string
type
environments.type string
name
environments.name string
id
createdBy.id string
Anzeigename
createdBy.displayName string
createdTime
createdTime string
id
lastModifiedBy.id string
Anzeigename
lastModifiedBy.displayName string
lastModifiedTime
lastModifiedTime string
isLegacySchemaVersion
isLegacySchemaVersion boolean

ResourceArray[Umgebung]

Name Pfad Typ Beschreibung
value
value array of Environment

Umgebungswertobjektarray.

Nächster Link
nextLink string

Die URL zum Abrufen der nächsten Seite der Liste "Umgebungen".

Umwelt

Environment-Objekt.

Name Pfad Typ Beschreibung
ID
id string

Umgebungs-ID-Feld.

Typ
type string

Umgebungstypfeld.

Name
name string

Feld "Umgebungsname".

Standort
location string

Umgebungsstandortfeld.

Azure Region Hint
properties.azureRegionHint string

Umgebung azureRegionHint field.

Anzeigename
properties.displayName string

Anzeigename der Umgebung.

Erstellungszeit
properties.createdTime date-time

Erstellungszeit der Umgebung.

Erstellt von
properties.createdBy Principal[CreatedBy]

Vom Prinzipalobjekt erstellte Richtlinie.

lastModifiedTime
properties.lastModifiedTime date-time

Datum und Uhrzeit der umgebung lastModified.

Geändert von
properties.lastModifiedBy Principal[ModifiedBy]

Vom Prinzipalobjekt geänderte Richtlinie.

Bereitstellungsstatus
properties.provisioningState string

Bereitstellungsstatus der Umgebung.

capacity
properties.capacity array of object
capacityType (Kapazität)
properties.capacity.capacityType string
actualConsumtion
properties.capacity.actualConsumption number
ratingConvermutung
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
zugewiesen
properties.addons.allocated number
addonUnit
properties.addons.addonUnit string
Erstellungstyp
properties.creationType string

Erstellungstyp der Umgebung.

Umgebungs-Sku
properties.environmentSku string

Sku-ID der Umgebung.

Umgebungstyp
properties.environmentType string

Typ der Umgebung.

Ist Standard
properties.isDefault boolean

Ist Die Standardumgebung oder nicht.

Business App Platform
properties.runtimeEndpoints.microsoft.BusinessAppPlatform string

BusinessAppPlatform-Laufzeitendpunkt.

Common Data Model
properties.runtimeEndpoints.microsoft.CommonDataModel string

CommonDataModel-Laufzeitendpunkt.

PowerApps
properties.runtimeEndpoints.microsoft.PowerApps string

PowerApps-Laufzeitendpunkt.

Flow
properties.runtimeEndpoints.microsoft.Flow string

Ablauflaufzeitendpunkt.

Vorläufig gelöschte Zeit
properties.softDeletedTime date-time

Environment softDeletedTime.

Typ
properties.linkedEnvironmentMetadata.type string

Environment linkedEnvironmentMetadata-Typ.

Ressourcen-ID
properties.linkedEnvironmentMetadata.resourceId string

Environment linkedEnvironmentMetadata resourceId.

Freundlicher Name
properties.linkedEnvironmentMetadata.friendlyName string

Environment linkedEnvironmentMetadata friendlyName.

Eindeutiger Name
properties.linkedEnvironmentMetadata.uniqueName string

Environment linkedEnvironmentMetadata uniqueName.

Domänenname
properties.linkedEnvironmentMetadata.domainName string

Environment linkedEnvironmentMetadata domainName.

Version
properties.linkedEnvironmentMetadata.version string

Environment linkedEnvironmentMetadata-Version.

Instanz-URL
properties.linkedEnvironmentMetadata.instanceUrl string

Environment linkedEnvironmentMetadata instanceUrl.

Instanz-API-URL
properties.linkedEnvironmentMetadata.instanceApiUrl string

Environment linkedEnvironmentMetadata instanceApiUrl.

Ausgangssprache
properties.linkedEnvironmentMetadata.baseLanguage integer

Environment linkedEnvironmentMetadata baseLanguage.

Status der Instanz
properties.linkedEnvironmentMetadata.instanceState string

Environment linkedEnvironmentMetadata instanceState.

Erstellungszeit
properties.linkedEnvironmentMetadata.createdTime date-time

Environment linkedEnvironmentMetadata createdTime.

Änderungszeit
properties.linkedEnvironmentMetadata.modifiedTime date-time

Environment linkedEnvironmentMetadata modifiedTime.

Hostnamensuffix
properties.linkedEnvironmentMetadata.hostNameSuffix string

Environment linkedEnvironmentMetadata hostNameSuffix.

BAP-Lösungs-ID
properties.linkedEnvironmentMetadata.bapSolutionId string

Environment linkedEnvironmentMetadata bapSolutionId.

Erstellungsvorlagen
properties.linkedEnvironmentMetadata.creationTemplates array of string

Environment linkedEnvironmentMetadata creationTemplates.

Verwaltungspaketversion
properties.linkedEnvironmentMetadata.managementPackageVersion string

Environment linkedEnvironmentMetadata managementPackageVersion.

PolicyEnvironments

Richtlinienumgebung.

Name Pfad Typ Beschreibung
Name
name string

Feld "Richtlinienumgebungsname".

ID
id string

Feld "Richtlinienumgebungs-ID".

Typ
type string

Feld "Richtlinienumgebungstyp".

PolicyRules

Richtlinienregelnobjekt.

Name Pfad Typ Beschreibung
type
apiGroupRule.type string

Richtlinienregel-APIGroupRule-Typ.

apiGruppe
apiGroupRule.parameters.apiGroup string

ApiGroupRule-Parameter "ApiGroup" für Richtlinienregel.

Blockaktionstyp
apiGroupRule.actions.blockAction.type string

Blockaktionstyp, leer lassen, wenn das Hinzufügen eines Blocks nicht gewünscht ist.

PolicySchema

Api-Richtliniendefinition $schema.

Api-Richtliniendefinition $schema.

Schemaversion
string

PolicyApiGroups

Name Pfad Typ Beschreibung
hbi
hbi PolicyHbi

Richtlinie Hbi-Gruppe.

lbi
lbi PolicyLbi

PolicyHbi

Richtlinie Hbi-Gruppe.

Name Pfad Typ Beschreibung
Beschreibung von Geschäftsdaten
description string

Beschreibung der Geschäftsdatengruppe für Richtlinien.

Geschäftsdaten
apis array of object

Geschäftsdaten-APIs.

Konnektor-ID
apis.id string

Geschäftsdaten-Connector-ID-Feld.

Konnektorname
apis.name string

Feld "Geschäftsdatenconnectorname".

Connectortyp
apis.type string

Feld "Geschäftsdatenkonnektortyp".

PolicyLbi

Name Pfad Typ Beschreibung
Beschreibung von Nicht-Geschäftsdaten
description string

Beschreibung der Nicht-Geschäftsdatengruppe für Richtlinien.

Nicht geschäftsrelevante Daten
apis array of object

Nicht geschäftsdaten-APIs.

Konnektor-ID
apis.id string

Feld "Nicht geschäftsdatenkonnektor-ID".

Konnektorname
apis.name string

Name-Feld für Nicht-Geschäftsdatenkonnektor.

Connectortyp
apis.type string

Feld "Nicht geschäftsdatenkonnektortyp"

PolicyDefaultApiGroup

Gruppieren Sie automatisch einen neuen Connector.

Gruppieren Sie automatisch einen neuen Connector.

Standardgruppe
string

ValidateDeleteResponse

Name Pfad Typ Beschreibung
Kann löschen
canInitiateDelete boolean

Umgebung kann gelöscht werden.

Fehlerarray
errors array of object

Fehlerarray

Code
errors.error.code string

Fehlercode zum Überprüfen des Löschens.

Nachricht
errors.error.message string

Fehlermeldung.

resourcesToBeDeleted
resourcesToBeDeleted array of object
ID
resourcesToBeDeleted.id string

Zu löschende Ressource.

Name
resourcesToBeDeleted.name string

Ressource, die gelöscht werden soll.

Typ
resourcesToBeDeleted.type string

Ressource, die gelöscht werden soll.

ResourceArray[RoleAssignment]

Name Pfad Typ Beschreibung
value
value array of object

Objektarray für die Umgebungsrollenzuweisung.

id
value.id string

Umgebung Rollenzuweisungs-ID-Feld.

type
value.type string

Feld "Umgebungsrollenzuweisung".

name
value.name string

Name des Felds "Umgebungsrollenzuweisung".

scope
value.properties.scope string

Bereich "Umgebungsrollenzuweisung".

id
value.properties.roleDefinition.id string

Role Assignment-ID-Feld "Environment Role Assignment".

type
value.properties.roleDefinition.type string

Role Assignment-Feld "Environment Role Assignment" (Rollenzuweisungstyp).

name
value.properties.roleDefinition.name string

Name des Felds "Role Assignment" der Umgebungsrolledefinition.

id
value.properties.principal.id string

Id des Prinzipals der Umgebungsrollenzuweisung.

Anzeigename
value.properties.principal.displayName string

DisplayName der Umgebungsrollenzuweisung.

E-Mail
value.properties.principal.email string

E-Mail für die Umgebungsrollenzuweisung.

type
value.properties.principal.type string

Haupttyp der Umgebungsrollenzuweisung.

Rollenvergabe

Name Pfad Typ Beschreibung
add
add array of object

Umgebung Rollenzuweisungsobjekt hinzufügen.

id
add.roleAssignment.id string

Feld "Role Assignment roleAssignment ID" der Umgebungsrolle.

type
add.roleAssignment.type string

Feld "Role Assignment roleAssignment" für die Umgebungsrolle.

name
add.roleAssignment.name string

Namefeld 'Role Assignment' für die Umgebungsrolle'.

scope
add.roleAssignment.properties.scope string

Bereich "Umgebungsrollenzuweisung".

id
add.roleAssignment.properties.roleDefinition.id string

Role Assignment-ID-Feld "Environment Role Assignment".

type
add.roleAssignment.properties.roleDefinition.type string

Role Assignment-ID-Feld "Environment Role Assignment".

name
add.roleAssignment.properties.roleDefinition.name string

Namefeld 'Role Assignment' für die Umgebungsrolledefinition.

id
add.roleAssignment.properties.principal.id string

Id des Prinzipals der Umgebungsrollenzuweisung.

Anzeigename
add.roleAssignment.properties.principal.displayName string

DisplayName der Umgebungsrollenzuweisung.

E-Mail
add.roleAssignment.properties.principal.email string

E-Mail für die Umgebungsrollenzuweisung.

type
add.roleAssignment.properties.principal.type string

Haupttyp der Umgebungsrollenzuweisung.

httpStatus (Englisch)
add.httpStatus string

Umgebungsrollenzuweisung httpStatus.

Principal[ModifiedBy]

Vom Prinzipalobjekt geänderte Richtlinie.

Name Pfad Typ Beschreibung
ID
id string

Geändert durch Prinzipalobjekt-ID.

Anzeigename
displayName string

Vom Prinzipal "displayName" geändert.

Email
email string

Vom Prinzipal geändert.

Typ
type string

Vom Prinzipaltyp geändert.

Mieter-ID
tenantId string

Geändert durch Prinzipalmandanten-ID.

UPN
userPrincipalName string

Geändert von userPrincipalName.

Principal[CreatedBy]

Vom Prinzipalobjekt erstellte Richtlinie.

Name Pfad Typ Beschreibung
ID
id string

API-Richtlinienersteller-Prinzipalobjekt-ID.

Anzeigename
displayName string

Api Policy Creator principal displayName.

Email
email string

Api-Richtlinienersteller-Prinzipal-E-Mail.

Typ
type string

Api-Richtlinienerstellerprinzipaltyp.

Mieter-ID
tenantId string

Api-Richtlinienersteller-Prinzipalmandanten-ID.

UPN
userPrincipalName string

Api-Richtlinienersteller userPrincipalName.

Standorte

Name Pfad Typ Beschreibung
value
value array of object
ID
value.id string

Standort-ID.

Name
value.name string

Name des Speicherorts.

Anzeigename
value.properties.displayName string

Anzeigename des Speicherorts.

Ist Standard
value.properties.isDefault boolean

Ist der Standardspeicherort.

Ist deaktiviert
value.properties.isDisabled boolean

Der Speicherort ist deaktiviert.

Währungen

Name Pfad Typ Beschreibung
value
value array of object
ID
value.id string

Währungs-ID.

Name
value.name string

Währungsname.

Gebietsschema-ID
value.properties.localeId integer

Gebietsschema-ID der Währung.

Lokalisierter Name
value.properties.localizedName string

Lokalisierter Name der Währung.

Anzeigename
value.properties.displayName string

Anzeigename der Währung.

Sprachen

Name Pfad Typ Beschreibung
value
value array of object
Name
value.name string

Feld "Sprachname".

ID
value.id string

Sprach-ID-Feld.

Typ
value.type string

Feld "Sprachtyp".

Gebietsschema-ID
value.properties.localeId integer

Gebietsschema-ID-Feld der Sprache.

Lokalisierter Name
value.properties.localizedName string

Lokalisiertes Sprachnamenfeld.

Anzeigename
value.properties.displayName string

Feld "Anzeigename der Sprache".

Ist Mandantstandard
value.properties.isTenantDefault boolean

Sprache ist das Standardfeld des Mandanten.

Objekt

Dies ist der Typ „Objekt“.