Microsoft.Edge (stable:2025-08-01)

2025/09/08 • 5 updated methods

Contexts_ListBySubscription (updated)
Description :  List by subscription
Reference :  Link ¶

⚶ Changes

{
  "#id": "Contexts_ListBySubscription",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "capabilities": {
                  "Description": {
                    "new": "Capability, to match in Solution Templates and Targets",
                    "old": "Capability, to match in Solution Templates & Targets"
                  }
                }
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Edge/contexts
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The Context items on this page ,
Required: True ,
}
[
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
capabilities:
{
Description: List of Capabilities ,
Required: True ,
}
[
{
name:
{
Description: Name of Capability ,
Required: True ,
}
string ,
description:
{
Description: Description of Capability ,
Required: True ,
}
string ,
state:
{
Description: State of resource ,
Enum:
{
active: Resource is active ,
inactive: Resource is inactive ,
}
,
Required: False ,
}
enum ,
}
,
]
,
hierarchies:
{
Description: List of Hierarchies ,
Required: True ,
}
[
{
name:
{
Description: Name of Hierarchy ,
Required: True ,
}
string ,
description:
{
Description: Description of Hierarchy ,
Required: True ,
}
string ,
}
,
]
,
provisioningState:
{
Description: Provisioning state of resource ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Initialized: Resource Provisioning is initialized ,
InProgress: Resource Provisioning is in progress ,
Deleting: Resource Provisioning is deleting ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Contexts_ListByResourceGroup (updated)
Description :  List by specified resource group
Reference :  Link ¶

⚶ Changes

{
  "#id": "Contexts_ListByResourceGroup",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "capabilities": {
                  "Description": {
                    "new": "Capability, to match in Solution Templates and Targets",
                    "old": "Capability, to match in Solution Templates & Targets"
                  }
                }
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Edge/contexts
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The Context items on this page ,
Required: True ,
}
[
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
capabilities:
{
Description: List of Capabilities ,
Required: True ,
}
[
{
name:
{
Description: Name of Capability ,
Required: True ,
}
string ,
description:
{
Description: Description of Capability ,
Required: True ,
}
string ,
state:
{
Description: State of resource ,
Enum:
{
active: Resource is active ,
inactive: Resource is inactive ,
}
,
Required: False ,
}
enum ,
}
,
]
,
hierarchies:
{
Description: List of Hierarchies ,
Required: True ,
}
[
{
name:
{
Description: Name of Hierarchy ,
Required: True ,
}
string ,
description:
{
Description: Description of Hierarchy ,
Required: True ,
}
string ,
}
,
]
,
provisioningState:
{
Description: Provisioning state of resource ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Initialized: Resource Provisioning is initialized ,
InProgress: Resource Provisioning is in progress ,
Deleting: Resource Provisioning is deleting ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Contexts_Get (updated)
Description :  Get Context Resource
Reference :  Link ¶

⚶ Changes

{
  "#id": "Contexts_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "capabilities": {
              "Description": {
                "new": "Capability, to match in Solution Templates and Targets",
                "old": "Capability, to match in Solution Templates & Targets"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Edge/contexts/{contextName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
contextName:
{
Description: The name of the Context. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
capabilities:
{
Description: List of Capabilities ,
Required: True ,
}
[
{
name:
{
Description: Name of Capability ,
Required: True ,
}
string ,
description:
{
Description: Description of Capability ,
Required: True ,
}
string ,
state:
{
Description: State of resource ,
Enum:
{
active: Resource is active ,
inactive: Resource is inactive ,
}
,
Required: False ,
}
enum ,
}
,
]
,
hierarchies:
{
Description: List of Hierarchies ,
Required: True ,
}
[
{
name:
{
Description: Name of Hierarchy ,
Required: True ,
}
string ,
description:
{
Description: Description of Hierarchy ,
Required: True ,
}
string ,
}
,
]
,
provisioningState:
{
Description: Provisioning state of resource ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Initialized: Resource Provisioning is initialized ,
InProgress: Resource Provisioning is in progress ,
Deleting: Resource Provisioning is deleting ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Contexts_CreateOrUpdate (updated)
Description :  Create or update Context Resource
Reference :  Link ¶

⚶ Changes

{
  "#id": "Contexts_CreateOrUpdate",
  "$parameters": {
    "resource": {
      "$properties": {
        "properties": [
          {
            "capabilities": {
              "Description": {
                "new": "Capability, to match in Solution Templates and Targets",
                "old": "Capability, to match in Solution Templates & Targets"
              }
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "capabilities": {
              "Description": {
                "new": "Capability, to match in Solution Templates and Targets",
                "old": "Capability, to match in Solution Templates & Targets"
              }
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "capabilities": {
              "Description": {
                "new": "Capability, to match in Solution Templates and Targets",
                "old": "Capability, to match in Solution Templates & Targets"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Edge/contexts/{contextName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
contextName:
{
Description: The name of the Context. ,
Required: True ,
}
string ,
resource:
{
Description: Resource create parameters. ,
Required: True ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
capabilities:
{
Description: List of Capabilities ,
Required: True ,
}
[
{
name:
{
Description: Name of Capability ,
Required: True ,
}
string ,
description:
{
Description: Description of Capability ,
Required: True ,
}
string ,
state:
{
Description: State of resource ,
Enum:
{
active: Resource is active ,
inactive: Resource is inactive ,
}
,
Required: False ,
}
enum ,
}
,
]
,
hierarchies:
{
Description: List of Hierarchies ,
Required: True ,
}
[
{
name:
{
Description: Name of Hierarchy ,
Required: True ,
}
string ,
description:
{
Description: Description of Hierarchy ,
Required: True ,
}
string ,
}
,
]
,
provisioningState:
{
Description: Provisioning state of resource ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Initialized: Resource Provisioning is initialized ,
InProgress: Resource Provisioning is in progress ,
Deleting: Resource Provisioning is deleting ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
capabilities:
{
Description: List of Capabilities ,
Required: True ,
}
[
{
name:
{
Description: Name of Capability ,
Required: True ,
}
string ,
description:
{
Description: Description of Capability ,
Required: True ,
}
string ,
state:
{
Description: State of resource ,
Enum:
{
active: Resource is active ,
inactive: Resource is inactive ,
}
,
Required: False ,
}
enum ,
}
,
]
,
hierarchies:
{
Description: List of Hierarchies ,
Required: True ,
}
[
{
name:
{
Description: Name of Hierarchy ,
Required: True ,
}
string ,
description:
{
Description: Description of Hierarchy ,
Required: True ,
}
string ,
}
,
]
,
provisioningState:
{
Description: Provisioning state of resource ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Initialized: Resource Provisioning is initialized ,
InProgress: Resource Provisioning is in progress ,
Deleting: Resource Provisioning is deleting ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
$headers:
{
azure-asyncoperation:
{
Description: A link to the status monitor ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}
,
$schema:
{
Description: Context Resource ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
capabilities:
{
Description: List of Capabilities ,
Required: True ,
}
[
{
name:
{
Description: Name of Capability ,
Required: True ,
}
string ,
description:
{
Description: Description of Capability ,
Required: True ,
}
string ,
state:
{
Description: State of resource ,
Enum:
{
active: Resource is active ,
inactive: Resource is inactive ,
}
,
Required: False ,
}
enum ,
}
,
]
,
hierarchies:
{
Description: List of Hierarchies ,
Required: True ,
}
[
{
name:
{
Description: Name of Hierarchy ,
Required: True ,
}
string ,
description:
{
Description: Description of Hierarchy ,
Required: True ,
}
string ,
}
,
]
,
provisioningState:
{
Description: Provisioning state of resource ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Initialized: Resource Provisioning is initialized ,
InProgress: Resource Provisioning is in progress ,
Deleting: Resource Provisioning is deleting ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Contexts_Update (updated)
Description :  update an Context Resource
Reference :  Link ¶

⚶ Changes

{
  "#id": "Contexts_Update",
  "$parameters": {
    "properties": {
      "$properties": {
        "properties": [
          {
            "capabilities": {
              "Description": {
                "new": "Capability, to match in Solution Templates and Targets",
                "old": "Capability, to match in Solution Templates & Targets"
              }
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "capabilities": {
              "Description": {
                "new": "Capability, to match in Solution Templates and Targets",
                "old": "Capability, to match in Solution Templates & Targets"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Edge/contexts/{contextName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
contextName:
{
Description: The name of the Context. ,
Required: True ,
}
string ,
properties:
{
Description: The resource properties to be updated. ,
Required: True ,
}
{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
capabilities:
{
Description: List of Capabilities ,
Required: False ,
}
[
{
name:
{
Description: Name of Capability ,
Required: True ,
}
string ,
description:
{
Description: Description of Capability ,
Required: True ,
}
string ,
state:
{
Description: State of resource ,
Enum:
{
active: Resource is active ,
inactive: Resource is inactive ,
}
,
Required: False ,
}
enum ,
}
,
]
,
hierarchies:
{
Description: List of Hierarchies ,
Required: False ,
}
[
{
name:
{
Description: Name of Hierarchy ,
Required: True ,
}
string ,
description:
{
Description: Description of Hierarchy ,
Required: True ,
}
string ,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
capabilities:
{
Description: List of Capabilities ,
Required: True ,
}
[
{
name:
{
Description: Name of Capability ,
Required: True ,
}
string ,
description:
{
Description: Description of Capability ,
Required: True ,
}
string ,
state:
{
Description: State of resource ,
Enum:
{
active: Resource is active ,
inactive: Resource is inactive ,
}
,
Required: False ,
}
enum ,
}
,
]
,
hierarchies:
{
Description: List of Hierarchies ,
Required: True ,
}
[
{
name:
{
Description: Name of Hierarchy ,
Required: True ,
}
string ,
description:
{
Description: Description of Hierarchy ,
Required: True ,
}
string ,
}
,
]
,
provisioningState:
{
Description: Provisioning state of resource ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Initialized: Resource Provisioning is initialized ,
InProgress: Resource Provisioning is in progress ,
Deleting: Resource Provisioning is deleting ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}