Workspaces - Set Inbound Azure Resource Rules

Servizio:
Core
Versione API:
v1

Imposta le regole dell'istanza di risorsa Azure in ingresso per un'area di lavoro. Questa API consente agli amministratori dell'area di lavoro di impostare le regole dell'istanza delle risorse in ingresso Azure che controllano quali istanze di risorse Azure si trovano nell'elenco consentito per un'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 amministratore'area di lavoro.

Ambiti delegati obbligatori

SpazioDiLavoro.LetturaScrittura.Tutti

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

PUT 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.

Corpo della richiesta

Nome Tipo Descrizione
rules

WorkspaceInboundAzureResourceRule[]

Matrice di regole dell'istanza di risorse Azure in ingresso associate all'area di lavoro.

Risposte

Nome Tipo Descrizione
200 OK

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

Set workspace resource instance example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200

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.