Comunicação da carga de trabalho

Este artigo descreve como funciona a comunicação entre um frontend e back-end do Microsoft Fabric. Ele abrange as principais considerações para administradores e usuários.

Comunicação frontend-to-backend

A autenticação entre o frontend e o backend acontece através de um canal seguro e autenticado. Para ter um token disponível em seu back-end para comunicação com outros serviços, você pode usar o frontend do Fabric para passar a comunicação para o back-end.

Processamento de erros

Para propagar quaisquer erros que ocorram no back-end da carga de trabalho para o front-end da carga de trabalho quando você trabalha com APIs do plano de controle (operações e trabalhos CRUD, exceto para GetItemJobInstanceStateAsync), o back-end da carga de trabalho deve retornar um código de status de erro. O conteúdo do corpo de resposta deve ser um arquivo JSON serializado da classe ErrorResponse que faz parte dos contratos no back-end da carga de trabalho.

Eis um exemplo:

    var errorResponse = new ErrorResponse
    {
        ErrorCode = ErrorCode,
        Message = ErrorMessage,
        MessageParameters = _messageParameters.Any() ? _messageParameters : null,
        Source = ErrorSource,
        IsPermanent = IsPermanent,
        MoreDetails = Details,
    };
    
    
    return new ContentResult
    {
        StatusCode = (int)HttpStatusCode,
        Content = JsonSerializer.Serialize(errorResponse),
        ContentType = MediaTypeNames.Application.Json,
    };