Workspaces - Set Inbound Azure Resource Rules

Dienst:
Core
API-Version:
v1

Legt die Regeln für eingehende Azure Ressourceninstanz für einen Arbeitsbereich fest. Mit dieser API können Arbeitsbereichsadministratoren eingehende Azure Ressourceninstanzregeln festlegen, die steuern, welche Azure Ressourceninstanzen in der Liste der zulässigen Ressourcen für einen Arbeitsbereich enthalten sind. Diese Funktion steht derzeit als Vorschau zur Verfügung.

Note

Diese API ist Teil einer Preview-Version und wird nur für Evaluierungs- und Entwicklungszwecke bereitgestellt. Sie kann sich basierend auf Feedback ändern und wird nicht für den Produktionseinsatz empfohlen.

Erlaubnisse

Der Anrufer muss über Administratorrolle Arbeitsbereichs verfügen.

Erforderliche delegierte Zugriffsbereiche

Arbeitsbereich.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität Support
Benutzer Ja
Service Principal und Verwaltete Identitäten Ja

Interface

PUT https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/networking/communicationPolicy/inbound/azureResources

URI-Parameter

Name In Erforderlich Typ Beschreibung
workspaceId
 path True

string (uuid)

Die Arbeitsbereichs-ID.

Anforderungstext

Name Typ Beschreibung
rules

WorkspaceInboundAzureResourceRule[]

Ein Array eingehender Azure Ressourceninstanzregeln, die dem Arbeitsbereich zugeordnet sind.

Antworten

Name Typ Beschreibung
200 OK

Der Auftrag wurde erfolgreich abgeschlossen.
429 Too Many Requests

ErrorResponse

Der Dienstratenlimit wurde überschritten. Der Server gibt einen Retry-After Header zurück, der in Sekunden angibt, wie lange der Client warten muss, bevor zusätzliche Anforderungen gesendet werden.

Header

Retry-After: integer
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • UnknownError – Ein Fehler ist aufgetreten.

Beispiele

Set workspace resource instance example

Beispielanforderung

PUT https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/networking/communicationPolicy/inbound/azureResources

{
  "rules": [
    {
      "displayName": "SQL Server - testsql1",
      "resourceId": "/subscriptions/2374e516-d28b-4898-a39c-6070e078ae31/resourceGroups/testrg/providers/Microsoft.Sql/servers/testsql1"
    },
    {
      "displayName": "Storage Account - teststorageacct",
      "resourceId": "/subscriptions/2374e516-d28b-4898-a39c-6070e078ae31/resourceGroups/testrg/providers/Microsoft.Storage/storageAccounts/teststorageacct"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:
200

Definitionen

Name Beschreibung
ErrorRelatedResource

Das Objekt der fehlerbezogenen Ressourcendetails.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
WorkspaceInboundAzureResourceRule

Stellt eine einzelne eingehende Azure Ressourceninstanzregel dar, die eine zulässige Azure Ressourceninstanz für den Arbeitsbereich angibt.
WorkspaceInboundAzureResourceRules

Stellt eine Auflistung eingehender Azure Ressourceninstanzregeln dar, die für einen Arbeitsbereich konfiguriert sind. Diese Regeln definieren, welche Azure Ressourceninstanzen auf den Arbeitsbereich zugreifen dürfen.

ErrorRelatedResource

Objekt

Das Objekt der fehlerbezogenen Ressourcendetails.

Name Typ Beschreibung
resourceId

string

Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType

string

Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
isRetriable

boolean

Wenn true, kann die Anforderung wiederholt werden. Verwenden Sie den Retry-After Antwortheader, um die Verzögerung zu ermitteln, falls verfügbar.
message

string

Eine menschenlesbare Darstellung des Fehlers.
moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string (uuid)

ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine menschenlesbare Darstellung des Fehlers.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.

WorkspaceInboundAzureResourceRule

Objekt

Stellt eine einzelne eingehende Azure Ressourceninstanzregel dar, die eine zulässige Azure Ressourceninstanz für den Arbeitsbereich angibt.

Name Typ Beschreibung
displayName

string

Ein benutzerfreundlicher Anzeigename für die Regel. Dieser Name wird nur für Anzeigezwecke verwendet und wirkt sich nicht auf die Funktionalität der Regel aus.
resourceId

string

Die vollständige Azure Resource Manager (ARM)-Ressourcen-ID der Ressource innerhalb der Regel. Dies ist ein eindeutiger Bezeichner im Format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}. Sie können dies aus den Azure-Portal (Resource properties), Azure CLI (az resource show) oder ARM-Vorlagen abrufen.

WorkspaceInboundAzureResourceRules

Objekt

Stellt eine Auflistung eingehender Azure Ressourceninstanzregeln dar, die für einen Arbeitsbereich konfiguriert sind. Diese Regeln definieren, welche Azure Ressourceninstanzen auf den Arbeitsbereich zugreifen dürfen.

Name Typ Beschreibung
rules

WorkspaceInboundAzureResourceRule[]

Ein Array eingehender Azure Ressourceninstanzregeln, die dem Arbeitsbereich zugeordnet sind.