Microsoft.CognitiveServices (preview:2025-04-01)

2025/05/06 • 4 updated methods

Deployments_List (updated)
Description Gets the deployments associated with the Cognitive Services account.
Reference Link ¶

⚶ Changes

{
  "#id": "Deployments_List",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "@added_302a31696afa4c82909c1bbb6fb646d5": {
                  "#name": "spilloverDeploymentName",
                  "Description": "Specifies the deployment name that should serve requests when the request would have otherwise been throttled due to reaching current deployment throughput limit.",
                  "Required": false,
                  "Type": "string"
                }
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments
{
resourceGroupName: string ,
accountName: string ,
api-version: string ,
subscriptionId: string ,
}

⚐ Response (200)

{
nextLink: string ,
value:
[
{
sku:
{
name: string ,
tier: enum ,
size: string ,
family: string ,
capacity: integer ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
etag: string ,
tags: object ,
properties:
{
provisioningState: enum ,
model:
{
publisher: string ,
format: string ,
name: string ,
version: string ,
source: string ,
sourceAccount: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
}
,
scaleSettings:
{
scaleType: enum ,
capacity: integer ,
activeCapacity: integer ,
}
,
capabilities: object ,
raiPolicyName: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
rateLimits:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
versionUpgradeOption: enum ,
dynamicThrottlingEnabled: boolean ,
currentCapacity: integer ,
capacitySettings:
{
designatedCapacity: integer ,
priority: integer ,
}
,
parentDeploymentName: string ,
spilloverDeploymentName: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Deployments_Get (updated)
Description Gets the specified deployments associated with the Cognitive Services account.
Reference Link ¶

⚶ Changes

{
  "#id": "Deployments_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "@added_f343e39e391e4076bf38c1b4daf63e3f": {
              "#name": "spilloverDeploymentName",
              "Description": "Specifies the deployment name that should serve requests when the request would have otherwise been throttled due to reaching current deployment throughput limit.",
              "Required": false,
              "Type": "string"
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}
{
resourceGroupName: string ,
accountName: string ,
api-version: string ,
subscriptionId: string ,
deploymentName: string ,
}

⚐ Response (200)

{
sku:
{
name: string ,
tier: enum ,
size: string ,
family: string ,
capacity: integer ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
etag: string ,
tags: object ,
properties:
{
provisioningState: enum ,
model:
{
publisher: string ,
format: string ,
name: string ,
version: string ,
source: string ,
sourceAccount: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
}
,
scaleSettings:
{
scaleType: enum ,
capacity: integer ,
activeCapacity: integer ,
}
,
capabilities: object ,
raiPolicyName: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
rateLimits:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
versionUpgradeOption: enum ,
dynamicThrottlingEnabled: boolean ,
currentCapacity: integer ,
capacitySettings:
{
designatedCapacity: integer ,
priority: integer ,
}
,
parentDeploymentName: string ,
spilloverDeploymentName: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Deployments_CreateOrUpdate (updated)
Description Update the state of specified deployments associated with the Cognitive Services account.
Reference Link ¶

⚶ Changes

{
  "#id": "Deployments_CreateOrUpdate",
  "$parameters": {
    "deployment": {
      "$properties": {
        "properties": [
          {
            "@added_ab370a80b0584398804b6a28b8014d6b": {
              "#name": "spilloverDeploymentName",
              "Description": "Specifies the deployment name that should serve requests when the request would have otherwise been throttled due to reaching current deployment throughput limit.",
              "Required": false,
              "Type": "string"
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "@added_e9709c532b304fdf90831acab434178b": {
              "#name": "spilloverDeploymentName",
              "Description": "Specifies the deployment name that should serve requests when the request would have otherwise been throttled due to reaching current deployment throughput limit.",
              "Required": false,
              "Type": "string"
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "@added_e8c364e9088e4807a198d25d63d00c40": {
              "#name": "spilloverDeploymentName",
              "Description": "Specifies the deployment name that should serve requests when the request would have otherwise been throttled due to reaching current deployment throughput limit.",
              "Required": false,
              "Type": "string"
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}
{
resourceGroupName: string ,
accountName: string ,
api-version: string ,
subscriptionId: string ,
deploymentName: string ,
deployment:
{
sku:
{
name: string ,
tier: enum ,
size: string ,
family: string ,
capacity: integer ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
etag: string ,
tags: object ,
properties:
{
provisioningState: enum ,
model:
{
publisher: string ,
format: string ,
name: string ,
version: string ,
source: string ,
sourceAccount: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
}
,
scaleSettings:
{
scaleType: enum ,
capacity: integer ,
activeCapacity: integer ,
}
,
capabilities: object ,
raiPolicyName: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
rateLimits:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
versionUpgradeOption: enum ,
dynamicThrottlingEnabled: boolean ,
currentCapacity: integer ,
capacitySettings:
{
designatedCapacity: integer ,
priority: integer ,
}
,
parentDeploymentName: string ,
spilloverDeploymentName: string ,
}
,
}
,
}

⚐ Response (200)

{
sku:
{
name: string ,
tier: enum ,
size: string ,
family: string ,
capacity: integer ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
etag: string ,
tags: object ,
properties:
{
provisioningState: enum ,
model:
{
publisher: string ,
format: string ,
name: string ,
version: string ,
source: string ,
sourceAccount: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
}
,
scaleSettings:
{
scaleType: enum ,
capacity: integer ,
activeCapacity: integer ,
}
,
capabilities: object ,
raiPolicyName: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
rateLimits:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
versionUpgradeOption: enum ,
dynamicThrottlingEnabled: boolean ,
currentCapacity: integer ,
capacitySettings:
{
designatedCapacity: integer ,
priority: integer ,
}
,
parentDeploymentName: string ,
spilloverDeploymentName: string ,
}
,
}

⚐ Response (201)

{
sku:
{
name: string ,
tier: enum ,
size: string ,
family: string ,
capacity: integer ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
etag: string ,
tags: object ,
properties:
{
provisioningState: enum ,
model:
{
publisher: string ,
format: string ,
name: string ,
version: string ,
source: string ,
sourceAccount: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
}
,
scaleSettings:
{
scaleType: enum ,
capacity: integer ,
activeCapacity: integer ,
}
,
capabilities: object ,
raiPolicyName: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
rateLimits:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
versionUpgradeOption: enum ,
dynamicThrottlingEnabled: boolean ,
currentCapacity: integer ,
capacitySettings:
{
designatedCapacity: integer ,
priority: integer ,
}
,
parentDeploymentName: string ,
spilloverDeploymentName: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Deployments_Update (updated)
Description Update specified deployments associated with the Cognitive Services account.
Reference Link ¶

⚶ Changes

{
  "#id": "Deployments_Update",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "@added_e7d0cc1b865a495981c35f80bb2966d7": {
              "#name": "spilloverDeploymentName",
              "Description": "Specifies the deployment name that should serve requests when the request would have otherwise been throttled due to reaching current deployment throughput limit.",
              "Required": false,
              "Type": "string"
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}
{
resourceGroupName: string ,
accountName: string ,
api-version: string ,
subscriptionId: string ,
deploymentName: string ,
deployment:
{
sku:
{
name: string ,
tier: enum ,
size: string ,
family: string ,
capacity: integer ,
}
,
}
,
}

⚐ Response (200)

{
sku:
{
name: string ,
tier: enum ,
size: string ,
family: string ,
capacity: integer ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
etag: string ,
tags: object ,
properties:
{
provisioningState: enum ,
model:
{
publisher: string ,
format: string ,
name: string ,
version: string ,
source: string ,
sourceAccount: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
}
,
scaleSettings:
{
scaleType: enum ,
capacity: integer ,
activeCapacity: integer ,
}
,
capabilities: object ,
raiPolicyName: string ,
callRateLimit:
{
count: number ,
renewalPeriod: number ,
rules:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
}
,
rateLimits:
[
{
key: string ,
renewalPeriod: number ,
count: number ,
minCount: number ,
dynamicThrottlingEnabled: boolean ,
matchPatterns:
[
{
path: string ,
method: string ,
}
,
]
,
}
,
]
,
versionUpgradeOption: enum ,
dynamicThrottlingEnabled: boolean ,
currentCapacity: integer ,
capacitySettings:
{
designatedCapacity: integer ,
priority: integer ,
}
,
parentDeploymentName: string ,
spilloverDeploymentName: string ,
}
,
}

⚐ Response (202)

{
location: string ,
}

⚐ Response (default)

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