Workspaces - Get Inbound Azure Resource Rules

Servizio:: Core

Versione API:: v1

Restituisce le regole dell'istanza di risorsa Azure in ingresso per un'area di lavoro. Questa API è progettata per aiutare gli amministratori dell'area di lavoro a visualizzare le regole effettive dell'istanza delle risorse Azure in ingresso nelle impostazioni dell'area di lavoro. Questa funzionalità è attualmente disponibile solo in anteprima.

Note

Questa API fa parte di una versione di anteprima e viene fornita solo a scopo di valutazione e sviluppo. Può cambiare in base al feedback e non è consigliato per l'uso in produzione.

Autorizzazioni

Il chiamante deve avere ruolo visualizzatore o superiore.

Ambiti delegati obbligatori

Workspace.Read.All o Workspace.ReadWrite.All

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identità	Assistenza
User	Sì
Principale del servizio e Identità gestite	Sì

Interfaccia

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
workspaceId	path	True	string (uuid)	L’ID dell’area di lavoro.

Risposte

Nome Tipo Descrizione

200 OK

Nome	Tipo	Descrizione
200 OK	WorkspaceInboundAzureResourceRules	Richiesta completata correttamente.
429 Too Many Requests	ErrorResponse	È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione `Retry-After` che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive. Intestazioni Retry-After: integer
Other Status Codes	ErrorResponse	Codici di errore comuni: UnknownError: si è verificato un errore.

WorkspaceInboundAzureResourceRules

Richiesta completata correttamente.

429 Too Many Requests

ErrorResponse

È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione Retry-After che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive.

Intestazioni

Retry-After: integer

Other Status Codes

ErrorResponse

Codici di errore comuni:

UnknownError: si è verificato un errore.

Esempio

Get workspace resource instance example

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

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

Definizioni

Nome	Descrizione
ErrorRelatedResource	Oggetto dei dettagli della risorsa relativo all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
WorkspaceInboundAzureResourceRule	Rappresenta una singola regola dell'istanza di risorsa Azure in ingresso che specifica un'istanza di risorsa Azure consentita per l'area di lavoro.
WorkspaceInboundAzureResourceRules	Rappresenta una raccolta di regole dell'istanza di risorse Azure in ingresso configurate per un'area di lavoro. Queste regole definiscono quali Azure istanze di risorse sono autorizzate ad accedere all'area di lavoro.

ErrorRelatedResource

Oggetto

Oggetto dei dettagli della risorsa relativo all'errore.

Nome	Tipo	Descrizione
resourceId	string	ID risorsa coinvolto nell'errore.
resourceType	string	Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Oggetto

Risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
isRetriable	boolean	Se true, la richiesta può essere ritentata. Usare l'intestazione della `Retry-After` risposta per determinare il ritardo, se disponibile.
message	string	Rappresentazione leggibile dell'errore.
moreDetails	ErrorResponseDetails[]	Elenco di dettagli aggiuntivi sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.
requestId	string (uuid)	ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

Dettagli della risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

WorkspaceInboundAzureResourceRule

Oggetto

Rappresenta una singola regola dell'istanza di risorsa Azure in ingresso che specifica un'istanza di risorsa Azure consentita per l'area di lavoro.

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato descrittivo per la regola. Questo nome viene usato solo a scopo di visualizzazione e non influisce sulle funzionalità della regola.
resourceId	string	ID risorsa Azure Resource Manager completo (ARM) della risorsa all'interno della regola. Si tratta di un identificatore univoco nel formato : `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}`. È possibile recuperarne il risultato dai modelli portale di Azure (proprietà delle risorse), interfaccia della riga di comando di Azure (az resource show) o ARM.

WorkspaceInboundAzureResourceRules

Oggetto

Rappresenta una raccolta di regole dell'istanza di risorse Azure in ingresso configurate per un'area di lavoro. Queste regole definiscono quali Azure istanze di risorse sono autorizzate ad accedere all'area di lavoro.

Nome	Tipo	Descrizione
rules	WorkspaceInboundAzureResourceRule[]	Matrice di regole dell'istanza di risorse Azure in ingresso associate all'area di lavoro.