Workspaces - Set Inbound Azure Resource Rules

Tjeneste:
Core
API-versjon:
v1

Angir inngående Azure ressursforekomstregler for et arbeidsområde. Denne API-en gjør det mulig for administratorer for arbeidsområder å angi inngående Azure ressursforekomstregler som styrer hvilke Azure ressursforekomster som er i den tillatte listen for et arbeidsområde. Denne funksjonen er en forhåndsvisningsfunksjon.

Bemerkning

Denne API-en er en del av en forhåndsversjon, og er bare tilgjengelig for evaluerings- og utviklingsformål. Det kan endres basert på tilbakemelding og anbefales ikke for produksjonsbruk.

Tillatelser

Innringeren må ha arbeidsområderolle for administratorer .

Nødvendige delegerte omfang

Workspace.ReadWrite.All

Microsoft Entra støttede identiteter

Denne API-en støtter Microsoft identiteter oppført i denne delen.

Identitet Støtte
Bruker Ja
tjenestekontohaver og administrerte identiteter Ja

Grensesnitt

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

URI-parametere

Name I Obligatorisk Type Beskrivelse
workspaceId
 path True

string (uuid)

Arbeidsområde-ID-en.

Brødtekst for forespørsel

Name Type Beskrivelse
rules

WorkspaceInboundAzureResourceRule[]

En matrise med inngående Azure ressursforekomstregler som er knyttet til arbeidsområdet.

Svar

Name Type Beskrivelse
200 OK

Forespørselen er fullført.
429 Too Many Requests

ErrorResponse

Grensen for tjenestesats ble overskredet. Serveren returnerer en Retry-After topptekst som angir, i sekunder, hvor lenge klienten må vente før du sender flere forespørsler.

Overskrifter

Retry-After: integer
Other Status Codes

ErrorResponse

Vanlige feilkoder:

  • UnknownError - Det oppstod en feil.

Eksempler

Set workspace resource instance example

Eksempelforespørsel

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

Eksempelsvar

Statuskode:
200

Definisjoner

Name Beskrivelse
ErrorParameter

En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil.
ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.
ErrorResponse

Feilsvaret.
ErrorResponseDetails

Feilsvardetaljene.
WorkspaceInboundAzureResourceRule

Representerer én enkelt inngående Azure ressursforekomstregel som angir en tillatt Azure ressursforekomst for arbeidsområdet.
WorkspaceInboundAzureResourceRules

Representerer en samling av inngående Azure ressursforekomstregler som er konfigurert for et arbeidsområde. Disse reglene definerer hvilke Azure ressursforekomster som har tilgang til arbeidsområdet.

ErrorParameter

Objekt

En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil.

Name Type Beskrivelse
message

string

En lesbar beskrivelse av parameterens betydning.
name

string

Parameteridentifikatoren.
value

string

Parameterverdien.

ErrorRelatedResource

Objekt

Objektet for feilrelaterte ressursdetaljer.

Name Type Beskrivelse
resourceId

string

Ressurs-ID-en som er involvert i feilen.
resourceType

string

Typen ressurs som er involvert i feilen.

ErrorResponse

Objekt

Feilsvaret.

Name Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
isRetriable

boolean

Når sann, kan forespørselen prøves på nytt. Retry-After Bruk svarhodet til å fastslå forsinkelsen, hvis tilgjengelig.
message

string

En menneskelig lesbar representasjon av feilen.
moreDetails

ErrorResponseDetails[]

Liste over flere feildetaljer.
parameters

ErrorParameter[]

Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.
requestId

string (uuid)

ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Objekt

Feilsvardetaljene.

Name Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message

string

En menneskelig lesbar representasjon av feilen.
parameters

ErrorParameter[]

Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.

WorkspaceInboundAzureResourceRule

Objekt

Representerer én enkelt inngående Azure ressursforekomstregel som angir en tillatt Azure ressursforekomst for arbeidsområdet.

Name Type Beskrivelse
displayName

string

Et brukervennlig visningsnavn for regelen. Dette navnet brukes bare til visningsformål og påvirker ikke regelens funksjonalitet.
resourceId

string

Den fullstendige ressurs-ID-en for Azure Resource Manager (ARM) for ressursen i regelen. Dette er en unik identifikator i formatet: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}. Du kan hente dette fra Azure Portal (ressursegenskaper), Azure CLI (az ressursvisning) eller ARM-maler.

WorkspaceInboundAzureResourceRules

Objekt

Representerer en samling av inngående Azure ressursforekomstregler som er konfigurert for et arbeidsområde. Disse reglene definerer hvilke Azure ressursforekomster som har tilgang til arbeidsområdet.

Name Type Beskrivelse
rules

WorkspaceInboundAzureResourceRule[]

En matrise med inngående Azure ressursforekomstregler som er knyttet til arbeidsområdet.