Workspaces - Set Inbound Azure Resource Rules

Palvelu:: Core

Ohjelmointirajapinnan versio:: v1

Määrittää työtilan saapuvan Azure resurssiesiintymäsäännöt. Tämän ohjelmointirajapinnan avulla työtilan järjestelmänvalvojat voivat määrittää saapuvan Azure resurssiesiintymäsäännöt, jotka ohjaavat sitä, mitkä Azure resurssiesiintymät ovat työtilan sallittujen luettelossa. Tämä ominaisuus on käytettävissä vain esiversiona.

Note

Tämä ohjelmointirajapinta on osa esikatseluversiota, ja se on saatavilla vain arviointi- ja kehitystarkoituksiin. Muutos saattaa perustua palautteeseen, eikä sitä suositella tuotantokäyttöön.

Käyttöoikeudet

Soittajalla on oltava järjestelmänvalvojan työtilan rooli.

Vaaditut delegoidut vaikutusalueet

Workspace.ReadWrite.All

tuettujen käyttäjätietojen Microsoft Entra

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft identities.

Käyttäjätiedot	Tuki
Käyttäjä	Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen	Kyllä

Liittymä

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Description
workspaceId	path	True	string (uuid)	Työtilan tunnus.

Pyynnön leipäteksti

Nimi	Tyyppi	Description
rules	WorkspaceInboundAzureResourceRule[]	Saapuvan Azure resurssiesiintymän sääntöjen matriisi, joka on liitetty työtilaan.

Vastaukset

Nimi Tyyppi Description

200 OK

Nimi	Tyyppi	Description
200 OK		Pyynnön valmistuttua.
429 Too Many Requests	ErrorResponse	Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka `Retry-After` ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään. Otsikot Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: UnknownError – Ilmeni virhe.

Pyynnön valmistuttua.

429 Too Many Requests

ErrorResponse

Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään.

Otsikot

Retry-After: integer

Other Status Codes

ErrorResponse

Yleiset virhekoodit:

UnknownError – Ilmeni virhe.

Esimerkit

Set workspace resource instance example

Mallipyyntö

HTTP

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

Mallivastaus

Tilakoodi:: 200

Määritelmät

Nimi	Description
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
WorkspaceInboundAzureResourceRule	Edustaa yhtä saapuvaa Azure resurssiesiintymäsääntöä, joka määrittää sallitun Azure resurssiesiintymän työtilalle.
WorkspaceInboundAzureResourceRules	Edustaa työtilaan määritettyjen saapuvien Azure resurssiesiintymäsääntöjen kokoelmaa. Nämä säännöt määrittävät, Azure resurssiesiintymät voivat käyttää työtilaa.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Description
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string (uuid)	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

WorkspaceInboundAzureResourceRule

Kohde

Edustaa yhtä saapuvaa Azure resurssiesiintymäsääntöä, joka määrittää sallitun Azure resurssiesiintymän työtilalle.

Nimi	Tyyppi	Description
displayName	string	Käyttäjäystävällinen säännön näyttönimi. Tätä nimeä käytetään vain näyttämiseen, eikä se vaikuta säännön toimintoihin.
resourceId	string	Säännön sisältämän resurssin koko Azure Resource Manager (ARM) -resurssitunnus. Tämä on yksilöivä tunniste muodossa : `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}`. Voit hakea tämän Azure-portaali (resurssin ominaisuudet), Azure CLI (az resource show) tai ARM-malleista.

WorkspaceInboundAzureResourceRules

Kohde

Edustaa työtilaan määritettyjen saapuvien Azure resurssiesiintymäsääntöjen kokoelmaa. Nämä säännöt määrittävät, Azure resurssiesiintymät voivat käyttää työtilaa.

Nimi	Tyyppi	Description
rules	WorkspaceInboundAzureResourceRule[]	Saapuvan Azure resurssiesiintymän sääntöjen matriisi, joka on liitetty työtilaan.