Workspaces - Set Inbound Azure Resource Rules

Service:
Core
API-versie:
v1

Hiermee stelt u de regels voor het binnenkomende Azure-resource-exemplaar voor een werkruimte in. Met deze API kunnen werkruimtebeheerders binnenkomende Azure regels voor het resource-exemplaar instellen die bepalen welke Azure resource-exemplaren in de lijst met toegestane resources voor een werkruimte staan. Deze functie is momenteel beschikbaar als preview-versie.

Note

Deze API maakt deel uit van een preview-versie en is alleen beschikbaar voor evaluatie- en ontwikkelingsdoeleinden. Het kan veranderen op basis van feedback en wordt niet aanbevolen voor productiegebruik.

Permissions

De aanroeper moet beheerdersrol werkruimte hebben.

Vereiste gedelegeerde bevoegdheden

Workspace.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft-identiteiten die in deze sectie worden vermeld.

Identity Support
User Yes
serviceprincipal en beheerde identiteiten Yes

Interface

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

URI-parameters

Name In Vereist Type Description
workspaceId
 path True

string (uuid)

De werkruimte-ID.

Aanvraagbody

Name Type Description
rules

WorkspaceInboundAzureResourceRule[]

Een matrix van binnenkomende Azure regels voor het resource-exemplaar die zijn gekoppeld aan de werkruimte.

Antwoorden

Name Type Description
200 OK

De aanvraag is voltooid.
429 Too Many Requests

ErrorResponse

De servicesnelheidslimiet is overschreden. De server retourneert een Retry-After header die in seconden aangeeft hoe lang de client moet wachten voordat extra aanvragen worden verzonden.

Kopteksten

Retry-After: integer
Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

  • UnknownError: er is een fout opgetreden.

Voorbeelden

Set workspace resource instance example

Voorbeeldaanvraag

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"
    }
  ]
}

Voorbeeldrespons

Statuscode:
200

Definities

Name Description
ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.
ErrorResponse

De foutreactie.
ErrorResponseDetails

De details van het foutbericht.
WorkspaceInboundAzureResourceRule

Vertegenwoordigt één regel voor binnenkomende Azure resource-exemplaar waarmee een toegestaan Azure resource-exemplaar voor de werkruimte wordt opgegeven.
WorkspaceInboundAzureResourceRules

Vertegenwoordigt een verzameling binnenkomende Azure regels voor het resource-exemplaar die zijn geconfigureerd voor een werkruimte. Deze regels bepalen welke Azure resource-exemplaren toegang hebben tot de werkruimte.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name Type Description
resourceId

string

De resource-ID die betrokken is bij het probleem.
resourceType

string

Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

De foutreactie.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
moreDetails

ErrorResponseDetails[]

Lijst met aanvullende foutdetails.
relatedResource

ErrorRelatedResource

Details van de foutgerelateerde resource.
requestId

string (uuid)

Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
relatedResource

ErrorRelatedResource

Details van de foutgerelateerde resource.

WorkspaceInboundAzureResourceRule

Object

Vertegenwoordigt één regel voor binnenkomende Azure resource-exemplaar waarmee een toegestaan Azure resource-exemplaar voor de werkruimte wordt opgegeven.

Name Type Description
displayName

string

Een gebruiksvriendelijke weergavenaam voor de regel. Deze naam wordt alleen gebruikt voor weergavedoeleinden en heeft geen invloed op de functionaliteit van de regel.
resourceId

string

De volledige Azure Resource Manager resource-id (ARM) van de resource binnen de regel. Dit is een unieke id in de notatie: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}. U kunt dit ophalen uit de Azure Portal (resource-eigenschappen), Azure CLI (az resource show) of ARM-sjablonen.

WorkspaceInboundAzureResourceRules

Object

Vertegenwoordigt een verzameling binnenkomende Azure regels voor het resource-exemplaar die zijn geconfigureerd voor een werkruimte. Deze regels bepalen welke Azure resource-exemplaren toegang hebben tot de werkruimte.

Name Type Description
rules

WorkspaceInboundAzureResourceRule[]

Een matrix van binnenkomende Azure regels voor het resource-exemplaar die zijn gekoppeld aan de werkruimte.