Microsoft.CognitiveServices (stable:2025-09-01)

2025/11/07 • 2 new, 2 updated methods

AccountCapabilityHosts_List (new)
Description :  List capabilityHost.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/capabilityHosts
{
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
accountName:
{
Description: The name of Cognitive Services account. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link to the next page of Capability Host objects. If null, there are no additional pages. ,
Required: False ,
}
string ,
value:
{
Description: An array of objects of type Capability Host. ,
Required: False ,
}
[
{
properties:
{
Description: [Required] Additional attributes of the entity. ,
Required: True ,
}
{
aiServicesConnections:
{
Description: List of AI services connections. ,
Required: False ,
}
[
string ,
]
,
capabilityHostKind:
{
Description: Kind of this capability host. ,
Enum:
{
Agents: No description available. ,
}
,
Required: False ,
}
enum ,
customerSubnet:
{
Description: Customer subnet info to help set up this capability host. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Provisioning state for the CapabilityHost. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
storageConnections:
{
Description: List of connection names from those available in the account or project to be used as a storage resource. ,
Required: False ,
}
[
string ,
]
,
threadStorageConnections:
{
Description: List of connection names from those available in the account or project to be used for Thread storage. ,
Required: False ,
}
[
string ,
]
,
vectorStoreConnections:
{
Description: List of connection names from those available in the account or project to be used for vector database (e.g. CosmosDB). ,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ProjectCapabilityHosts_List (new)
Description :  List capabilityHost.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/projects/{projectName}/capabilityHosts
{
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
accountName:
{
Description: The name of Cognitive Services account. ,
Required: True ,
}
string ,
projectName:
{
Description: The name of Cognitive Services account's project. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link to the next page of Project Capability Host objects. If null, there are no additional pages. ,
Required: False ,
}
string ,
value:
{
Description: An array of objects of type Project Capability Host. ,
Required: False ,
}
[
{
properties:
{
Description: [Required] Additional attributes of the entity. ,
Required: True ,
}
{
aiServicesConnections:
{
Description: List of AI services connections. ,
Required: False ,
}
[
string ,
]
,
vectorStoreConnections:
{
Description: List of connection names from those available in the account or project to be used for vector database (e.g. CosmosDB). ,
Required: False ,
}
[
string ,
]
,
storageConnections:
{
Description: List of connection names from those available in the account or project to be used as a storage resource. ,
Required: False ,
}
[
string ,
]
,
threadStorageConnections:
{
Description: List of connection names from those available in the account or project to be used for Thread storage. ,
Required: False ,
}
[
string ,
]
,
provisioningState:
{
Description: Provisioning state for the CapabilityHost. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ProjectCapabilityHosts_Get (updated)
Description :  Get project capabilityHost.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCapabilityHosts_Get",
  "$responses": {
    "200": {
      "Description": {
        "new": "Azure Resource Manager resource envelope for Project CapabilityHost.",
        "old": "Azure Resource Manager resource envelope."
      },
      "$properties": {
        "properties": [
          {
            "@removed_5d9333c60a3144e295b670ff9f4db1fa": {
              "#name": "capabilityHostKind",
              "Description": "Kind of this capability host.",
              "Enum": [
                [
                  "Agents",
                  ""
                ]
              ],
              "Required": false,
              "Type": "string"
            }
          },
          {
            "@removed_f949f929a46b44d78e4f2559973eae5c": {
              "#name": "customerSubnet",
              "Description": "Customer subnet info to help set up this capability host.",
              "Required": false,
              "Type": "string"
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/projects/{projectName}/capabilityHosts/{capabilityHostName}
{
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
accountName:
{
Description: The name of Cognitive Services account. ,
Required: True ,
}
string ,
projectName:
{
Description: The name of Cognitive Services account's project. ,
Required: True ,
}
string ,
capabilityHostName:
{
Description: The name of the capability host associated with the Cognitive Services Resource ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: [Required] Additional attributes of the entity. ,
Required: True ,
}
{
aiServicesConnections:
{
Description: List of AI services connections. ,
Required: False ,
}
[
string ,
]
,
vectorStoreConnections:
{
Description: List of connection names from those available in the account or project to be used for vector database (e.g. CosmosDB). ,
Required: False ,
}
[
string ,
]
,
storageConnections:
{
Description: List of connection names from those available in the account or project to be used as a storage resource. ,
Required: False ,
}
[
string ,
]
,
threadStorageConnections:
{
Description: List of connection names from those available in the account or project to be used for Thread storage. ,
Required: False ,
}
[
string ,
]
,
provisioningState:
{
Description: Provisioning state for the CapabilityHost. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ProjectCapabilityHosts_CreateOrUpdate (updated)
Description :  Create or update project capabilityHost.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCapabilityHosts_CreateOrUpdate",
  "$parameters": {
    "capabilityHost": {
      "Description": {
        "new": "Azure Resource Manager resource envelope for Project CapabilityHost.",
        "old": "Azure Resource Manager resource envelope."
      },
      "$properties": {
        "properties": [
          {
            "@removed_4975bd93cf1f40fa97c37f5f82212da4": {
              "#name": "capabilityHostKind",
              "Description": "Kind of this capability host.",
              "Enum": [
                [
                  "Agents",
                  ""
                ]
              ],
              "Required": false,
              "Type": "string"
            }
          },
          {
            "@removed_459254cf934e489dabd8ed1a64b18321": {
              "#name": "customerSubnet",
              "Description": "Customer subnet info to help set up this capability host.",
              "Required": false,
              "Type": "string"
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "Description": {
        "new": "Azure Resource Manager resource envelope for Project CapabilityHost.",
        "old": "Azure Resource Manager resource envelope."
      },
      "$properties": {
        "properties": [
          {
            "@removed_fb61cdfa3b54420c8acc6404b6cf0ab5": {
              "#name": "capabilityHostKind",
              "Description": "Kind of this capability host.",
              "Enum": [
                [
                  "Agents",
                  ""
                ]
              ],
              "Required": false,
              "Type": "string"
            }
          },
          {
            "@removed_9ae06fefe6374139ba8458cca801a726": {
              "#name": "customerSubnet",
              "Description": "Customer subnet info to help set up this capability host.",
              "Required": false,
              "Type": "string"
            }
          }
        ]
      }
    },
    "201": {
      "Description": {
        "new": "Azure Resource Manager resource envelope for Project CapabilityHost.",
        "old": "Azure Resource Manager resource envelope."
      },
      "$properties": {
        "properties": [
          {
            "@removed_67d47dd141bf4240a4581980fb630543": {
              "#name": "capabilityHostKind",
              "Description": "Kind of this capability host.",
              "Enum": [
                [
                  "Agents",
                  ""
                ]
              ],
              "Required": false,
              "Type": "string"
            }
          },
          {
            "@removed_7f4efbf185084524a93701039d2b1db7": {
              "#name": "customerSubnet",
              "Description": "Customer subnet info to help set up this capability host.",
              "Required": false,
              "Type": "string"
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/projects/{projectName}/capabilityHosts/{capabilityHostName}
{
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
accountName:
{
Description: The name of Cognitive Services account. ,
Required: True ,
}
string ,
projectName:
{
Description: The name of Cognitive Services account's project. ,
Required: True ,
}
string ,
capabilityHostName:
{
Description: The name of the capability host associated with the Cognitive Services Resource ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
capabilityHost:
{
Description: CapabilityHost definition. ,
Required: True ,
}
{
properties:
{
Description: [Required] Additional attributes of the entity. ,
Required: True ,
}
{
aiServicesConnections:
{
Description: List of AI services connections. ,
Required: False ,
}
[
string ,
]
,
vectorStoreConnections:
{
Description: List of connection names from those available in the account or project to be used for vector database (e.g. CosmosDB). ,
Required: False ,
}
[
string ,
]
,
storageConnections:
{
Description: List of connection names from those available in the account or project to be used as a storage resource. ,
Required: False ,
}
[
string ,
]
,
threadStorageConnections:
{
Description: List of connection names from those available in the account or project to be used for Thread storage. ,
Required: False ,
}
[
string ,
]
,
provisioningState:
{
Description: Provisioning state for the CapabilityHost. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: [Required] Additional attributes of the entity. ,
Required: True ,
}
{
aiServicesConnections:
{
Description: List of AI services connections. ,
Required: False ,
}
[
string ,
]
,
vectorStoreConnections:
{
Description: List of connection names from those available in the account or project to be used for vector database (e.g. CosmosDB). ,
Required: False ,
}
[
string ,
]
,
storageConnections:
{
Description: List of connection names from those available in the account or project to be used as a storage resource. ,
Required: False ,
}
[
string ,
]
,
threadStorageConnections:
{
Description: List of connection names from those available in the account or project to be used for Thread storage. ,
Required: False ,
}
[
string ,
]
,
provisioningState:
{
Description: Provisioning state for the CapabilityHost. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
$headers:
{
x-ms-async-operation-timeout:
{
Description: Timeout for the client to use when polling the asynchronous operation. ,
}
string ,
azure-asyncoperation:
{
Description: URI to poll for asynchronous operation status. ,
}
string ,
}
,
$schema:
{
Description: Azure Resource Manager resource envelope for Project CapabilityHost. ,
}
{
properties:
{
Description: [Required] Additional attributes of the entity. ,
Required: True ,
}
{
aiServicesConnections:
{
Description: List of AI services connections. ,
Required: False ,
}
[
string ,
]
,
vectorStoreConnections:
{
Description: List of connection names from those available in the account or project to be used for vector database (e.g. CosmosDB). ,
Required: False ,
}
[
string ,
]
,
storageConnections:
{
Description: List of connection names from those available in the account or project to be used as a storage resource. ,
Required: False ,
}
[
string ,
]
,
threadStorageConnections:
{
Description: List of connection names from those available in the account or project to be used for Thread storage. ,
Required: False ,
}
[
string ,
]
,
provisioningState:
{
Description: Provisioning state for the CapabilityHost. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}