Cross Connections Api Development

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_first

missing_linux_example

windows_tools

Summary

The documentation demonstrates a Windows bias by exclusively showing command-line examples using Windows file paths (e.g., C:\Users\...), and referencing the ARMClient tool as if it is being run from a Windows environment. There are no Linux or cross-platform shell examples, and no mention of Linux-compatible tools or usage patterns. The documentation assumes a Windows user context throughout, which may hinder Linux users.

Recommendations

Provide equivalent Linux/macOS shell examples (e.g., using bash/zsh) alongside Windows command-line examples.
Clarify whether ARMClient is available and supported on Linux/macOS, and provide installation and usage instructions for those platforms if so.
Use platform-neutral file paths in documentation, or show both Windows and Linux path examples where relevant.
Explicitly mention that the API can be accessed from any OS, and provide curl or HTTPie examples for REST API calls, which are available on all platforms.
Avoid assuming a Windows user context in narrative or examples; strive for parity in tool recommendations and usage instructions.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-14 00:00	#250	in_progress	Clean
2026-01-13 00:00	#246	completed	Clean
2026-01-11 00:00	#240	completed	Clean
2026-01-10 00:00	#237	completed	Clean
2026-01-09 00:34	#234	completed	Clean
2026-01-08 00:53	#231	completed	Clean
2026-01-06 18:15	#225	cancelled	Clean
2025-08-17 00:01	#83	cancelled	Clean
2025-07-13 21:37	#48	completed	Clean
2025-07-09 13:09	#3	cancelled	Clean
2025-07-08 04:23	#2	cancelled	Biased

