Connector Rest - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

windows_tools

windows_first

Summary

The documentation exhibits mild Windows bias, primarily through the explicit mention of Windows-centric tools (Visual Studio, PowerShell's Invoke-RestMethod) as recommended options for testing REST API requests. These tools are listed before or instead of cross-platform or Linux-native alternatives. No Linux or cross-platform command-line tools (such as curl or httpie) are suggested, and no Linux-specific examples are provided. However, the majority of the documentation is platform-neutral, focusing on Azure Data Factory UI and JSON configuration.

Recommendations

When suggesting tools for testing REST APIs, include cross-platform and Linux-native options such as 'curl' and 'httpie' alongside Visual Studio and PowerShell.
Rephrase the tip to present tool options in a platform-neutral order, e.g., 'You can use tools like curl, httpie, PowerShell's Invoke-RestMethod, Visual Studio, or a web browser to validate.'
Wherever possible, provide example commands for both Windows (PowerShell) and Linux/macOS (bash/curl) environments.
Review other documentation pages for similar tips or examples and ensure Linux parity in tool recommendations and sample commands.

Create Pull Request

Scan History

Date	Scan	Status	Result
2025-07-12 23:44	#41	cancelled	Biased
2025-07-12 00:58	#8	cancelled	Clean
2025-07-10 05:06	#7	processing	Clean

Flagged Code Snippets

{
    "name": "RESTLinkedService",
    "properties": {
        "type": "RestService",
        "typeProperties": {
            "url": "<REST endpoint e.g. https://www.example.com/>",
            "authenticationType": "AadServicePrincipal",
            "servicePrincipalId": "<service principal id>",
            "servicePrincipalCredentialType": "ServicePrincipalCert",
            "servicePrincipalEmbeddedCert": {
                "type": "SecureString",
                "value": "<the base64 encoded certificate of your application registered in Microsoft Entra ID>"
            },
            "servicePrincipalEmbeddedCertPassword": {
                "type": "SecureString",
                "value": "<password of your certificate>"
            },
            "tenant": "<tenant info, e.g. microsoft.onmicrosoft.com>",
            "aadResourceId": "<Azure AD resource URL e.g. https://management.core.windows.net>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}