Workspaces - Set Inbound Azure Resource Rules

Serviço:: Core

Versão da API:: v1

Define as regras de instância de recurso do Azure de entrada para um espaço de trabalho. Esta API permite aos administradores de espaços de trabalho definir regras de instância de recurso do Azure de entrada que controlam quais instâncias de recursos do Azure estão na lista permitida para um espaço de trabalho. Esta funcionalidade está atualmente em pré-visualização.

Note

Esta API faz parte de uma versão de pré-visualização e é fornecida apenas para fins de avaliação e desenvolvimento. Ele pode mudar com base no feedback e não é recomendado para uso em produção.

Permissions

O chamador deve ter função de administrador espaço de trabalho.

Escopos delegados necessários

Workspace.ReadWrite.All

Identidades suportadas pelo Entra da Microsoft

Esta API suporta as identidades do Microsoft listadas nesta secção.

Identidade	Apoio
User	Sim
Entidade de serviço e identidades geridas	Sim

Interface

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
workspaceId	path	True	string (uuid)	O ID do espaço de trabalho.

Corpo do Pedido

Name	Tipo	Description
rules	WorkspaceInboundAzureResourceRule[]	Um array de regras de instância de recursos do Azure de entrada associadas ao espaço de trabalho.

Respostas

Name Tipo Description

200 OK

Name	Tipo	Description
200 OK		Pedido concluído com sucesso.
429 Too Many Requests	ErrorResponse	O limite de tarifa de serviço foi ultrapassado. O servidor devolve um `Retry-After` cabeçalho que indica, em segundos, quanto tempo o cliente deve esperar antes de enviar pedidos adicionais. Cabeçalhos Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de erro comuns: UnknownError - Ocorreu um erro.

Pedido concluído com sucesso.

429 Too Many Requests

ErrorResponse

O limite de tarifa de serviço foi ultrapassado. O servidor devolve um Retry-After cabeçalho que indica, em segundos, quanto tempo o cliente deve esperar antes de enviar pedidos adicionais.

Cabeçalhos

Retry-After: integer

Other Status Codes

ErrorResponse

Códigos de erro comuns:

UnknownError - Ocorreu um erro.

Exemplos

Set workspace resource instance example

Pedido de amostra

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

Resposta da amostra

Código de estado:: 200

Definições

Name	Description
ErrorRelatedResource	Os detalhes do objeto de recurso relacionado ao erro.
ErrorResponse	A resposta de erro.
ErrorResponseDetails	Os detalhes do erro na resposta.
WorkspaceInboundAzureResourceRule	Representa uma única regra de instância de recurso Azure de entrada que especifica uma instância de recurso Azure permitida para o espaço de trabalho.
WorkspaceInboundAzureResourceRules	Representa uma coleção de regras de instância de recursos do Azure de entrada configuradas para um espaço de trabalho. Estas regras definem quais as instâncias de recursos do Azure que podem aceder ao espaço de trabalho.

ErrorRelatedResource

Object

Os detalhes do objeto de recurso relacionado ao erro.

Name	Tipo	Description
resourceId	string	O ID do recurso envolvido no erro.
resourceType	string	O tipo de recurso envolvido no erro.

ErrorResponse

Object

A resposta de erro.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
moreDetails	ErrorResponseDetails[]	Lista de detalhes de erro adicionais.
relatedResource	ErrorRelatedResource	Detalhes do recurso relacionado ao erro.
requestId	string (uuid)	ID da solicitação associada ao erro.

ErrorResponseDetails

Object

Os detalhes do erro na resposta.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
relatedResource	ErrorRelatedResource	Detalhes do recurso relacionado ao erro.

WorkspaceInboundAzureResourceRule

Object

Representa uma única regra de instância de recurso Azure de entrada que especifica uma instância de recurso Azure permitida para o espaço de trabalho.

Name	Tipo	Description
displayName	string	Um nome de exibição fácil de usar para a regra. Este nome é usado apenas para fins de exibição e não afeta a funcionalidade da regra.
resourceId	string	O ID completo do Azure Resource Manager (ARM) do recurso dentro da regra. Este é um identificador único no formato: `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}`. Pode obter isto através do portal do Azure (propriedades de recursos), CLI do Azure (az resource show) ou modelos ARM.

WorkspaceInboundAzureResourceRules

Object

Representa uma coleção de regras de instância de recursos do Azure de entrada configuradas para um espaço de trabalho. Estas regras definem quais as instâncias de recursos do Azure que podem aceder ao espaço de trabalho.

Name	Tipo	Description
rules	WorkspaceInboundAzureResourceRule[]	Um array de regras de instância de recursos do Azure de entrada associadas ao espaço de trabalho.