Workspaces - Set Inbound Azure Resource Rules

Service:: Core

Version d'API:: v1

Définit les règles d’instance de ressource entrantes Azure pour un espace de travail. Cette API permet aux administrateurs d’espace de travail de définir des règles d’instance de ressources entrantes Azure qui contrôlent les instances de ressources Azure qui se trouvent dans la liste autorisée d’un espace de travail. Actuellement, cette fonctionnalité est uniquement disponible en tant que version préliminaire.

Note

Cette API fait partie d’une préversion et est fournie uniquement à des fins d’évaluation et de développement. Il peut changer en fonction des commentaires et n’est pas recommandé pour une utilisation en production.

Permissions

L’appelant doit avoir rôle d’administrateur espace de travail.

Étendues déléguées requises

Workspace.ReadWrite.All

Identités prises en charge par Microsoft Entra

Cette API prend en charge les identités Microsoft répertoriées dans cette section.

Identité	Support
Utilisateur	Oui
Service principal et identités gérées	Oui

Interface

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
workspaceId	path	True	string (uuid)	Identifiant de l’espace de travail.

Corps de la demande

Nom	Type	Description
rules	WorkspaceInboundAzureResourceRule[]	Tableau de règles d’instance de ressource entrantes Azure associées à l’espace de travail.

Réponses

Nom Type Description

200 OK

Nom	Type	Description
200 OK		La demande s’est terminée avec succès.
429 Too Many Requests	ErrorResponse	La limite de débit de service a été dépassée. Le serveur retourne un `Retry-After` en-tête indiquant, en secondes, combien de temps le client doit attendre avant d’envoyer des demandes supplémentaires. En-têtes Retry-After: integer
Other Status Codes	ErrorResponse	Codes d’erreur courants : UnknownError : une erreur s’est produite.

La demande s’est terminée avec succès.

429 Too Many Requests

ErrorResponse

La limite de débit de service a été dépassée. Le serveur retourne un Retry-After en-tête indiquant, en secondes, combien de temps le client doit attendre avant d’envoyer des demandes supplémentaires.

En-têtes

Retry-After: integer

Other Status Codes

ErrorResponse

Codes d’erreur courants :

UnknownError : une erreur s’est produite.

Exemples

Set workspace resource instance example

Exemple de requête

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

Exemple de réponse

Code d’état:: 200

Définitions

Nom	Description
ErrorRelatedResource	Objet de détails de ressource associé à l’erreur.
ErrorResponse	Réponse d’erreur.
ErrorResponseDetails	Détails de la réponse d’erreur.
WorkspaceInboundAzureResourceRule	Représente une règle d’instance de ressource de Azure entrante qui spécifie une instance de ressource Azure autorisée pour l’espace de travail.
WorkspaceInboundAzureResourceRules	Représente une collection de règles d’instance de ressource entrantes Azure configurées pour un espace de travail. Ces règles définissent les instances de ressources Azure autorisées à accéder à l’espace de travail.

ErrorRelatedResource

Objet

Objet de détails de ressource associé à l’erreur.

Nom	Type	Description
resourceId	string	ID de ressource impliqué dans l’erreur.
resourceType	string	Type de la ressource impliquée dans l’erreur.

ErrorResponse

Objet

Réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message	string	Représentation lisible humaine de l’erreur.
moreDetails	ErrorResponseDetails[]	Liste des détails d’erreur supplémentaires.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.
requestId	string (uuid)	ID de la demande associée à l’erreur.

ErrorResponseDetails

Objet

Détails de la réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message	string	Représentation lisible humaine de l’erreur.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.

WorkspaceInboundAzureResourceRule

Objet

Représente une règle d’instance de ressource de Azure entrante qui spécifie une instance de ressource Azure autorisée pour l’espace de travail.

Nom	Type	Description
displayName	string	Nom complet convivial de la règle. Ce nom est utilisé uniquement à des fins d’affichage et n’affecte pas les fonctionnalités de la règle.
resourceId	string	ID de ressource Azure Resource Manager complet (ARM) de la ressource dans la règle. Il s’agit d’un identificateur unique au format : `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}`. Vous pouvez le récupérer à partir des Portail Azure (propriétés de la ressource), des Azure CLI (az resource show) ou des modèles ARM.

WorkspaceInboundAzureResourceRules

Objet

Représente une collection de règles d’instance de ressource entrantes Azure configurées pour un espace de travail. Ces règles définissent les instances de ressources Azure autorisées à accéder à l’espace de travail.

Nom	Type	Description
rules	WorkspaceInboundAzureResourceRule[]	Tableau de règles d’instance de ressource entrantes Azure associées à l’espace de travail.