Microsoft.ServiceNetworking (stable:2025-01-01)

2025/03/06 • 9 updated methods

TrafficControllerInterface_ListBySubscription (updated)
Description List TrafficController resources by subscription ID
Reference Link ¶

⚶ Changes

{
  "#id": "TrafficControllerInterface_ListBySubscription",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "securityPolicyConfigurations": [
                  {
                    "#name": "wafSecurityPolicy",
                    "Description": {
                      "new": "Contains reference to a WAF-type security policy.",
                      "old": "Contains reference to a WAF-type security policy that is applied at the Traffic Controller level."
                    }
                  }
                ]
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ServiceNetworking/trafficControllers
{
api-version: string ,
subscriptionId: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
configurationEndpoints:
[
string ,
]
,
frontends:
[
{
id: string ,
}
,
]
,
associations:
[
{
id: string ,
}
,
]
,
securityPolicies:
[
{
id: string ,
}
,
]
,
securityPolicyConfigurations:
{
wafSecurityPolicy:
{
id: string ,
}
,
}
,
provisioningState: enum ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
TrafficControllerInterface_ListByResourceGroup (updated)
Description List TrafficController resources by resource group
Reference Link ¶

⚶ Changes

{
  "#id": "TrafficControllerInterface_ListByResourceGroup",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "securityPolicyConfigurations": [
                  {
                    "#name": "wafSecurityPolicy",
                    "Description": {
                      "new": "Contains reference to a WAF-type security policy.",
                      "old": "Contains reference to a WAF-type security policy that is applied at the Traffic Controller level."
                    }
                  }
                ]
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceNetworking/trafficControllers
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
configurationEndpoints:
[
string ,
]
,
frontends:
[
{
id: string ,
}
,
]
,
associations:
[
{
id: string ,
}
,
]
,
securityPolicies:
[
{
id: string ,
}
,
]
,
securityPolicyConfigurations:
{
wafSecurityPolicy:
{
id: string ,
}
,
}
,
provisioningState: enum ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
TrafficControllerInterface_Get (updated)
Description Get a TrafficController
Reference Link ¶

⚶ Changes

{
  "#id": "TrafficControllerInterface_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "securityPolicyConfigurations": [
              {
                "#name": "wafSecurityPolicy",
                "Description": {
                  "new": "Contains reference to a WAF-type security policy.",
                  "old": "Contains reference to a WAF-type security policy that is applied at the Traffic Controller level."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceNetworking/trafficControllers/{trafficControllerName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
trafficControllerName: string ,
}

⚐ Response (200)

{
properties:
{
configurationEndpoints:
[
string ,
]
,
frontends:
[
{
id: string ,
}
,
]
,
associations:
[
{
id: string ,
}
,
]
,
securityPolicies:
[
{
id: string ,
}
,
]
,
securityPolicyConfigurations:
{
wafSecurityPolicy:
{
id: string ,
}
,
}
,
provisioningState: enum ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
TrafficControllerInterface_CreateOrUpdate (updated)
Description Create a TrafficController
Reference Link ¶

⚶ Changes

{
  "#id": "TrafficControllerInterface_CreateOrUpdate",
  "$parameters": {
    "resource": {
      "$properties": {
        "properties": [
          {
            "securityPolicyConfigurations": [
              {
                "#name": "wafSecurityPolicy",
                "Description": {
                  "new": "Contains reference to a WAF-type security policy.",
                  "old": "Contains reference to a WAF-type security policy that is applied at the Traffic Controller level."
                }
              }
            ]
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "securityPolicyConfigurations": [
              {
                "#name": "wafSecurityPolicy",
                "Description": {
                  "new": "Contains reference to a WAF-type security policy.",
                  "old": "Contains reference to a WAF-type security policy that is applied at the Traffic Controller level."
                }
              }
            ]
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "securityPolicyConfigurations": [
              {
                "#name": "wafSecurityPolicy",
                "Description": {
                  "new": "Contains reference to a WAF-type security policy.",
                  "old": "Contains reference to a WAF-type security policy that is applied at the Traffic Controller level."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceNetworking/trafficControllers/{trafficControllerName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
trafficControllerName: string ,
resource:
{
properties:
{
configurationEndpoints:
[
string ,
]
,
frontends:
[
{
id: string ,
}
,
]
,
associations:
[
{
id: string ,
}
,
]
,
securityPolicies:
[
{
id: string ,
}
,
]
,
securityPolicyConfigurations:
{
wafSecurityPolicy:
{
id: string ,
}
,
}
,
provisioningState: enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
configurationEndpoints:
[
string ,
]
,
frontends:
[
{
id: string ,
}
,
]
,
associations:
[
{
id: string ,
}
,
]
,
securityPolicies:
[
{
id: string ,
}
,
]
,
securityPolicyConfigurations:
{
wafSecurityPolicy:
{
id: string ,
}
,
}
,
provisioningState: enum ,
}
,
}

⚐ Response (201)

{
$headers:
{
retry-after: integer ,
}
,
$schema:
{
properties:
{
configurationEndpoints:
[
string ,
]
,
frontends:
[
{
id: string ,
}
,
]
,
associations:
[
{
id: string ,
}
,
]
,
securityPolicies:
[
{
id: string ,
}
,
]
,
securityPolicyConfigurations:
{
wafSecurityPolicy:
{
id: string ,
}
,
}
,
provisioningState: enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
TrafficControllerInterface_Update (updated)
Description Update a TrafficController
Reference Link ¶

⚶ Changes

{
  "#id": "TrafficControllerInterface_Update",
  "$parameters": {
    "properties": {
      "$properties": {
        "properties": [
          {
            "securityPolicyConfigurations": [
              {
                "#name": "wafSecurityPolicy",
                "Description": {
                  "new": "Contains reference to a WAF-type security policy.",
                  "old": "Contains reference to a WAF-type security policy that is applied at the Traffic Controller level."
                }
              }
            ]
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "securityPolicyConfigurations": [
              {
                "#name": "wafSecurityPolicy",
                "Description": {
                  "new": "Contains reference to a WAF-type security policy.",
                  "old": "Contains reference to a WAF-type security policy that is applied at the Traffic Controller level."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceNetworking/trafficControllers/{trafficControllerName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
trafficControllerName: string ,
properties:
{
tags: object ,
properties:
{
securityPolicyConfigurations:
{
wafSecurityPolicy:
{
id: string ,
}
,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
configurationEndpoints:
[
string ,
]
,
frontends:
[
{
id: string ,
}
,
]
,
associations:
[
{
id: string ,
}
,
]
,
securityPolicies:
[
{
id: string ,
}
,
]
,
securityPolicyConfigurations:
{
wafSecurityPolicy:
{
id: string ,
}
,
}
,
provisioningState: enum ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
SecurityPoliciesInterface_ListByTrafficController (updated)
Description List SecurityPolicy resources by TrafficController
Reference Link ¶

⚶ Changes

{
  "#id": "SecurityPoliciesInterface_ListByTrafficController",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "#name": "wafPolicy",
                "Description": {
                  "new": "Web Application Firewall Policy of the Traffic Controller Security Policy. Single Security Policy can have only one policy type set.",
                  "old": "Web Application Firewall Policy of the Traffic Controller Security Policy"
                }
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceNetworking/trafficControllers/{trafficControllerName}/securityPolicies
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
trafficControllerName: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
policyType: enum ,
wafPolicy:
{
id: string ,
}
,
provisioningState: enum ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
SecurityPoliciesInterface_Get (updated)
Description Get a SecurityPolicy
Reference Link ¶

⚶ Changes

{
  "#id": "SecurityPoliciesInterface_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "wafPolicy",
            "Description": {
              "new": "Web Application Firewall Policy of the Traffic Controller Security Policy. Single Security Policy can have only one policy type set.",
              "old": "Web Application Firewall Policy of the Traffic Controller Security Policy"
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceNetworking/trafficControllers/{trafficControllerName}/securityPolicies/{securityPolicyName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
trafficControllerName: string ,
securityPolicyName: string ,
}

⚐ Response (200)

{
properties:
{
policyType: enum ,
wafPolicy:
{
id: string ,
}
,
provisioningState: enum ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
SecurityPoliciesInterface_CreateOrUpdate (updated)
Description Create a SecurityPolicy
Reference Link ¶

⚶ Changes

{
  "#id": "SecurityPoliciesInterface_CreateOrUpdate",
  "$parameters": {
    "resource": {
      "$properties": {
        "properties": [
          {
            "#name": "wafPolicy",
            "Description": {
              "new": "Web Application Firewall Policy of the Traffic Controller Security Policy. Single Security Policy can have only one policy type set.",
              "old": "Web Application Firewall Policy of the Traffic Controller Security Policy"
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "wafPolicy",
            "Description": {
              "new": "Web Application Firewall Policy of the Traffic Controller Security Policy. Single Security Policy can have only one policy type set.",
              "old": "Web Application Firewall Policy of the Traffic Controller Security Policy"
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "wafPolicy",
            "Description": {
              "new": "Web Application Firewall Policy of the Traffic Controller Security Policy. Single Security Policy can have only one policy type set.",
              "old": "Web Application Firewall Policy of the Traffic Controller Security Policy"
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceNetworking/trafficControllers/{trafficControllerName}/securityPolicies/{securityPolicyName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
trafficControllerName: string ,
securityPolicyName: string ,
resource:
{
properties:
{
policyType: enum ,
wafPolicy:
{
id: string ,
}
,
provisioningState: enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
policyType: enum ,
wafPolicy:
{
id: string ,
}
,
provisioningState: enum ,
}
,
}

⚐ Response (201)

{
$headers:
{
retry-after: integer ,
}
,
$schema:
{
properties:
{
policyType: enum ,
wafPolicy:
{
id: string ,
}
,
provisioningState: enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
SecurityPoliciesInterface_Update (updated)
Description Update a SecurityPolicy
Reference Link ¶

⚶ Changes

{
  "#id": "SecurityPoliciesInterface_Update",
  "$parameters": {
    "properties": {
      "$properties": {
        "properties": [
          {
            "#name": "wafPolicy",
            "Description": {
              "new": "Web Application Firewall Policy of the Traffic Controller Security Policy. Single Security Policy can have only one policy type set.",
              "old": "Web Application Firewall Policy of the Traffic Controller Security Policy"
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "wafPolicy",
            "Description": {
              "new": "Web Application Firewall Policy of the Traffic Controller Security Policy. Single Security Policy can have only one policy type set.",
              "old": "Web Application Firewall Policy of the Traffic Controller Security Policy"
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceNetworking/trafficControllers/{trafficControllerName}/securityPolicies/{securityPolicyName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
trafficControllerName: string ,
securityPolicyName: string ,
properties:
{
tags: object ,
properties:
{
wafPolicy:
{
id: string ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
policyType: enum ,
wafPolicy:
{
id: string ,
}
,
provisioningState: enum ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}