Flagged Code Snippets

  PUT /subscriptions/<ProviderManagementSubscription>/resourceGroups/CrossConnection-EUAPTest/providers/Microsoft.Network/expressRouteCrossConnections/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/peerings/AzurePrivatePeering?api-version=2018-02-01 HTTP/1.1
  Host: management.azure.com
  Authorization: Bearer eyJ0eXAiOiJKV...
  User-Agent: ARMClient/1.2.0.0
  Accept: application/json
  x-ms-request-id: 9c1413a5-6d27-4e87-b075-1fedb15d63a3

  {
    "properties": {
      "peeringType": "AzurePrivatePeering",
      "peerASN": 500,
      "primaryPeerAddressPrefix": "10.0.0.0/30",
      "secondaryPeerAddressPrefix": "10.0.0.4/30",
      "sharedKey": "A1B2C3D4",
      "vlanId": 200
    },
    "name": "AzurePrivatePeering"
  }
  ---------- Response (2354 ms) ------------

  HTTP/1.1 201 Created
  Pragma: no-cache
  Retry-After: 10
  x-ms-request-id: dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b
  Azure-AsyncOperation: https://management.azure.com/subscriptions/<ProviderManagementSubscription>/providers/Microsoft.Network/locations/eastus2euap/operations/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b?api-version=2018-02-01
  Strict-Transport-Security: max-age=31536000; includeSubDomains
  Cache-Control: no-cache
  Server: Microsoft-HTTPAPI/2.0; Microsoft-HTTPAPI/2.0
  x-ms-ratelimit-remaining-subscription-writes: 1199
  x-ms-correlation-request-id: b5d08e36-339c-423a-ac2c-b6ec2063c8a6
  x-ms-routing-request-id: WESTUS:20180501T194026Z:b5d08e36-339c-423a-ac2c-b6ec2063c8a6
  X-Content-Type-Options: nosniff
  Date: Tue, 01 May 2018 19:40:26 GMT

  {
    "name": "AzurePrivatePeering",
    "id": "/subscriptions/<ProviderManagementSubscription>/resourceGroups/CrossConnection-EUAPTest/providers/Microsoft.Network/expressRouteCrossConnections/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/peerings/AzurePrivatePeering",
    "properties": {
      "provisioningState": "Updating",
      "peeringType": "AzurePrivatePeering",
      "azureASN": 0,
      "peerASN": 500,
      "primaryPeerAddressPrefix": "10.0.0.0/30",
      "secondaryPeerAddressPrefix": "10.0.0.4/30",
      "sharedKey": "A1B2C3D4",
      "state": "Disabled",
      "vlanId": 200,
      "lastModifiedBy": ""
    }
  }

  C:\Users\kaanan\Documents\Expressroute\Partner APIs\ARMClient-master\ARMClient-master>armclient get https://management.azure.com/subscriptions/<ProviderManagementSubscription>/providers/Microsoft.Network/locations/eastus2euap/operations/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b?api-version=2018-02-01
  {
    "status": "Succeeded"
  }

  PUT /subscriptions/<ProviderManagementSubscription>/resourceGroups/CrossConnection-EUAPTest/providers/Microsoft.Network/expressRouteCrossConnections/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/peerings/MicrosoftPeering?api-version=2018-02-01 HTTP/1.1
  Host: management.azure.com
  Authorization: Bearer eyJ0eXAiOiJKV...
  User-Agent: ARMClient/1.2.0.0
  Accept: application/json
  x-ms-request-id: af4527eb-7b68-4a50-b953-c0606524d8f3

  {
    "properties": {
      "peeringType": "MicrosoftPeering",
      "peerASN": 900,
      "primaryPeerAddressPrefix": "203.0.113.0/30",
      "secondaryPeerAddressPrefix": "203.0.113.4/30",
      "vlanId": 300,
      "microsoftPeeringConfig": {
        "advertisedPublicPrefixes": [
          "203.0.113.128/25"
        ],
        "customerASN": 45,
        "routingRegistryName": "ARIN"
      }
    },
    "name": "MicrosoftPeering"
  }
  ---------- Response (2530 ms) ------------

  HTTP/1.1 201 Created
  Pragma: no-cache
  Retry-After: 10
  x-ms-request-id: eeee4efe-ff5f-aa6a-bb7b-cccccc8c8c8c
  Azure-AsyncOperation: https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Network/locations/eastus2euap/operations/eeee4efe-ff5f-aa6a-bb7b-cccccc8c8c8c?api-version=2018-02-01
  Strict-Transport-Security: max-age=31536000; includeSubDomains
  Cache-Control: no-cache
  Server: Microsoft-HTTPAPI/2.0; Microsoft-HTTPAPI/2.0
  x-ms-ratelimit-remaining-subscription-writes: 1199
  x-ms-correlation-request-id: 8e26bc5d-f1cd-4305-a373-860aaf7bb694
  x-ms-routing-request-id: WESTUS:20180501T213857Z:8e26bc5d-f1cd-4305-a373-860aaf7bb694
  X-Content-Type-Options: nosniff
  Date: Tue, 01 May 2018 21:38:56 GMT

  {
    "name": "MicrosoftPeering",
    "id": "/subscriptions/<ProviderManagementSubscription>/resourceGroups/CrossConnection-EUAPTest/providers/Microsoft.Network/expressRouteCrossConnections/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/peerings/MicrosoftPeering",
    "properties": {
      "provisioningState": "Updating",
      "peeringType": "MicrosoftPeering",
      "azureASN": 0,
      "peerASN": 900,
      "primaryPeerAddressPrefix": "203.0.113.0/30",
      "secondaryPeerAddressPrefix": "203.0.113.4/30",
      "state": "Disabled",
      "vlanId": 300,
      "lastModifiedBy": "",
      "microsoftPeeringConfig": {
        "advertisedPublicPrefixes": [
          "203.0.113.128/25"
        ],
        "advertisedPublicPrefixesState": "NotConfigured",
        "customerASN": 45,
        "legacyMode": 0,
        "routingRegistryName": "ARIN"
      }
    }
  }

  C:\Users\Admin\Documents\Expressroute\Partner APIs\ARMClient-master\ARMClient-master>armclient get https://management.azure.com/subscriptions/<ProviderManagementSubscription>/providers/Microsoft.Network/locations/eastus2euap/operations/eeee4efe-ff5f-aa6a-bb7b-cccccc8c8c8c?api-version=2018-02-01
  {
    "status": "Succeeded"
  }

  PUT /subscriptions/<ProviderManagementSubscription>/resourceGroups/CrossConnection-EUAPTest/providers/Microsoft.Network/expressRouteCrossConnections/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f?api-version=2018-02-01 HTTP/1.1
  Host: management.azure.com
  Authorization: Bearer eyJ0eXAiOiJKV...
  User-Agent: ARMClient/1.2.0.0
  Accept: application/json
  x-ms-request-id: d867c3c9-2acf-4c54-a0f0-d7ca50fc7b9b

  {
    "properties": {
      "serviceProviderProvisioningState": "Provisioned",
      "peeringLocation": "EUAP Test",
      "expressRouteCircuit": {
        "id": "/subscriptions/<ProviderManagementSubscription>/resourceGroups/Karthikcrossconnectiontest/providers/Microsoft.Network/expressRouteCircuits/TestCircuitXYZ"
      },
      "bandwidthInMbps": 200
    },
    "location": "East US 2 EUAP"
  }
  ---------- Response (1740 ms) ------------

  HTTP/1.1 200 OK
  Pragma: no-cache
  Retry-After: 10
  x-ms-request-id: cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a
  Azure-AsyncOperation: https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Network/locations/eastus2euap/operations/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a?api-version=2018-02-01
  Strict-Transport-Security: max-age=31536000; includeSubDomains
  Cache-Control: no-cache
  Server: Microsoft-HTTPAPI/2.0; Microsoft-HTTPAPI/2.0
  x-ms-ratelimit-remaining-subscription-writes: 1199
  x-ms-correlation-request-id: d2d38c28-0dbe-4b40-8824-c74968c46b50
  x-ms-routing-request-id: WESTUS:20180501T222105Z:d2d38c28-0dbe-4b40-8824-c74968c46b50
  X-Content-Type-Options: nosniff
  Date: Tue, 01 May 2018 22:21:04 GMT

  {
    "name": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
    "id": "/subscriptions/<ProviderManagementSubscription>/resourceGroups/CrossConnection-EUAPTest/providers/Microsoft.Network/expressRouteCrossConnections/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
    "etag": "W/\"ecdcb1a4-873b-4dad-ae56-a4b17795a84a\"",
    "type": "Microsoft.Network/expressRouteCrossConnections",
    "location": "eastus2euap",
    "properties": {
      "provisioningState": "Updating",
      "expressRouteCircuit": {
        "id": "/subscriptions/<TargetCustomerSubscription>/resourceGroups/Karthikcrossconnectiontest/providers/Microsoft.Network/expressRouteCircuits/TestCircuitXYZ"
      },
      "peeringLocation": "EUAP Test",
      "bandwidthInMbps": 200,
      "serviceProviderProvisioningState": "Provisioned",
      "primaryAzurePort": "",
      "secondaryAzurePort": "",
      "sTag": 0,
      "peerings": []
    }
  }

  C:\Users\Admin\Documents\Expressroute\Partner APIs\ARMClient-master\ARMClient-master>armclient get https://management.azure.com/subscriptions/<ProviderManagementSubscription>/providers/Microsoft.Network/locations/eastus2euap/operations/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a?api-version=2018-02-01
  {
    "status": "Succeeded"
  }

Document Details

About This Page

Bias Analysis

Scan History

Flagged Code Snippets