Microsoft.CognitiveServices (preview:2025-07-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_f6f3f4c9964040279e248c1b798c226f": {
              "#name": "capabilityHostKind",
              "Description": "Kind of this capability host.",
              "Enum": [
                [
                  "Agents",
                  ""
                ]
              ],
              "Required": false,
              "Type": "string"
            }
          },
          {
            "@removed_ee30bed6f7494d3d930f1937c570b3ca": {
              "#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_f9f5d63f339f46efb95bc3cf63af20f6": {
              "#name": "capabilityHostKind",
              "Description": "Kind of this capability host.",
              "Enum": [
                [
                  "Agents",
                  ""
                ]
              ],
              "Required": false,
              "Type": "string"
            }
          },
          {
            "@removed_00358ff6f20143d084fb463b63a69666": {
              "#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_9c48be48d8db4037ba74fb3d7b371077": {
              "#name": "capabilityHostKind",
              "Description": "Kind of this capability host.",
              "Enum": [
                [
                  "Agents",
                  ""
                ]
              ],
              "Required": false,
              "Type": "string"
            }
          },
          {
            "@removed_de4ccc224ee246c18135b5b5c8528433": {
              "#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_9955f84f43f2426f8589b844296f2a8e": {
              "#name": "capabilityHostKind",
              "Description": "Kind of this capability host.",
              "Enum": [
                [
                  "Agents",
                  ""
                ]
              ],
              "Required": false,
              "Type": "string"
            }
          },
          {
            "@removed_a8c87b11a19d43aa802214a7ab311129": {
              "#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 ,
}
,
]
,
}
,
}