Microsoft.DevCenter (preview:2025-07-01)

2025/09/16 • 22 new, 101 updated, 22 deleted methods

NetworkConnections_ListBySubscription (new)
Description :  Lists network connections in a subscription
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.DevCenter/networkConnections
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
Skus_ListBySubscription (new)
Description :  Lists the Microsoft.DevCenter SKUs available in a subscription
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.DevCenter/skus
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
resourceType:
{
Description: The name of the resource type ,
Required: False ,
}
string ,
locations:
{
Description: SKU supported locations. ,
Required: False ,
}
[
string ,
]
,
capabilities:
{
Description: Collection of name/value pairs to describe the SKU capabilities. ,
Required: False ,
}
[
{
name:
{
Description: Name of the capability. ,
Required: False ,
}
string ,
value:
{
Description: Value of the capability. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
NetworkConnections_ListByResourceGroup (new)
Description :  Lists network connections in a resource group
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
NetworkConnections_Get (new)
Description :  Gets a network connection resource
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}
{}

⚐ Response (200)

{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
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 ,
}
,
]
,
}
,
}
NetworkConnections_CreateOrUpdate (new)
Description :  Creates or updates a Network Connections resource
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}
{
body:
{
Description: Represents network connection ,
Required: True ,
}
{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
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 ,
}
,
]
,
}
,
}
NetworkConnections_Update (new)
Description :  Partially updates a Network Connection
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}
{
body:
{
Description: Represents network connection ,
Required: True ,
}
{
properties:
{
Description: Properties of a network connection resource to be updated. ,
Required: False ,
}
{
subnetId:
{
Description: The subnet to attach Virtual Machines to ,
Required: False ,
}
string ,
domainName:
{
Description: Active Directory domain name ,
Required: False ,
}
string ,
organizationUnit:
{
Description: Active Directory domain Organization Unit (OU) ,
Required: False ,
}
string ,
domainUsername:
{
Description: The username of an Active Directory account (user or service account) that has permissions to create computer objects in Active Directory. Required format: admin@contoso.com. ,
Required: False ,
}
string ,
domainPassword:
{
Description: The password for the account used to join domain ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (202)

{
location: 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 ,
}
,
]
,
}
,
}
NetworkConnections_Delete (new)
Description :  Deletes a Network Connections resource
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}
{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
NetworkConnections_ListHealthDetails (new)
Description :  Lists health check status details
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}/healthChecks
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
properties:
{
Description: Health check status details properties. ,
Required: False ,
}
{
startDateTime:
{
Description: Start time of last execution of the health checks. ,
Format: date-time ,
Required: False ,
}
string ,
endDateTime:
{
Description: End time of last execution of the health checks. ,
Format: date-time ,
Required: False ,
}
string ,
healthChecks:
{
Description: Details for each health check item. ,
Required: False ,
}
[
{
status:
{
Description: The status of the health check item. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
displayName:
{
Description: The display name of this health check item. ,
Required: False ,
}
string ,
startDateTime:
{
Description: Start time of health check item. ,
Format: date-time ,
Required: False ,
}
string ,
endDateTime:
{
Description: End time of the health check item. ,
Format: date-time ,
Required: False ,
}
string ,
errorType:
{
Description: The type of error that occurred during this health check. ,
Required: False ,
}
string ,
recommendedAction:
{
Description: The recommended action to fix the corresponding error. ,
Required: False ,
}
string ,
additionalDetails:
{
Description: Additional details about the health check or the recommended action. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
NetworkConnections_GetHealthDetails (new)
Description :  Gets health check status details.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}/healthChecks/latest
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
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 ,
networkConnectionName:
{
Description: Name of the Network Connection that can be applied to a Pool. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Health check status details properties. ,
Required: False ,
}
{
startDateTime:
{
Description: Start time of last execution of the health checks. ,
Format: date-time ,
Required: False ,
}
string ,
endDateTime:
{
Description: End time of last execution of the health checks. ,
Format: date-time ,
Required: False ,
}
string ,
healthChecks:
{
Description: Details for each health check item. ,
Required: False ,
}
[
{
status:
{
Description: The status of the health check item. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
displayName:
{
Description: The display name of this health check item. ,
Required: False ,
}
string ,
startDateTime:
{
Description: Start time of health check item. ,
Format: date-time ,
Required: False ,
}
string ,
endDateTime:
{
Description: End time of the health check item. ,
Format: date-time ,
Required: False ,
}
string ,
errorType:
{
Description: The type of error that occurred during this health check. ,
Required: False ,
}
string ,
recommendedAction:
{
Description: The recommended action to fix the corresponding error. ,
Required: False ,
}
string ,
additionalDetails:
{
Description: Additional details about the health check or the recommended action. ,
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 ,
}
,
]
,
}
,
}
NetworkConnections_ListOutboundNetworkDependenciesEndpoints (new)
Description :  Lists the endpoints that agents may call as part of Dev Box service administration. These FQDNs should be allowed for outbound access in order for the Dev Box service to function.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}/outboundNetworkDependenciesEndpoints
{}

⚐ Response (200)

{
value:
{
Description: The collection of outbound network dependency endpoints returned by the listing operation. ,
Required: False ,
}
[
{
category:
{
Description: The type of service that the agent connects to. ,
Required: False ,
}
string ,
endpoints:
{
Description: The endpoints for this service for which the agent requires outbound access. ,
Required: False ,
}
[
{
domainName:
{
Description: The domain name of the dependency. Domain names may be fully qualified or may contain a * wildcard. ,
Required: False ,
}
string ,
description:
{
Description: Human-readable supplemental information about the dependency and when it is applicable. ,
Required: False ,
}
string ,
endpointDetails:
{
Description: The list of connection details for this endpoint. ,
Required: False ,
}
[
{
port:
{
Description: The port an endpoint is connected to. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
]
,
}
,
]
,
nextLink:
{
Description: The continuation token. ,
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 ,
}
,
]
,
}
,
}
NetworkConnections_RunHealthChecks (new)
Description :  Triggers a new health check run. The execution and health check result can be tracked via the network Connection health check details
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}/runHealthChecks
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
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 ,
networkConnectionName:
{
Description: Name of the Network Connection that can be applied to a Pool. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location: 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 ,
}
,
]
,
}
,
}
Pools_ListByProject (new)
Description :  Lists pools for a project
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
Pools_Get (new)
Description :  Gets a machine pool
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}
{}

⚐ Response (200)

{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: 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 ,
}
,
]
,
}
,
}
Pools_CreateOrUpdate (new)
Description :  Creates or updates a machine pool
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}
{
body:
{
Description: Represents a machine pool ,
Required: True ,
}
{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: 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 ,
}
,
]
,
}
,
}
Pools_Update (new)
Description :  Partially updates a machine pool
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}
{
body:
{
Description: Represents a machine pool ,
Required: True ,
}
{
properties:
{
Description: Properties of a pool to be updated. ,
Required: False ,
}
{
devBoxDefinitionType:
{
Description: Indicates if the pool is created from an existing Dev Box Definition or if one is provided directly. ,
Enum:
{
Reference: No description available. ,
Value: No description available. ,
}
,
Required: False ,
}
enum ,
devBoxDefinitionName:
{
Description: Name of a Dev Box definition in parent Project of this Pool. Will be ignored if devBoxDefinitionType is Value. ,
Required: False ,
}
string ,
devBoxDefinition:
{
Description: A definition of the machines that are created from this Pool. Will be ignored if devBoxDefinitionType is Reference or not provided. ,
Required: False ,
}
{
imageReference:
{
Description: Image reference information. ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
sku:
{
Description: The SKU for Dev Boxes created from the Pool. ,
Required: False ,
}
{
name:
{
Description: The name of the SKU. E.g. P3. It is typically a letter+number code ,
Required: True ,
}
string ,
tier:
{
Description: This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT. ,
Enum:
{
Free: No description available. ,
Basic: No description available. ,
Standard: No description available. ,
Premium: No description available. ,
}
,
Required: False ,
}
enum ,
size:
{
Description: The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code. ,
Required: False ,
}
string ,
family:
{
Description: If the service has different generations of hardware, for the same SKU, then that can be captured here. ,
Required: False ,
}
string ,
capacity:
{
Description: If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
}
,
networkConnectionName:
{
Description: Name of a Network Connection in parent Project of this Pool ,
Required: False ,
}
string ,
licenseType:
{
Description: Specifies the license type indicating the caller has already acquired licenses for the Dev Boxes that will be created. ,
Enum:
{
Windows_Client: No description available. ,
}
,
Required: False ,
}
enum ,
localAdministrator:
{
Description: Indicates whether owners of Dev Boxes in this pool are added as local administrators on the Dev Box. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
stopOnDisconnect:
{
Description: Stop on disconnect configuration settings for Dev Boxes created in this pool. ,
Required: False ,
}
{
status:
{
Description: Whether the feature to stop the Dev Box on disconnect once the grace period has lapsed is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
gracePeriodMinutes:
{
Description: The specified time in minutes to wait before stopping a Dev Box once disconnect is detected. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
stopOnNoConnect:
{
Description: Stop on no connect configuration settings for Dev Boxes created in this pool. ,
Required: False ,
}
{
status:
{
Description: Enables the feature to stop a started Dev Box when it has not been connected to, once the grace period has lapsed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
gracePeriodMinutes:
{
Description: The specified time in minutes to wait before stopping a Dev Box if no connection is made. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
singleSignOnStatus:
{
Description: Indicates whether Dev Boxes in this pool are created with single sign on enabled. The also requires that single sign on be enabled on the tenant. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
displayName:
{
Description: The display name of the pool. ,
Required: False ,
}
string ,
virtualNetworkType:
{
Description: Indicates whether the pool uses a Virtual Network managed by Microsoft or a customer provided network. ,
Enum:
{
Managed: No description available. ,
Unmanaged: No description available. ,
}
,
Required: False ,
}
enum ,
managedVirtualNetworkRegions:
{
Description: The regions of the managed virtual network (required when managedNetworkType is Managed). ,
Required: False ,
}
[
string ,
]
,
activeHoursConfiguration:
{
Description: Active hours configuration settings for Dev Boxes created in this pool. ,
Required: False ,
}
{
keepAwakeEnableStatus:
{
Description: Enables or disables whether the Dev Box should be kept awake during active hours. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
autoStartEnableStatus:
{
Description: Enables or disables whether the Dev Box should be automatically started at commencement of active hours. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
defaultTimeZone:
{
Description: The default IANA timezone id of the active hours. ,
Required: False ,
}
string ,
defaultStartTimeHour:
{
Description: The default start time of the active hours. ,
Format: int32 ,
Required: False ,
}
integer ,
defaultEndTimeHour:
{
Description: The default end time of the active hours ,
Format: int32 ,
Required: False ,
}
integer ,
defaultDaysOfWeek:
{
Description: The days of the week that active hours features will be enabled. This serves as a default that can be updated by each individual user. ,
Required: False ,
}
[
string ,
]
,
daysOfWeekLimit:
{
Description: The maximum amount of days per week that a user can enable active hours related features. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
devBoxTunnelEnableStatus:
{
Description: Indicates whether Dev Box Tunnel is enabled for a the pool. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
location: 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 ,
}
,
]
,
}
,
}
Pools_Delete (new)
Description :  Deletes a machine pool
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}
{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
Pools_RunHealthChecks (new)
Description :  Triggers a refresh of the pool status.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/runHealthChecks
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
poolName:
{
Description: Name of the pool. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location: 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 ,
}
,
]
,
}
,
}
Schedules_ListByPool (new)
Description :  Lists schedules for a pool
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
Schedules_Get (new)
Description :  Gets a schedule resource.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}
{}

⚐ Response (200)

{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: 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 ,
}
,
]
,
}
,
}
Schedules_CreateOrUpdate (new)
Description :  Creates or updates a Schedule.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}
{
body:
{
Description: Represents a scheduled task ,
Required: True ,
}
{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: 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 ,
}
,
]
,
}
,
}
Schedules_Update (new)
Description :  Partially updates a Scheduled.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}
{
body:
{
Description: Represents a scheduled task. ,
Required: True ,
}
{
properties:
{
Description: Properties of a schedule resource to be updated. ,
Required: False ,
}
{
type:
{
Description: Supported type this scheduled task represents. ,
Enum:
{
StopDevBox: No description available. ,
}
,
Required: False ,
}
enum ,
frequency:
{
Description: The frequency of this scheduled task. ,
Enum:
{
Daily: No description available. ,
}
,
Required: False ,
}
enum ,
time:
{
Description: The target time to trigger the action. The format is HH:MM. ,
Required: False ,
}
string ,
timeZone:
{
Description: The IANA timezone id at which the schedule should execute. ,
Required: False ,
}
string ,
state:
{
Description: Indicates whether or not this scheduled task is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
location: 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 ,
}
,
]
,
}
,
}
Schedules_Delete (new)
Description :  Deletes a Scheduled.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}
{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
Operations_List (updated)
Description :  List the operations for the provider
Reference :  Link ¶

⚶ Changes

{
  "#id": "Operations_List",
  "Description": {
    "new": "List the operations for the provider",
    "old": "Lists all of the available resource provider operations."
  }
}

⚼ Request

GET:  /providers/Microsoft.DevCenter/operations
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of operations supported by the resource provider ,
Required: False ,
}
[
{
name:
{
Description: The name of the operation, as per Resource-Based Access Control (RBAC). Examples: "Microsoft.Compute/virtualMachines/write", "Microsoft.Compute/virtualMachines/capture/action" ,
Required: False ,
}
string ,
isDataAction:
{
Description: Whether the operation applies to data-plane. This is "true" for data-plane operations and "false" for ARM/control-plane operations. ,
Required: False ,
}
boolean ,
display:
{
Description: Localized display information for this particular operation. ,
Required: False ,
}
{
provider:
{
Description: The localized friendly form of the resource provider name, e.g. "Microsoft Monitoring Insights" or "Microsoft Compute". ,
Required: False ,
}
string ,
resource:
{
Description: The localized friendly name of the resource type related to this operation. E.g. "Virtual Machines" or "Job Schedule Collections". ,
Required: False ,
}
string ,
operation:
{
Description: The concise, localized friendly name for the operation; suitable for dropdowns. E.g. "Create or Update Virtual Machine", "Restart Virtual Machine". ,
Required: False ,
}
string ,
description:
{
Description: The short, localized friendly description of the operation; suitable for tool tips and detailed views. ,
Required: False ,
}
string ,
}
,
origin:
{
Description: The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default value is "user,system" ,
Enum:
{
user: No description available. ,
system: No description available. ,
user,system: No description available. ,
}
,
Required: False ,
}
enum ,
actionType:
{
Description: Enum. Indicates the action type. "Internal" refers to actions that are for internal only APIs. ,
Enum:
{
Internal: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of operation list results (if there are any). ,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
CheckNameAvailability_Execute (updated)
Description :  Check the availability of name for resource.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CheckNameAvailability_Execute",
  "Description": {
    "new": "Check the availability of name for resource.",
    "old": "Check the availability of name for resource"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "#name": "nameAvailabilityRequest",
      "Description": {
        "new": "The request body",
        "old": "The required parameters for checking if resource name is available."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.DevCenter/checkNameAvailability
{
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 ,
nameAvailabilityRequest:
{
Description: The request body ,
Required: True ,
}
{
name:
{
Description: The name of the resource for which availability needs to be checked. ,
Required: False ,
}
string ,
type:
{
Description: The resource type. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
nameAvailable:
{
Description: Indicates if the resource name is available. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason why the given name is not available. ,
Enum:
{
Invalid: No description available. ,
AlreadyExists: No description available. ,
}
,
Required: False ,
}
enum ,
message:
{
Description: Detailed reason why the given name is available. ,
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 ,
}
,
]
,
}
,
}
CheckScopedNameAvailability_Execute (updated)
Description :  Check the availability of name for resource.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CheckScopedNameAvailability_Execute",
  "Description": {
    "new": "Check the availability of name for resource.",
    "old": "Check the availability of name for resource"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "#name": "nameAvailabilityRequest",
      "Description": {
        "new": "The request body",
        "old": "The required parameters for checking if resource name is available."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.DevCenter/checkScopedNameAvailability
{
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 ,
nameAvailabilityRequest:
{
Description: The request body ,
Required: True ,
}
{
name:
{
Description: The name of the resource for which availability needs to be checked. ,
Required: False ,
}
string ,
type:
{
Description: The resource type. ,
Required: False ,
}
string ,
scope:
{
Description: The resource id to scope the name check. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
nameAvailable:
{
Description: Indicates if the resource name is available. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason why the given name is not available. ,
Enum:
{
Invalid: No description available. ,
AlreadyExists: No description available. ,
}
,
Required: False ,
}
enum ,
message:
{
Description: Detailed reason why the given name is available. ,
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 ,
}
,
]
,
}
,
}
DevCenters_ListBySubscription (updated)
Description :  Lists all devcenters in a subscription.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevCenters_ListBySubscription",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of DevCenter items",
        "old": "Result of the list devcenters operation"
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The DevCenter items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": [
              {
                "properties": [
                  {
                    "#name": "provisioningState",
                    "Enum": {
                      "new": [
                        [
                          "NotSpecified",
                          "Not specified provisioning state."
                        ],
                        [
                          "Accepted",
                          "Accepted provisioning state."
                        ],
                        [
                          "Running",
                          "Running provisioning state."
                        ],
                        [
                          "Creating",
                          "Creating provisioning state."
                        ],
                        [
                          "Created",
                          "Created provisioning state."
                        ],
                        [
                          "Updating",
                          "Updating provisioning state."
                        ],
                        [
                          "Updated",
                          "Updated provisioning state."
                        ],
                        [
                          "Deleting",
                          "Deleting provisioning state."
                        ],
                        [
                          "Deleted",
                          "Deleted provisioning state."
                        ],
                        [
                          "Succeeded",
                          "Succeeded provisioning state."
                        ],
                        [
                          "Failed",
                          "Failed provisioning state."
                        ],
                        [
                          "Canceled",
                          "Canceled provisioning state."
                        ],
                        [
                          "MovingResources",
                          "Moving resources provisioning state."
                        ],
                        [
                          "TransientFailure",
                          "Transient failure provisioning state."
                        ],
                        [
                          "RolloutInProgress",
                          "Rollout in progress provisioning state."
                        ],
                        [
                          "StorageProvisioningFailed",
                          "Storage provisioning failed provisioning state."
                        ]
                      ],
                      "old": [
                        [
                          "NotSpecified",
                          ""
                        ],
                        [
                          "Accepted",
                          ""
                        ],
                        [
                          "Running",
                          ""
                        ],
                        [
                          "Creating",
                          ""
                        ],
                        [
                          "Created",
                          ""
                        ],
                        [
                          "Updating",
                          ""
                        ],
                        [
                          "Updated",
                          ""
                        ],
                        [
                          "Deleting",
                          ""
                        ],
                        [
                          "Deleted",
                          ""
                        ],
                        [
                          "Succeeded",
                          ""
                        ],
                        [
                          "Failed",
                          ""
                        ],
                        [
                          "Canceled",
                          ""
                        ],
                        [
                          "MovingResources",
                          ""
                        ],
                        [
                          "TransientFailure",
                          ""
                        ],
                        [
                          "RolloutInProgress",
                          ""
                        ],
                        [
                          "StorageProvisioningFailed",
                          ""
                        ]
                      ]
                    }
                  }
                ]
              },
              {
                "#name": "identity",
                "Description": {
                  "new": "Managed identity properties.",
                  "old": "Managed identity properties"
                }
              }
            ]
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.DevCenter/devcenters
{
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 ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The DevCenter items on this page ,
Required: True ,
}
[
{
properties:
{
Description: DevCenter properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
OperationStatuses_Get (updated)
Description :  Gets the current status of an async operation.
Reference :  Link ¶

⚶ Changes

{
  "#id": "OperationStatuses_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "#name": "location",
      "Description": {
        "new": "The name of the Azure region.",
        "old": "The Azure region"
      }
    },
    {
      "#name": "operationId",
      "Description": {
        "new": "The ID of an ongoing async operation.",
        "old": "The ID of an ongoing async operation"
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.DevCenter/locations/{location}/operationStatuses/{operationId}
{
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 ,
location:
{
Description: The name of the Azure region. ,
Required: True ,
}
string ,
operationId:
{
Description: The ID of an ongoing async operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Custom operation properties, populated only for a successful operation. ,
Required: False ,
}
object ,
}

⚐ Response (202)

{
$headers:
{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
}
,
$schema:
{
Description: The current status of an async operation ,
}
{
properties:
{
Description: Custom operation properties, populated only for a successful operation. ,
Required: False ,
}
object ,
}
,
}

⚐ 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 ,
}
,
]
,
}
,
}
Usages_ListByLocation (updated)
Description :  Lists the current usages and limits in this location for the provided subscription.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Usages_ListByLocation",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "#name": "location",
      "Description": {
        "new": "The name of the Azure region.",
        "old": "The Azure region"
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The Usage items on this page",
            "old": "The array page of Usages."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": [
              {
                "#name": "unit",
                "Enum": {
                  "new": [
                    [
                      "Count",
                      "Count."
                    ]
                  ],
                  "old": [
                    [
                      "Count",
                      ""
                    ]
                  ]
                }
              }
            ]
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "The link to get the next page of Usage result."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.DevCenter/locations/{location}/usages
{
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 ,
location:
{
Description: The name of the Azure region. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The Usage items on this page ,
Required: True ,
}
[
{
currentValue:
{
Description: The current usage. ,
Format: int64 ,
Required: False ,
}
integer ,
limit:
{
Description: The limit integer. ,
Format: int64 ,
Required: False ,
}
integer ,
unit:
{
Description: The unit details. ,
Enum:
{
Count: Count. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: The name. ,
Required: False ,
}
{
localizedValue:
{
Description: The localized name of the resource. ,
Required: False ,
}
string ,
value:
{
Description: The name of the resource. ,
Required: False ,
}
string ,
}
,
id:
{
Description: The fully qualified arm resource id. ,
Required: False ,
}
string ,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
Projects_ListBySubscription (updated)
Description :  Lists all projects in the subscription.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Projects_ListBySubscription",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of Project items",
        "old": "Results of the project list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The Project items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": [
              {
                "properties": [
                  {
                    "#name": "provisioningState",
                    "Enum": {
                      "new": [
                        [
                          "NotSpecified",
                          "Not specified provisioning state."
                        ],
                        [
                          "Accepted",
                          "Accepted provisioning state."
                        ],
                        [
                          "Running",
                          "Running provisioning state."
                        ],
                        [
                          "Creating",
                          "Creating provisioning state."
                        ],
                        [
                          "Created",
                          "Created provisioning state."
                        ],
                        [
                          "Updating",
                          "Updating provisioning state."
                        ],
                        [
                          "Updated",
                          "Updated provisioning state."
                        ],
                        [
                          "Deleting",
                          "Deleting provisioning state."
                        ],
                        [
                          "Deleted",
                          "Deleted provisioning state."
                        ],
                        [
                          "Succeeded",
                          "Succeeded provisioning state."
                        ],
                        [
                          "Failed",
                          "Failed provisioning state."
                        ],
                        [
                          "Canceled",
                          "Canceled provisioning state."
                        ],
                        [
                          "MovingResources",
                          "Moving resources provisioning state."
                        ],
                        [
                          "TransientFailure",
                          "Transient failure provisioning state."
                        ],
                        [
                          "RolloutInProgress",
                          "Rollout in progress provisioning state."
                        ],
                        [
                          "StorageProvisioningFailed",
                          "Storage provisioning failed provisioning state."
                        ]
                      ],
                      "old": [
                        [
                          "NotSpecified",
                          ""
                        ],
                        [
                          "Accepted",
                          ""
                        ],
                        [
                          "Running",
                          ""
                        ],
                        [
                          "Creating",
                          ""
                        ],
                        [
                          "Created",
                          ""
                        ],
                        [
                          "Updating",
                          ""
                        ],
                        [
                          "Updated",
                          ""
                        ],
                        [
                          "Deleting",
                          ""
                        ],
                        [
                          "Deleted",
                          ""
                        ],
                        [
                          "Succeeded",
                          ""
                        ],
                        [
                          "Failed",
                          ""
                        ],
                        [
                          "Canceled",
                          ""
                        ],
                        [
                          "MovingResources",
                          ""
                        ],
                        [
                          "TransientFailure",
                          ""
                        ],
                        [
                          "RolloutInProgress",
                          ""
                        ],
                        [
                          "StorageProvisioningFailed",
                          ""
                        ]
                      ]
                    }
                  }
                ]
              },
              {
                "#name": "identity",
                "Description": {
                  "new": "Managed identity properties.",
                  "old": "Managed identity properties"
                }
              }
            ]
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.DevCenter/projects
{
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 ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The Project items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Properties of a project. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center resource this project is associated with. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
DevCenters_ListByResourceGroup (updated)
Description :  Lists all devcenters in a resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevCenters_ListByResourceGroup",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of DevCenter items",
        "old": "Result of the list devcenters operation"
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The DevCenter items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": [
              {
                "properties": [
                  {
                    "#name": "provisioningState",
                    "Enum": {
                      "new": [
                        [
                          "NotSpecified",
                          "Not specified provisioning state."
                        ],
                        [
                          "Accepted",
                          "Accepted provisioning state."
                        ],
                        [
                          "Running",
                          "Running provisioning state."
                        ],
                        [
                          "Creating",
                          "Creating provisioning state."
                        ],
                        [
                          "Created",
                          "Created provisioning state."
                        ],
                        [
                          "Updating",
                          "Updating provisioning state."
                        ],
                        [
                          "Updated",
                          "Updated provisioning state."
                        ],
                        [
                          "Deleting",
                          "Deleting provisioning state."
                        ],
                        [
                          "Deleted",
                          "Deleted provisioning state."
                        ],
                        [
                          "Succeeded",
                          "Succeeded provisioning state."
                        ],
                        [
                          "Failed",
                          "Failed provisioning state."
                        ],
                        [
                          "Canceled",
                          "Canceled provisioning state."
                        ],
                        [
                          "MovingResources",
                          "Moving resources provisioning state."
                        ],
                        [
                          "TransientFailure",
                          "Transient failure provisioning state."
                        ],
                        [
                          "RolloutInProgress",
                          "Rollout in progress provisioning state."
                        ],
                        [
                          "StorageProvisioningFailed",
                          "Storage provisioning failed provisioning state."
                        ]
                      ],
                      "old": [
                        [
                          "NotSpecified",
                          ""
                        ],
                        [
                          "Accepted",
                          ""
                        ],
                        [
                          "Running",
                          ""
                        ],
                        [
                          "Creating",
                          ""
                        ],
                        [
                          "Created",
                          ""
                        ],
                        [
                          "Updating",
                          ""
                        ],
                        [
                          "Updated",
                          ""
                        ],
                        [
                          "Deleting",
                          ""
                        ],
                        [
                          "Deleted",
                          ""
                        ],
                        [
                          "Succeeded",
                          ""
                        ],
                        [
                          "Failed",
                          ""
                        ],
                        [
                          "Canceled",
                          ""
                        ],
                        [
                          "MovingResources",
                          ""
                        ],
                        [
                          "TransientFailure",
                          ""
                        ],
                        [
                          "RolloutInProgress",
                          ""
                        ],
                        [
                          "StorageProvisioningFailed",
                          ""
                        ]
                      ]
                    }
                  }
                ]
              },
              {
                "#name": "identity",
                "Description": {
                  "new": "Managed identity properties.",
                  "old": "Managed identity properties"
                }
              }
            ]
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters
{
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 ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The DevCenter items on this page ,
Required: True ,
}
[
{
properties:
{
Description: DevCenter properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
DevCenters_Get (updated)
Description :  Gets a devcenter.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevCenters_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: DevCenter properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ 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 ,
}
,
]
,
}
,
}
DevCenters_CreateOrUpdate (updated)
Description :  Creates or updates a devcenter resource.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevCenters_CreateOrUpdate",
  "Description": {
    "new": "Creates or updates a devcenter resource.",
    "old": "Creates or updates a devcenter resource"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": [
          {
            "properties": [
              {
                "#name": "provisioningState",
                "Enum": {
                  "new": [
                    [
                      "NotSpecified",
                      "Not specified provisioning state."
                    ],
                    [
                      "Accepted",
                      "Accepted provisioning state."
                    ],
                    [
                      "Running",
                      "Running provisioning state."
                    ],
                    [
                      "Creating",
                      "Creating provisioning state."
                    ],
                    [
                      "Created",
                      "Created provisioning state."
                    ],
                    [
                      "Updating",
                      "Updating provisioning state."
                    ],
                    [
                      "Updated",
                      "Updated provisioning state."
                    ],
                    [
                      "Deleting",
                      "Deleting provisioning state."
                    ],
                    [
                      "Deleted",
                      "Deleted provisioning state."
                    ],
                    [
                      "Succeeded",
                      "Succeeded provisioning state."
                    ],
                    [
                      "Failed",
                      "Failed provisioning state."
                    ],
                    [
                      "Canceled",
                      "Canceled provisioning state."
                    ],
                    [
                      "MovingResources",
                      "Moving resources provisioning state."
                    ],
                    [
                      "TransientFailure",
                      "Transient failure provisioning state."
                    ],
                    [
                      "RolloutInProgress",
                      "Rollout in progress provisioning state."
                    ],
                    [
                      "StorageProvisioningFailed",
                      "Storage provisioning failed provisioning state."
                    ]
                  ],
                  "old": [
                    [
                      "NotSpecified",
                      ""
                    ],
                    [
                      "Accepted",
                      ""
                    ],
                    [
                      "Running",
                      ""
                    ],
                    [
                      "Creating",
                      ""
                    ],
                    [
                      "Created",
                      ""
                    ],
                    [
                      "Updating",
                      ""
                    ],
                    [
                      "Updated",
                      ""
                    ],
                    [
                      "Deleting",
                      ""
                    ],
                    [
                      "Deleted",
                      ""
                    ],
                    [
                      "Succeeded",
                      ""
                    ],
                    [
                      "Failed",
                      ""
                    ],
                    [
                      "Canceled",
                      ""
                    ],
                    [
                      "MovingResources",
                      ""
                    ],
                    [
                      "TransientFailure",
                      ""
                    ],
                    [
                      "RolloutInProgress",
                      ""
                    ],
                    [
                      "StorageProvisioningFailed",
                      ""
                    ]
                  ]
                }
              }
            ]
          },
          {
            "#name": "identity",
            "Description": {
              "new": "Managed identity properties.",
              "old": "Managed identity properties"
            }
          }
        ]
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    },
    "201": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
body:
{
Description: Represents a devcenter. ,
Required: True ,
}
{
properties:
{
Description: DevCenter properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: DevCenter properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ 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: Represents a devcenter resource. ,
}
{
properties:
{
Description: DevCenter properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ 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 ,
}
,
]
,
}
,
}
DevCenters_Update (updated)
Description :  Partially updates a devcenter.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevCenters_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": [
          {
            "@added_985930d9f0af4722968b6330bd148e63": {
              "#name": "tags",
              "Description": "Resource tags.",
              "Required": false,
              "Type": "object"
            }
          },
          {
            "@added_8e7f4d043d77410bbed4a3bf58483001": {
              "#name": "location",
              "Description": "The geo-location where the resource lives.",
              "Required": false,
              "Type": "string"
            }
          },
          {
            "#name": "identity",
            "Description": {
              "new": "Managed identity properties.",
              "old": "Managed identity properties"
            }
          },
          {
            "properties": [
              {
                "projectCatalogSettings": [
                  {
                    "#name": "catalogItemSyncEnableStatus",
                    "Enum": {
                      "new": [
                        [
                          "Enabled",
                          "Catalog item sync is enabled."
                        ],
                        [
                          "Disabled",
                          "Catalog item sync is disabled."
                        ]
                      ],
                      "old": [
                        [
                          "Enabled",
                          ""
                        ],
                        [
                          "Disabled",
                          ""
                        ]
                      ]
                    }
                  }
                ]
              },
              {
                "networkSettings": [
                  {
                    "#name": "microsoftHostedNetworkEnableStatus",
                    "Enum": {
                      "new": [
                        [
                          "Enabled",
                          "Microsoft Hosted Networks are enabled for this Dev Center."
                        ],
                        [
                          "Disabled",
                          "Microsoft Hosted Networks are disabled for this Dev Center."
                        ]
                      ],
                      "old": [
                        [
                          "Enabled",
                          ""
                        ],
                        [
                          "Disabled",
                          ""
                        ]
                      ]
                    }
                  }
                ]
              },
              {
                "devBoxProvisioningSettings": [
                  {
                    "#name": "installAzureMonitorAgentEnableStatus",
                    "Description": {
                      "new": "Indicates whether to install the Azure Monitor Agent service on Dev Boxes that belong to this dev center",
                      "old": "Whether project catalogs associated with projects in this dev center can be configured to sync catalog items."
                    },
                    "Enum": {
                      "new": [
                        [
                          "Enabled",
                          "Azure Monitor Agent service is enabled."
                        ],
                        [
                          "Disabled",
                          "Azure Monitor Agent service is disabled."
                        ]
                      ],
                      "old": [
                        [
                          "Enabled",
                          ""
                        ],
                        [
                          "Disabled",
                          ""
                        ]
                      ]
                    }
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
body:
{
Description: Updatable devcenter properties. ,
Required: True ,
}
{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The geo-location where the resource lives. ,
Required: False ,
}
string ,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: Properties of a Dev Center to be updated. ,
Required: False ,
}
{
encryption:
{
Description: Encryption settings to be used for server-side encryption for proprietary content (such as catalogs, logs, customizations). ,
Required: False ,
}
{
customerManagedKeyEncryption:
{
Description: All Customer-managed key encryption properties for the resource. ,
Required: False ,
}
{
keyEncryptionKeyIdentity:
{
Description: All identity configuration for Customer-managed key settings defining which identity should be used to auth to Key Vault. ,
Required: False ,
}
{
identityType:
{
Description: Values can be systemAssignedIdentity or userAssignedIdentity ,
Enum:
{
systemAssignedIdentity: No description available. ,
userAssignedIdentity: No description available. ,
delegatedResourceIdentity: No description available. ,
}
,
Required: False ,
}
enum ,
userAssignedIdentityResourceId:
{
Description: user assigned identity to use for accessing key encryption key Url. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutually exclusive with identityType systemAssignedIdentity and delegatedResourceIdentity. ,
Format: arm-id ,
Required: False ,
}
string ,
delegatedIdentityClientId:
{
Description: delegated identity to use for accessing key encryption key Url. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutually exclusive with identityType systemAssignedIdentity and userAssignedIdentity - internal use only. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
keyEncryptionKeyUrl:
{
Description: key encryption key Url, versioned or non-versioned. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 or https://contosovault.vault.azure.net/keys/contosokek. ,
Required: False ,
}
string ,
}
,
}
,
displayName:
{
Description: The display name of the devcenter. ,
Required: False ,
}
string ,
projectCatalogSettings:
{
Description: Dev Center settings to be used when associating a project with a catalog. ,
Required: False ,
}
{
catalogItemSyncEnableStatus:
{
Description: Whether project catalogs associated with projects in this dev center can be configured to sync catalog items. ,
Enum:
{
Enabled: Catalog item sync is enabled. ,
Disabled: Catalog item sync is disabled. ,
}
,
Required: False ,
}
enum ,
}
,
networkSettings:
{
Description: Network settings that will be enforced on network resources associated with the Dev Center. ,
Required: False ,
}
{
microsoftHostedNetworkEnableStatus:
{
Description: Indicates whether pools in this Dev Center can use Microsoft Hosted Networks. Defaults to Enabled if not set. ,
Enum:
{
Enabled: Microsoft Hosted Networks are enabled for this Dev Center. ,
Disabled: Microsoft Hosted Networks are disabled for this Dev Center. ,
}
,
Required: False ,
}
enum ,
}
,
devBoxProvisioningSettings:
{
Description: Settings to be used in the provisioning of all Dev Boxes that belong to this dev center. ,
Required: False ,
}
{
installAzureMonitorAgentEnableStatus:
{
Description: Indicates whether to install the Azure Monitor Agent service on Dev Boxes that belong to this dev center ,
Enum:
{
Enabled: Azure Monitor Agent service is enabled. ,
Disabled: Azure Monitor Agent service is disabled. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: DevCenter properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
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 ,
}
,
]
,
}
,
}
DevCenters_Delete (updated)
Description :  Deletes a devcenter.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevCenters_Delete",
  "Description": {
    "new": "Deletes a devcenter.",
    "old": "Deletes a devcenter"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
AttachedNetworks_ListByDevCenter (updated)
Description :  Lists the attached NetworkConnections for a DevCenter.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AttachedNetworks_ListByDevCenter",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of AttachedNetworkConnection items",
        "old": "Results of the Attached Networks list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The AttachedNetworkConnection items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "networkConnectionId",
                  "Required": {
                    "new": false,
                    "old": true
                  }
                },
                {
                  "#name": "healthCheckStatus",
                  "Description": {
                    "new": "Health check status values.",
                    "old": "Health check status values"
                  },
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown health check status."
                      ],
                      [
                        "Pending",
                        "Pending health check status."
                      ],
                      [
                        "Running",
                        "Running health check status."
                      ],
                      [
                        "Passed",
                        "Passed health check status."
                      ],
                      [
                        "Warning",
                        "Warning health check status."
                      ],
                      [
                        "Failed",
                        "Failed health check status."
                      ],
                      [
                        "Informational",
                        "Informational health check status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Passed",
                        ""
                      ],
                      [
                        "Warning",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Informational",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "domainJoinType",
                  "Enum": {
                    "new": [
                      [
                        "HybridAzureADJoin",
                        "Hybrid Azure AD Join type."
                      ],
                      [
                        "AzureADJoin",
                        "Azure AD Join type."
                      ],
                      [
                        "None",
                        "No Active Directory join type."
                      ]
                    ],
                    "old": [
                      [
                        "HybridAzureADJoin",
                        ""
                      ],
                      [
                        "AzureADJoin",
                        ""
                      ],
                      [
                        "None",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/attachednetworks
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The AttachedNetworkConnection items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Attached NetworkConnection properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
networkConnectionId:
{
Description: The resource ID of the NetworkConnection you want to attach. ,
Required: False ,
}
string ,
networkConnectionLocation:
{
Description: The geo-location where the NetworkConnection resource specified in 'networkConnectionResourceId' property lives. ,
Required: False ,
}
string ,
healthCheckStatus:
{
Description: Health check status values. ,
Enum:
{
Unknown: Unknown health check status. ,
Pending: Pending health check status. ,
Running: Running health check status. ,
Passed: Passed health check status. ,
Warning: Warning health check status. ,
Failed: Failed health check status. ,
Informational: Informational health check status. ,
}
,
Required: False ,
}
enum ,
domainJoinType:
{
Description: AAD Join type of the network. This is populated based on the referenced Network Connection. ,
Enum:
{
HybridAzureADJoin: Hybrid Azure AD Join type. ,
AzureADJoin: Azure AD Join type. ,
None: No Active Directory join type. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
AttachedNetworks_GetByDevCenter (updated)
Description :  Gets an attached NetworkConnection.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AttachedNetworks_GetByDevCenter",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "networkConnectionId",
            "Required": {
              "new": false,
              "old": true
            }
          },
          {
            "#name": "healthCheckStatus",
            "Description": {
              "new": "Health check status values.",
              "old": "Health check status values"
            },
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown health check status."
                ],
                [
                  "Pending",
                  "Pending health check status."
                ],
                [
                  "Running",
                  "Running health check status."
                ],
                [
                  "Passed",
                  "Passed health check status."
                ],
                [
                  "Warning",
                  "Warning health check status."
                ],
                [
                  "Failed",
                  "Failed health check status."
                ],
                [
                  "Informational",
                  "Informational health check status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Passed",
                  ""
                ],
                [
                  "Warning",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Informational",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "domainJoinType",
            "Enum": {
              "new": [
                [
                  "HybridAzureADJoin",
                  "Hybrid Azure AD Join type."
                ],
                [
                  "AzureADJoin",
                  "Azure AD Join type."
                ],
                [
                  "None",
                  "No Active Directory join type."
                ]
              ],
              "old": [
                [
                  "HybridAzureADJoin",
                  ""
                ],
                [
                  "AzureADJoin",
                  ""
                ],
                [
                  "None",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/attachednetworks/{attachedNetworkConnectionName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
attachedNetworkConnectionName:
{
Description: The name of the attached NetworkConnection. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Attached NetworkConnection properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
networkConnectionId:
{
Description: The resource ID of the NetworkConnection you want to attach. ,
Required: False ,
}
string ,
networkConnectionLocation:
{
Description: The geo-location where the NetworkConnection resource specified in 'networkConnectionResourceId' property lives. ,
Required: False ,
}
string ,
healthCheckStatus:
{
Description: Health check status values. ,
Enum:
{
Unknown: Unknown health check status. ,
Pending: Pending health check status. ,
Running: Running health check status. ,
Passed: Passed health check status. ,
Warning: Warning health check status. ,
Failed: Failed health check status. ,
Informational: Informational health check status. ,
}
,
Required: False ,
}
enum ,
domainJoinType:
{
Description: AAD Join type of the network. This is populated based on the referenced Network Connection. ,
Enum:
{
HybridAzureADJoin: Hybrid Azure AD Join type. ,
AzureADJoin: Azure AD Join type. ,
None: No Active Directory join type. ,
}
,
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 ,
}
,
]
,
}
,
}
AttachedNetworks_CreateOrUpdate (updated)
Description :  Creates or updates an attached NetworkConnection.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AttachedNetworks_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            },
            {
              "#name": "networkConnectionId",
              "Required": {
                "new": false,
                "old": true
              }
            },
            {
              "#name": "healthCheckStatus",
              "Description": {
                "new": "Health check status values.",
                "old": "Health check status values"
              },
              "Enum": {
                "new": [
                  [
                    "Unknown",
                    "Unknown health check status."
                  ],
                  [
                    "Pending",
                    "Pending health check status."
                  ],
                  [
                    "Running",
                    "Running health check status."
                  ],
                  [
                    "Passed",
                    "Passed health check status."
                  ],
                  [
                    "Warning",
                    "Warning health check status."
                  ],
                  [
                    "Failed",
                    "Failed health check status."
                  ],
                  [
                    "Informational",
                    "Informational health check status."
                  ]
                ],
                "old": [
                  [
                    "Unknown",
                    ""
                  ],
                  [
                    "Pending",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Passed",
                    ""
                  ],
                  [
                    "Warning",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Informational",
                    ""
                  ]
                ]
              }
            },
            {
              "#name": "domainJoinType",
              "Enum": {
                "new": [
                  [
                    "HybridAzureADJoin",
                    "Hybrid Azure AD Join type."
                  ],
                  [
                    "AzureADJoin",
                    "Azure AD Join type."
                  ],
                  [
                    "None",
                    "No Active Directory join type."
                  ]
                ],
                "old": [
                  [
                    "HybridAzureADJoin",
                    ""
                  ],
                  [
                    "AzureADJoin",
                    ""
                  ],
                  [
                    "None",
                    ""
                  ]
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "networkConnectionId",
            "Required": {
              "new": false,
              "old": true
            }
          },
          {
            "#name": "healthCheckStatus",
            "Description": {
              "new": "Health check status values.",
              "old": "Health check status values"
            },
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown health check status."
                ],
                [
                  "Pending",
                  "Pending health check status."
                ],
                [
                  "Running",
                  "Running health check status."
                ],
                [
                  "Passed",
                  "Passed health check status."
                ],
                [
                  "Warning",
                  "Warning health check status."
                ],
                [
                  "Failed",
                  "Failed health check status."
                ],
                [
                  "Informational",
                  "Informational health check status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Passed",
                  ""
                ],
                [
                  "Warning",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Informational",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "domainJoinType",
            "Enum": {
              "new": [
                [
                  "HybridAzureADJoin",
                  "Hybrid Azure AD Join type."
                ],
                [
                  "AzureADJoin",
                  "Azure AD Join type."
                ],
                [
                  "None",
                  "No Active Directory join type."
                ]
              ],
              "old": [
                [
                  "HybridAzureADJoin",
                  ""
                ],
                [
                  "AzureADJoin",
                  ""
                ],
                [
                  "None",
                  ""
                ]
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "networkConnectionId",
            "Required": {
              "new": false,
              "old": true
            }
          },
          {
            "#name": "healthCheckStatus",
            "Description": {
              "new": "Health check status values.",
              "old": "Health check status values"
            },
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown health check status."
                ],
                [
                  "Pending",
                  "Pending health check status."
                ],
                [
                  "Running",
                  "Running health check status."
                ],
                [
                  "Passed",
                  "Passed health check status."
                ],
                [
                  "Warning",
                  "Warning health check status."
                ],
                [
                  "Failed",
                  "Failed health check status."
                ],
                [
                  "Informational",
                  "Informational health check status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Passed",
                  ""
                ],
                [
                  "Warning",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Informational",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "domainJoinType",
            "Enum": {
              "new": [
                [
                  "HybridAzureADJoin",
                  "Hybrid Azure AD Join type."
                ],
                [
                  "AzureADJoin",
                  "Azure AD Join type."
                ],
                [
                  "None",
                  "No Active Directory join type."
                ]
              ],
              "old": [
                [
                  "HybridAzureADJoin",
                  ""
                ],
                [
                  "AzureADJoin",
                  ""
                ],
                [
                  "None",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/attachednetworks/{attachedNetworkConnectionName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
attachedNetworkConnectionName:
{
Description: The name of the attached NetworkConnection. ,
Required: True ,
}
string ,
body:
{
Description: Represents an attached NetworkConnection. ,
Required: True ,
}
{
properties:
{
Description: Attached NetworkConnection properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
networkConnectionId:
{
Description: The resource ID of the NetworkConnection you want to attach. ,
Required: False ,
}
string ,
networkConnectionLocation:
{
Description: The geo-location where the NetworkConnection resource specified in 'networkConnectionResourceId' property lives. ,
Required: False ,
}
string ,
healthCheckStatus:
{
Description: Health check status values. ,
Enum:
{
Unknown: Unknown health check status. ,
Pending: Pending health check status. ,
Running: Running health check status. ,
Passed: Passed health check status. ,
Warning: Warning health check status. ,
Failed: Failed health check status. ,
Informational: Informational health check status. ,
}
,
Required: False ,
}
enum ,
domainJoinType:
{
Description: AAD Join type of the network. This is populated based on the referenced Network Connection. ,
Enum:
{
HybridAzureADJoin: Hybrid Azure AD Join type. ,
AzureADJoin: Azure AD Join type. ,
None: No Active Directory join type. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Attached NetworkConnection properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
networkConnectionId:
{
Description: The resource ID of the NetworkConnection you want to attach. ,
Required: False ,
}
string ,
networkConnectionLocation:
{
Description: The geo-location where the NetworkConnection resource specified in 'networkConnectionResourceId' property lives. ,
Required: False ,
}
string ,
healthCheckStatus:
{
Description: Health check status values. ,
Enum:
{
Unknown: Unknown health check status. ,
Pending: Pending health check status. ,
Running: Running health check status. ,
Passed: Passed health check status. ,
Warning: Warning health check status. ,
Failed: Failed health check status. ,
Informational: Informational health check status. ,
}
,
Required: False ,
}
enum ,
domainJoinType:
{
Description: AAD Join type of the network. This is populated based on the referenced Network Connection. ,
Enum:
{
HybridAzureADJoin: Hybrid Azure AD Join type. ,
AzureADJoin: Azure AD Join type. ,
None: No Active Directory join type. ,
}
,
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: Represents an attached NetworkConnection. ,
}
{
properties:
{
Description: Attached NetworkConnection properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
networkConnectionId:
{
Description: The resource ID of the NetworkConnection you want to attach. ,
Required: False ,
}
string ,
networkConnectionLocation:
{
Description: The geo-location where the NetworkConnection resource specified in 'networkConnectionResourceId' property lives. ,
Required: False ,
}
string ,
healthCheckStatus:
{
Description: Health check status values. ,
Enum:
{
Unknown: Unknown health check status. ,
Pending: Pending health check status. ,
Running: Running health check status. ,
Passed: Passed health check status. ,
Warning: Warning health check status. ,
Failed: Failed health check status. ,
Informational: Informational health check status. ,
}
,
Required: False ,
}
enum ,
domainJoinType:
{
Description: AAD Join type of the network. This is populated based on the referenced Network Connection. ,
Enum:
{
HybridAzureADJoin: Hybrid Azure AD Join type. ,
AzureADJoin: Azure AD Join type. ,
None: No Active Directory join type. ,
}
,
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 ,
}
,
]
,
}
,
}
AttachedNetworks_Delete (updated)
Description :  Un-attach a NetworkConnection.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AttachedNetworks_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/attachednetworks/{attachedNetworkConnectionName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
attachedNetworkConnectionName:
{
Description: The name of the attached NetworkConnection. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
Catalogs_ListByDevCenter (updated)
Description :  Lists catalogs for a devcenter.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Catalogs_ListByDevCenter",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of Catalog items",
        "old": "Results of the catalog list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The Catalog items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "syncState",
                  "Enum": {
                    "new": [
                      [
                        "Succeeded",
                        "Succeeded synchronization state."
                      ],
                      [
                        "InProgress",
                        "In progress synchronization state."
                      ],
                      [
                        "Failed",
                        "Failed synchronization state."
                      ],
                      [
                        "Canceled",
                        "Canceled synchronization state."
                      ]
                    ],
                    "old": [
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "InProgress",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "lastSyncStats": [
                    {
                      "syncedCatalogItemTypes": {
                        "Enum": {
                          "new": [
                            [
                              "EnvironmentDefinition",
                              "Environment definition catalog item type."
                            ],
                            [
                              "ImageDefinition",
                              "Image definition catalog item type."
                            ]
                          ],
                          "old": [
                            [
                              "EnvironmentDefinition",
                              ""
                            ],
                            [
                              "ImageDefinition",
                              ""
                            ]
                          ]
                        }
                      }
                    }
                  ]
                },
                {
                  "#name": "connectionState",
                  "Enum": {
                    "new": [
                      [
                        "Connected",
                        "Connected state."
                      ],
                      [
                        "Disconnected",
                        "Disconnected state."
                      ]
                    ],
                    "old": [
                      [
                        "Connected",
                        ""
                      ],
                      [
                        "Disconnected",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The Catalog items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
Catalogs_Get (updated)
Description :  Gets a catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Catalogs_Get",
  "Description": {
    "new": "Gets a catalog.",
    "old": "Gets a catalog"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "syncState",
            "Enum": {
              "new": [
                [
                  "Succeeded",
                  "Succeeded synchronization state."
                ],
                [
                  "InProgress",
                  "In progress synchronization state."
                ],
                [
                  "Failed",
                  "Failed synchronization state."
                ],
                [
                  "Canceled",
                  "Canceled synchronization state."
                ]
              ],
              "old": [
                [
                  "Succeeded",
                  ""
                ],
                [
                  "InProgress",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ]
              ]
            }
          },
          {
            "lastSyncStats": [
              {
                "syncedCatalogItemTypes": {
                  "Enum": {
                    "new": [
                      [
                        "EnvironmentDefinition",
                        "Environment definition catalog item type."
                      ],
                      [
                        "ImageDefinition",
                        "Image definition catalog item type."
                      ]
                    ],
                    "old": [
                      [
                        "EnvironmentDefinition",
                        ""
                      ],
                      [
                        "ImageDefinition",
                        ""
                      ]
                    ]
                  }
                }
              }
            ]
          },
          {
            "#name": "connectionState",
            "Enum": {
              "new": [
                [
                  "Connected",
                  "Connected state."
                ],
                [
                  "Disconnected",
                  "Disconnected state."
                ]
              ],
              "old": [
                [
                  "Connected",
                  ""
                ],
                [
                  "Disconnected",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
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 ,
}
,
]
,
}
,
}
Catalogs_CreateOrUpdate (updated)
Description :  Creates or updates a catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Catalogs_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            },
            {
              "#name": "syncState",
              "Enum": {
                "new": [
                  [
                    "Succeeded",
                    "Succeeded synchronization state."
                  ],
                  [
                    "InProgress",
                    "In progress synchronization state."
                  ],
                  [
                    "Failed",
                    "Failed synchronization state."
                  ],
                  [
                    "Canceled",
                    "Canceled synchronization state."
                  ]
                ],
                "old": [
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "InProgress",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ]
                ]
              }
            },
            {
              "lastSyncStats": [
                {
                  "syncedCatalogItemTypes": {
                    "Enum": {
                      "new": [
                        [
                          "EnvironmentDefinition",
                          "Environment definition catalog item type."
                        ],
                        [
                          "ImageDefinition",
                          "Image definition catalog item type."
                        ]
                      ],
                      "old": [
                        [
                          "EnvironmentDefinition",
                          ""
                        ],
                        [
                          "ImageDefinition",
                          ""
                        ]
                      ]
                    }
                  }
                }
              ]
            },
            {
              "#name": "connectionState",
              "Enum": {
                "new": [
                  [
                    "Connected",
                    "Connected state."
                  ],
                  [
                    "Disconnected",
                    "Disconnected state."
                  ]
                ],
                "old": [
                  [
                    "Connected",
                    ""
                  ],
                  [
                    "Disconnected",
                    ""
                  ]
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "syncState",
            "Enum": {
              "new": [
                [
                  "Succeeded",
                  "Succeeded synchronization state."
                ],
                [
                  "InProgress",
                  "In progress synchronization state."
                ],
                [
                  "Failed",
                  "Failed synchronization state."
                ],
                [
                  "Canceled",
                  "Canceled synchronization state."
                ]
              ],
              "old": [
                [
                  "Succeeded",
                  ""
                ],
                [
                  "InProgress",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ]
              ]
            }
          },
          {
            "lastSyncStats": [
              {
                "syncedCatalogItemTypes": {
                  "Enum": {
                    "new": [
                      [
                        "EnvironmentDefinition",
                        "Environment definition catalog item type."
                      ],
                      [
                        "ImageDefinition",
                        "Image definition catalog item type."
                      ]
                    ],
                    "old": [
                      [
                        "EnvironmentDefinition",
                        ""
                      ],
                      [
                        "ImageDefinition",
                        ""
                      ]
                    ]
                  }
                }
              }
            ]
          },
          {
            "#name": "connectionState",
            "Enum": {
              "new": [
                [
                  "Connected",
                  "Connected state."
                ],
                [
                  "Disconnected",
                  "Disconnected state."
                ]
              ],
              "old": [
                [
                  "Connected",
                  ""
                ],
                [
                  "Disconnected",
                  ""
                ]
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "syncState",
            "Enum": {
              "new": [
                [
                  "Succeeded",
                  "Succeeded synchronization state."
                ],
                [
                  "InProgress",
                  "In progress synchronization state."
                ],
                [
                  "Failed",
                  "Failed synchronization state."
                ],
                [
                  "Canceled",
                  "Canceled synchronization state."
                ]
              ],
              "old": [
                [
                  "Succeeded",
                  ""
                ],
                [
                  "InProgress",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ]
              ]
            }
          },
          {
            "lastSyncStats": [
              {
                "syncedCatalogItemTypes": {
                  "Enum": {
                    "new": [
                      [
                        "EnvironmentDefinition",
                        "Environment definition catalog item type."
                      ],
                      [
                        "ImageDefinition",
                        "Image definition catalog item type."
                      ]
                    ],
                    "old": [
                      [
                        "EnvironmentDefinition",
                        ""
                      ],
                      [
                        "ImageDefinition",
                        ""
                      ]
                    ]
                  }
                }
              }
            ]
          },
          {
            "#name": "connectionState",
            "Enum": {
              "new": [
                [
                  "Connected",
                  "Connected state."
                ],
                [
                  "Disconnected",
                  "Disconnected state."
                ]
              ],
              "old": [
                [
                  "Connected",
                  ""
                ],
                [
                  "Disconnected",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
body:
{
Description: Represents a catalog. ,
Required: True ,
}
{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ 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: Represents a catalog. ,
}
{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
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 ,
}
,
]
,
}
,
}
Catalogs_Update (updated)
Description :  Partially updates a catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Catalogs_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": {
          "properties": [
            {
              "#name": "syncType",
              "Enum": {
                "new": [
                  [
                    "Manual",
                    "Manual sync type."
                  ],
                  [
                    "Scheduled",
                    "Scheduled sync type."
                  ]
                ],
                "old": [
                  [
                    "Manual",
                    ""
                  ],
                  [
                    "Scheduled",
                    ""
                  ]
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "syncState",
            "Enum": {
              "new": [
                [
                  "Succeeded",
                  "Succeeded synchronization state."
                ],
                [
                  "InProgress",
                  "In progress synchronization state."
                ],
                [
                  "Failed",
                  "Failed synchronization state."
                ],
                [
                  "Canceled",
                  "Canceled synchronization state."
                ]
              ],
              "old": [
                [
                  "Succeeded",
                  ""
                ],
                [
                  "InProgress",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ]
              ]
            }
          },
          {
            "lastSyncStats": [
              {
                "syncedCatalogItemTypes": {
                  "Enum": {
                    "new": [
                      [
                        "EnvironmentDefinition",
                        "Environment definition catalog item type."
                      ],
                      [
                        "ImageDefinition",
                        "Image definition catalog item type."
                      ]
                    ],
                    "old": [
                      [
                        "EnvironmentDefinition",
                        ""
                      ],
                      [
                        "ImageDefinition",
                        ""
                      ]
                    ]
                  }
                }
              }
            ]
          },
          {
            "#name": "connectionState",
            "Enum": {
              "new": [
                [
                  "Connected",
                  "Connected state."
                ],
                [
                  "Disconnected",
                  "Disconnected state."
                ]
              ],
              "old": [
                [
                  "Connected",
                  ""
                ],
                [
                  "Disconnected",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
body:
{
Description: Updatable catalog properties. ,
Required: True ,
}
{
properties:
{
Description: Catalog properties for update. ,
Required: False ,
}
{
gitHub:
{
Description: Properties for a GitHub catalog type. ,
Required: False ,
}
{
uri:
{
Description: Git URI. ,
Required: False ,
}
string ,
branch:
{
Description: Git branch. ,
Required: False ,
}
string ,
secretIdentifier:
{
Description: A reference to the Key Vault secret containing a security token to authenticate to a Git repository. ,
Required: False ,
}
string ,
path:
{
Description: The folder where the catalog items can be found inside the repository. ,
Required: False ,
}
string ,
}
,
adoGit:
{
Description: Properties for an Azure DevOps catalog type. ,
Required: False ,
}
{
uri:
{
Description: Git URI. ,
Required: False ,
}
string ,
branch:
{
Description: Git branch. ,
Required: False ,
}
string ,
secretIdentifier:
{
Description: A reference to the Key Vault secret containing a security token to authenticate to a Git repository. ,
Required: False ,
}
string ,
path:
{
Description: The folder where the catalog items can be found inside the repository. ,
Required: False ,
}
string ,
}
,
syncType:
{
Description: Indicates the type of sync that is configured for the catalog. ,
Enum:
{
Manual: Manual sync type. ,
Scheduled: Scheduled sync type. ,
}
,
Required: False ,
}
enum ,
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
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 ,
}
,
]
,
}
,
}
Catalogs_Delete (updated)
Description :  Deletes a catalog resource.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Catalogs_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
Catalogs_Connect (updated)
Description :  Connects a catalog to enable syncing.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Catalogs_Connect",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/connect
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
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 ,
}
,
]
,
}
,
}
EnvironmentDefinitions_ListByCatalog (updated)
Description :  List environment definitions in the catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EnvironmentDefinitions_ListByCatalog",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of EnvironmentDefinition items",
        "old": "Results of the environment definition list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The EnvironmentDefinition items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "parameters": {
                    "Description": {
                      "new": "Properties of an Environment Definition parameter.",
                      "old": "Properties of an Environment Definition parameter"
                    },
                    "$properties": [
                      {
                        "#name": "id",
                        "Description": {
                          "new": "Unique ID of the parameter.",
                          "old": "Unique ID of the parameter"
                        }
                      },
                      {
                        "#name": "name",
                        "Description": {
                          "new": "Display name of the parameter.",
                          "old": "Display name of the parameter"
                        }
                      },
                      {
                        "#name": "description",
                        "Description": {
                          "new": "Description of the parameter.",
                          "old": "Description of the parameter"
                        }
                      },
                      {
                        "#name": "type",
                        "Description": {
                          "new": "A string of one of the basic JSON types (number, integer, array, object, boolean, string).",
                          "old": "A string of one of the basic JSON types (number, integer, array, object, boolean, string)"
                        }
                      },
                      {
                        "#name": "required",
                        "Description": {
                          "new": "Whether or not this parameter is required.",
                          "old": "Whether or not this parameter is required"
                        }
                      }
                    ]
                  }
                },
                {
                  "#name": "validationStatus",
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown validation status."
                      ],
                      [
                        "Pending",
                        "Pending validation status."
                      ],
                      [
                        "Succeeded",
                        "Succeeded validation status."
                      ],
                      [
                        "Failed",
                        "Failed validation status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/environmentDefinitions
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The EnvironmentDefinition items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Environment definition properties. ,
Required: False ,
}
{
description:
{
Description: A short description of the environment definition. ,
Required: False ,
}
string ,
parameters:
{
Description: Input parameters passed to an environment. ,
Required: False ,
}
[
{
id:
{
Description: Unique ID of the parameter. ,
Required: False ,
}
string ,
name:
{
Description: Display name of the parameter. ,
Required: False ,
}
string ,
description:
{
Description: Description of the parameter. ,
Required: False ,
}
string ,
type:
{
Description: A string of one of the basic JSON types (number, integer, array, object, boolean, string). ,
Enum:
{
array: The parameter accepts an array of values. ,
boolean: The parameter accepts a boolean value. ,
integer: The parameter accepts an integer value. ,
number: The parameter accepts a number value. ,
object: The parameter accepts an object value. ,
string: The parameter accepts a string value. ,
}
,
Required: False ,
}
enum ,
readOnly:
{
Description: Whether or not this parameter is read-only. If true, default should have a value. ,
Required: False ,
}
boolean ,
required:
{
Description: Whether or not this parameter is required. ,
Required: False ,
}
boolean ,
}
,
]
,
templatePath:
{
Description: Path to the Environment Definition entrypoint file. ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status for the environment definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
EnvironmentDefinitions_Get (updated)
Description :  Gets an environment definition from the catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EnvironmentDefinitions_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "parameters": {
              "Description": {
                "new": "Properties of an Environment Definition parameter.",
                "old": "Properties of an Environment Definition parameter"
              },
              "$properties": [
                {
                  "#name": "id",
                  "Description": {
                    "new": "Unique ID of the parameter.",
                    "old": "Unique ID of the parameter"
                  }
                },
                {
                  "#name": "name",
                  "Description": {
                    "new": "Display name of the parameter.",
                    "old": "Display name of the parameter"
                  }
                },
                {
                  "#name": "description",
                  "Description": {
                    "new": "Description of the parameter.",
                    "old": "Description of the parameter"
                  }
                },
                {
                  "#name": "type",
                  "Description": {
                    "new": "A string of one of the basic JSON types (number, integer, array, object, boolean, string).",
                    "old": "A string of one of the basic JSON types (number, integer, array, object, boolean, string)"
                  }
                },
                {
                  "#name": "required",
                  "Description": {
                    "new": "Whether or not this parameter is required.",
                    "old": "Whether or not this parameter is required"
                  }
                }
              ]
            }
          },
          {
            "#name": "validationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown validation status."
                ],
                [
                  "Pending",
                  "Pending validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded validation status."
                ],
                [
                  "Failed",
                  "Failed validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/environmentDefinitions/{environmentDefinitionName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
environmentDefinitionName:
{
Description: The name of the Environment Definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Environment definition properties. ,
Required: False ,
}
{
description:
{
Description: A short description of the environment definition. ,
Required: False ,
}
string ,
parameters:
{
Description: Input parameters passed to an environment. ,
Required: False ,
}
[
{
id:
{
Description: Unique ID of the parameter. ,
Required: False ,
}
string ,
name:
{
Description: Display name of the parameter. ,
Required: False ,
}
string ,
description:
{
Description: Description of the parameter. ,
Required: False ,
}
string ,
type:
{
Description: A string of one of the basic JSON types (number, integer, array, object, boolean, string). ,
Enum:
{
array: The parameter accepts an array of values. ,
boolean: The parameter accepts a boolean value. ,
integer: The parameter accepts an integer value. ,
number: The parameter accepts a number value. ,
object: The parameter accepts an object value. ,
string: The parameter accepts a string value. ,
}
,
Required: False ,
}
enum ,
readOnly:
{
Description: Whether or not this parameter is read-only. If true, default should have a value. ,
Required: False ,
}
boolean ,
required:
{
Description: Whether or not this parameter is required. ,
Required: False ,
}
boolean ,
}
,
]
,
templatePath:
{
Description: Path to the Environment Definition entrypoint file. ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status for the environment definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
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 ,
}
,
]
,
}
,
}
EnvironmentDefinitions_GetErrorDetails (updated)
Description :  Gets Environment Definition error details.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EnvironmentDefinitions_GetErrorDetails",
  "Description": {
    "new": "Gets Environment Definition error details.",
    "old": "Gets Environment Definition error details"
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/environmentDefinitions/{environmentDefinitionName}/getErrorDetails
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
environmentDefinitionName:
{
Description: The name of the Environment Definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
errors:
{
Description: Errors associated with resources synchronized from the catalog. ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
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 ,
}
,
]
,
}
,
}
Catalogs_GetSyncErrorDetails (updated)
Description :  Gets catalog synchronization error details.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Catalogs_GetSyncErrorDetails",
  "Description": {
    "new": "Gets catalog synchronization error details.",
    "old": "Gets catalog synchronization error details"
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/getSyncErrorDetails
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
operationError:
{
Description: Error information for the overall synchronization operation. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
conflicts:
{
Description: Catalog items that have conflicting names. ,
Required: False ,
}
[
{
path:
{
Description: The path of the file that has a conflicting name. ,
Required: False ,
}
string ,
name:
{
Description: Name of the conflicting catalog item. ,
Required: False ,
}
string ,
}
,
]
,
errors:
{
Description: Errors that occured during synchronization. ,
Required: False ,
}
[
{
path:
{
Description: The path of the file the error is associated with. ,
Required: False ,
}
string ,
errorDetails:
{
Description: Errors associated with the file. ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
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 ,
}
,
]
,
}
,
}
DevCenterCatalogImageDefinitions_ListByDevCenterCatalog (updated)
Description :  List Image Definitions in the catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevCenterCatalogImageDefinitions_ListByDevCenterCatalog",
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of ImageDefinition items",
        "old": "Results of the Image Definition list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The ImageDefinition items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "imageValidationStatus",
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown image validation status."
                      ],
                      [
                        "Pending",
                        "Pending image validation status."
                      ],
                      [
                        "Succeeded",
                        "Succeeded image validation status."
                      ],
                      [
                        "Failed",
                        "Failed image validation status."
                      ],
                      [
                        "TimedOut",
                        "Timed out image validation status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "TimedOut",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "validationStatus",
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown validation status."
                      ],
                      [
                        "Pending",
                        "Pending validation status."
                      ],
                      [
                        "Succeeded",
                        "Succeeded validation status."
                      ],
                      [
                        "Failed",
                        "Failed validation status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "autoImageBuild",
                  "Enum": {
                    "new": [
                      [
                        "Disabled",
                        "Auto image build is disabled."
                      ],
                      [
                        "Enabled",
                        "Auto image build is enabled."
                      ]
                    ],
                    "old": [
                      [
                        "Disabled",
                        ""
                      ],
                      [
                        "Enabled",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/imageDefinitions
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The ImageDefinition items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Image Definition properties ,
Required: False ,
}
{
imageReference:
{
Description: Image reference information. ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
fileUrl:
{
Description: The URL to the repository file containing the image definition. ,
Required: False ,
}
string ,
latestBuild:
{
Description: Details about the latest build. ,
Required: False ,
}
{
name:
{
Description: Identifier of a build. ,
Required: False ,
}
string ,
startTime:
{
Description: Start time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
status:
{
Description: The state of an Image Definition Build. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
}
,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Image Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
autoImageBuild:
{
Description: Indicates if automatic image builds will be triggered for image definition updates ,
Enum:
{
Disabled: Auto image build is disabled. ,
Enabled: Auto image build is enabled. ,
}
,
Required: False ,
}
enum ,
tasks:
{
Description: Tasks to run at Dev Box provisioning time. ,
Required: False ,
}
[
{
name:
{
Description: Name of the task. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the task. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
displayName:
{
Description: Display name to help differentiate multiple instances of the same task. ,
Required: False ,
}
string ,
timeoutInSeconds:
{
Description: Timeout, in seconds. Overrides any timeout provided on the task definition. ,
Format: int32 ,
Required: False ,
}
integer ,
condition:
{
Description: An expression that must evaluate to true in order for the task to run. ,
Required: False ,
}
string ,
}
,
]
,
userTasks:
{
Description: Tasks to run when a user first logs into a Dev Box. ,
Required: False ,
}
[
{
name:
{
Description: Name of the task. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the task. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
displayName:
{
Description: Display name to help differentiate multiple instances of the same task. ,
Required: False ,
}
string ,
timeoutInSeconds:
{
Description: Timeout, in seconds. Overrides any timeout provided on the task definition. ,
Format: int32 ,
Required: False ,
}
integer ,
condition:
{
Description: An expression that must evaluate to true in order for the task to run. ,
Required: False ,
}
string ,
}
,
]
,
extends:
{
Description: Another Image Definition that this one extends. ,
Required: False ,
}
{
imageDefinition:
{
Description: Name of the referenced Image Definition. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the referenced Image Definition. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
}
,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
DevCenterCatalogImageDefinitions_GetByDevCenterCatalog (updated)
Description :  Gets an Image Definition from the catalog
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevCenterCatalogImageDefinitions_GetByDevCenterCatalog",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "imageValidationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown image validation status."
                ],
                [
                  "Pending",
                  "Pending image validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded image validation status."
                ],
                [
                  "Failed",
                  "Failed image validation status."
                ],
                [
                  "TimedOut",
                  "Timed out image validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "TimedOut",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "validationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown validation status."
                ],
                [
                  "Pending",
                  "Pending validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded validation status."
                ],
                [
                  "Failed",
                  "Failed validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "autoImageBuild",
            "Enum": {
              "new": [
                [
                  "Disabled",
                  "Auto image build is disabled."
                ],
                [
                  "Enabled",
                  "Auto image build is enabled."
                ]
              ],
              "old": [
                [
                  "Disabled",
                  ""
                ],
                [
                  "Enabled",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/imageDefinitions/{imageDefinitionName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
imageDefinitionName:
{
Description: The name of the Image Definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Image Definition properties ,
Required: False ,
}
{
imageReference:
{
Description: Image reference information. ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
fileUrl:
{
Description: The URL to the repository file containing the image definition. ,
Required: False ,
}
string ,
latestBuild:
{
Description: Details about the latest build. ,
Required: False ,
}
{
name:
{
Description: Identifier of a build. ,
Required: False ,
}
string ,
startTime:
{
Description: Start time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
status:
{
Description: The state of an Image Definition Build. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
}
,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Image Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
autoImageBuild:
{
Description: Indicates if automatic image builds will be triggered for image definition updates ,
Enum:
{
Disabled: Auto image build is disabled. ,
Enabled: Auto image build is enabled. ,
}
,
Required: False ,
}
enum ,
tasks:
{
Description: Tasks to run at Dev Box provisioning time. ,
Required: False ,
}
[
{
name:
{
Description: Name of the task. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the task. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
displayName:
{
Description: Display name to help differentiate multiple instances of the same task. ,
Required: False ,
}
string ,
timeoutInSeconds:
{
Description: Timeout, in seconds. Overrides any timeout provided on the task definition. ,
Format: int32 ,
Required: False ,
}
integer ,
condition:
{
Description: An expression that must evaluate to true in order for the task to run. ,
Required: False ,
}
string ,
}
,
]
,
userTasks:
{
Description: Tasks to run when a user first logs into a Dev Box. ,
Required: False ,
}
[
{
name:
{
Description: Name of the task. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the task. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
displayName:
{
Description: Display name to help differentiate multiple instances of the same task. ,
Required: False ,
}
string ,
timeoutInSeconds:
{
Description: Timeout, in seconds. Overrides any timeout provided on the task definition. ,
Format: int32 ,
Required: False ,
}
integer ,
condition:
{
Description: An expression that must evaluate to true in order for the task to run. ,
Required: False ,
}
string ,
}
,
]
,
extends:
{
Description: Another Image Definition that this one extends. ,
Required: False ,
}
{
imageDefinition:
{
Description: Name of the referenced Image Definition. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the referenced Image Definition. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
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 ,
}
,
]
,
}
,
}
DevCenterCatalogImageDefinitionBuilds_ListByImageDefinition (updated)
Description :  Lists builds for a specified image definition.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevCenterCatalogImageDefinitionBuilds_ListByImageDefinition",
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of ImageDefinitionBuild items",
        "old": "Results of the Image Definition Build list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The ImageDefinitionBuild items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/imageDefinitions/{imageDefinitionName}/builds
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
imageDefinitionName:
{
Description: The name of the Image Definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The ImageDefinitionBuild items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Image Definition Build properties ,
Required: False ,
}
{
imageReference:
{
Description: The specific image version used by the build. ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
status:
{
Description: The status of the build. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
errorDetails:
{
Description: Details for image creation error. Populated when the image creation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
DevCenterCatalogImageDefinitionBuild_GetBuildDetails (updated)
Description :  Gets Build details.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevCenterCatalogImageDefinitionBuild_GetBuildDetails",
  "Description": {
    "new": "Gets Build details.",
    "old": "Gets Build details"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/imageDefinitions/{imageDefinitionName}/builds/{buildName}/getBuildDetails
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
imageDefinitionName:
{
Description: The name of the Image Definition. ,
Required: True ,
}
string ,
buildName:
{
Description: The ID of the Image Definition Build. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
imageReference:
{
Description: The specific image version used by the build. ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
status:
{
Description: The status of the build. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
errorDetails:
{
Description: Details for image creation error. Populated when the image creation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
taskGroups:
{
Description: The list of task groups executed during the image definition build. ,
Required: False ,
}
[
{
name:
{
Description: The name of the task group. ,
Required: False ,
}
string ,
status:
{
Description: The status of the task group. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
tasks:
{
Description: The list of tasks executed during the task group. ,
Required: False ,
}
[
{
name:
{
Description: The name of the task. ,
Required: False ,
}
string ,
parameters:
{
Description: Parameters for the task. ,
Required: False ,
}
[
{
key:
{
Description: Key of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: Value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
displayName:
{
Description: Display name to help differentiate multiple instances of the same task. ,
Required: False ,
}
string ,
id:
{
Description: ID of the task instance. ,
Required: False ,
}
string ,
startTime:
{
Description: Start time of the task. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task. ,
Format: date-time ,
Required: False ,
}
string ,
status:
{
Description: The status of the task. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
logUri:
{
Description: The URI for retrieving logs for the task execution. ,
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 ,
}
,
]
,
}
,
}
DevCenterCatalogImageDefinitions_GetErrorDetails (updated)
Description :  Gets Image Definition error details.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevCenterCatalogImageDefinitions_GetErrorDetails",
  "Description": {
    "new": "Gets Image Definition error details.",
    "old": "Gets Image Definition error details"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/imageDefinitions/{imageDefinitionName}/getErrorDetails
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
imageDefinitionName:
{
Description: The name of the Image Definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
errors:
{
Description: Errors associated with resources synchronized from the catalog. ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
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 ,
}
,
]
,
}
,
}
Catalogs_Sync (updated)
Description :  Syncs templates for a template source.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Catalogs_Sync",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/sync
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
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 ,
}
,
]
,
}
,
}
CustomizationTasks_ListByCatalog (updated)
Description :  List Tasks in the catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CustomizationTasks_ListByCatalog",
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of CustomizationTask items",
        "old": "Results of the Task list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The CustomizationTask items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "validationStatus",
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown validation status."
                      ],
                      [
                        "Pending",
                        "Pending validation status."
                      ],
                      [
                        "Succeeded",
                        "Succeeded validation status."
                      ],
                      [
                        "Failed",
                        "Failed validation status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/tasks
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The CustomizationTask items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Task properties ,
Required: False ,
}
{
inputs:
{
Description: Inputs to the task. ,
Required: False ,
}
object ,
timeout:
{
Description: The default timeout for the task. ,
Format: int32 ,
Required: False ,
}
integer ,
validationStatus:
{
Description: Validation status for the Task. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
CustomizationTasks_Get (updated)
Description :  Gets a Task from the catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CustomizationTasks_Get",
  "Description": {
    "new": "Gets a Task from the catalog.",
    "old": "Gets a Task from the catalog"
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "validationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown validation status."
                ],
                [
                  "Pending",
                  "Pending validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded validation status."
                ],
                [
                  "Failed",
                  "Failed validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/tasks/{taskName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
taskName:
{
Description: The name of the Customization Task. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Task properties ,
Required: False ,
}
{
inputs:
{
Description: Inputs to the task. ,
Required: False ,
}
object ,
timeout:
{
Description: The default timeout for the task. ,
Format: int32 ,
Required: False ,
}
integer ,
validationStatus:
{
Description: Validation status for the Task. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
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 ,
}
,
]
,
}
,
}
CustomizationTasks_GetErrorDetails (updated)
Description :  Gets Customization Task error details.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CustomizationTasks_GetErrorDetails",
  "Description": {
    "new": "Gets Customization Task error details.",
    "old": "Gets Customization Task error details"
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/catalogs/{catalogName}/tasks/{taskName}/getErrorDetails
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
taskName:
{
Description: The name of the Customization Task. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
errors:
{
Description: Errors associated with resources synchronized from the catalog. ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
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 ,
}
,
]
,
}
,
}
DevBoxDefinitions_ListByDevCenter (updated)
Description :  List Dev Box definitions for a devcenter.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevBoxDefinitions_ListByDevCenter",
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of DevBoxDefinition items",
        "old": "Results of the Dev Box definition list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The DevBoxDefinition items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "imageValidationStatus",
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown image validation status."
                      ],
                      [
                        "Pending",
                        "Pending image validation status."
                      ],
                      [
                        "Succeeded",
                        "Succeeded image validation status."
                      ],
                      [
                        "Failed",
                        "Failed image validation status."
                      ],
                      [
                        "TimedOut",
                        "Timed out image validation status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "TimedOut",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "validationStatus",
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown validation status."
                      ],
                      [
                        "Pending",
                        "Pending validation status."
                      ],
                      [
                        "Succeeded",
                        "Succeeded validation status."
                      ],
                      [
                        "Failed",
                        "Failed validation status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/devboxdefinitions
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The DevBoxDefinition items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Dev Box definition properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Dev Box Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
DevBoxDefinitions_Get (updated)
Description :  Gets a Dev Box definition.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevBoxDefinitions_Get",
  "Description": {
    "new": "Gets a Dev Box definition.",
    "old": "Gets a Dev Box definition"
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "imageValidationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown image validation status."
                ],
                [
                  "Pending",
                  "Pending image validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded image validation status."
                ],
                [
                  "Failed",
                  "Failed image validation status."
                ],
                [
                  "TimedOut",
                  "Timed out image validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "TimedOut",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "validationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown validation status."
                ],
                [
                  "Pending",
                  "Pending validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded validation status."
                ],
                [
                  "Failed",
                  "Failed validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/devboxdefinitions/{devBoxDefinitionName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
devBoxDefinitionName:
{
Description: The name of the Dev Box definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Dev Box definition properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Dev Box Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
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 ,
}
,
]
,
}
,
}
DevBoxDefinitions_CreateOrUpdate (updated)
Description :  Creates or updates a Dev Box definition.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevBoxDefinitions_CreateOrUpdate",
  "$parameters": {
    "@added_4d07f8ce10c34fdf83752c4b478cbc44": {
      "#name": "api-version",
      "Description": "The API version to use for this operation.",
      "Required": true,
      "Type": "string"
    },
    "@added_6c9315a216dd44fa83e71267e1ce59e4": {
      "#name": "subscriptionId",
      "Description": "The ID of the target subscription. The value must be an UUID.",
      "Format": "uuid",
      "Required": true,
      "Type": "string"
    },
    "@added_175ec96ac786414592819ccaa01066d4": {
      "#name": "resourceGroupName",
      "Description": "The name of the resource group. The name is case insensitive.",
      "Required": true,
      "Type": "string"
    },
    "@added_ea52ee41f2e74367805c9c643478542f": {
      "#name": "devCenterName",
      "Description": "The name of the devcenter.",
      "Required": true,
      "Type": "string"
    },
    "@added_dcd52c21fdaa4e55a82d3c312b89ee39": {
      "#name": "devBoxDefinitionName",
      "Description": "The name of the Dev Box definition.",
      "Required": true,
      "Type": "string"
    },
    "body": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "imageValidationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown image validation status."
                ],
                [
                  "Pending",
                  "Pending image validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded image validation status."
                ],
                [
                  "Failed",
                  "Failed image validation status."
                ],
                [
                  "TimedOut",
                  "Timed out image validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "TimedOut",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "validationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown validation status."
                ],
                [
                  "Pending",
                  "Pending validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded validation status."
                ],
                [
                  "Failed",
                  "Failed validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "imageValidationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown image validation status."
                ],
                [
                  "Pending",
                  "Pending image validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded image validation status."
                ],
                [
                  "Failed",
                  "Failed image validation status."
                ],
                [
                  "TimedOut",
                  "Timed out image validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "TimedOut",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "validationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown validation status."
                ],
                [
                  "Pending",
                  "Pending validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded validation status."
                ],
                [
                  "Failed",
                  "Failed validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "imageValidationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown image validation status."
                ],
                [
                  "Pending",
                  "Pending image validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded image validation status."
                ],
                [
                  "Failed",
                  "Failed image validation status."
                ],
                [
                  "TimedOut",
                  "Timed out image validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "TimedOut",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "validationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown validation status."
                ],
                [
                  "Pending",
                  "Pending validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded validation status."
                ],
                [
                  "Failed",
                  "Failed validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/devboxdefinitions/{devBoxDefinitionName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
devBoxDefinitionName:
{
Description: The name of the Dev Box definition. ,
Required: True ,
}
string ,
body:
{
Description: Represents a Dev Box definition. ,
Required: True ,
}
{
properties:
{
Description: Dev Box definition properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Dev Box Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Dev Box definition properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Dev Box Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ 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: Represents a definition for a Developer Machine. ,
}
{
properties:
{
Description: Dev Box definition properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Dev Box Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
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 ,
}
,
]
,
}
,
}
DevBoxDefinitions_Update (updated)
Description :  Partially updates a Dev Box definition.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevBoxDefinitions_Update",
  "$parameters": {
    "@added_64226939f8354b4bae35cdfaf42c4270": {
      "#name": "api-version",
      "Description": "The API version to use for this operation.",
      "Required": true,
      "Type": "string"
    },
    "@added_b1ca01f037ed473bb1f452dad53511b4": {
      "#name": "subscriptionId",
      "Description": "The ID of the target subscription. The value must be an UUID.",
      "Format": "uuid",
      "Required": true,
      "Type": "string"
    },
    "@added_46347ab1525a45ce8fd5233a1589b5d8": {
      "#name": "resourceGroupName",
      "Description": "The name of the resource group. The name is case insensitive.",
      "Required": true,
      "Type": "string"
    },
    "@added_d43571ddd1f3466c85fc5db63aa768aa": {
      "#name": "devCenterName",
      "Description": "The name of the devcenter.",
      "Required": true,
      "Type": "string"
    },
    "@added_9df474a3d1b04b219e817a1ed97928bd": {
      "#name": "devBoxDefinitionName",
      "Description": "The name of the Dev Box definition.",
      "Required": true,
      "Type": "string"
    },
    "body": {
      "$properties": {
        "@added_d0bb6d46d3084a968d276897a68cb7f5": {
          "#name": "tags",
          "Description": "Resource tags.",
          "Required": false,
          "Type": "object"
        },
        "@added_2a8f222658a74d7cbdadfabec374c10f": {
          "#name": "location",
          "Description": "The geo-location where the resource lives.",
          "Required": false,
          "Type": "string"
        },
        "properties": [
          {
            "#name": "hibernateSupport",
            "Enum": {
              "new": [
                [
                  "Disabled",
                  "Hibernate is disabled."
                ],
                [
                  "Enabled",
                  "Hibernate is enabled."
                ]
              ],
              "old": [
                [
                  "Disabled",
                  ""
                ],
                [
                  "Enabled",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "imageValidationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown image validation status."
                ],
                [
                  "Pending",
                  "Pending image validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded image validation status."
                ],
                [
                  "Failed",
                  "Failed image validation status."
                ],
                [
                  "TimedOut",
                  "Timed out image validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "TimedOut",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "validationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown validation status."
                ],
                [
                  "Pending",
                  "Pending validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded validation status."
                ],
                [
                  "Failed",
                  "Failed validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/devboxdefinitions/{devBoxDefinitionName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
devBoxDefinitionName:
{
Description: The name of the Dev Box definition. ,
Required: True ,
}
string ,
body:
{
Description: Represents a Dev Box definition. ,
Required: True ,
}
{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The geo-location where the resource lives. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of a Dev Box definition to be updated. ,
Required: False ,
}
{
imageReference:
{
Description: Image reference information. ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
sku:
{
Description: The SKU for Dev Boxes created using this definition. ,
Required: False ,
}
{
name:
{
Description: The name of the SKU. E.g. P3. It is typically a letter+number code ,
Required: True ,
}
string ,
tier:
{
Description: This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT. ,
Enum:
{
Free: No description available. ,
Basic: No description available. ,
Standard: No description available. ,
Premium: No description available. ,
}
,
Required: False ,
}
enum ,
size:
{
Description: The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code. ,
Required: False ,
}
string ,
family:
{
Description: If the service has different generations of hardware, for the same SKU, then that can be captured here. ,
Required: False ,
}
string ,
capacity:
{
Description: If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
osStorageType:
{
Description: The storage type used for the Operating System disk of Dev Boxes created using this definition. ,
Required: False ,
}
string ,
hibernateSupport:
{
Description: Indicates whether Dev Boxes created with this definition are capable of hibernation. Not all images are capable of supporting hibernation. To find out more see https://aka.ms/devbox/hibernate ,
Enum:
{
Disabled: Hibernate is disabled. ,
Enabled: Hibernate is enabled. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Dev Box definition properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Dev Box Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
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 ,
}
,
]
,
}
,
}
DevBoxDefinitions_Delete (updated)
Description :  Deletes a Dev Box definition.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevBoxDefinitions_Delete",
  "Description": {
    "new": "Deletes a Dev Box definition.",
    "old": "Deletes a Dev Box definition"
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/devboxdefinitions/{devBoxDefinitionName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
devBoxDefinitionName:
{
Description: The name of the Dev Box definition. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
EncryptionSets_List (updated)
Description :  Lists all encryption sets in the devcenter.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EncryptionSets_List",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of DevCenterEncryptionSet items",
        "old": "Result of the list devcenter encryption set operation"
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The DevCenterEncryptionSet items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": [
              {
                "properties": [
                  {
                    "#name": "provisioningState",
                    "Enum": {
                      "new": [
                        [
                          "NotSpecified",
                          "Not specified provisioning state."
                        ],
                        [
                          "Accepted",
                          "Accepted provisioning state."
                        ],
                        [
                          "Running",
                          "Running provisioning state."
                        ],
                        [
                          "Creating",
                          "Creating provisioning state."
                        ],
                        [
                          "Created",
                          "Created provisioning state."
                        ],
                        [
                          "Updating",
                          "Updating provisioning state."
                        ],
                        [
                          "Updated",
                          "Updated provisioning state."
                        ],
                        [
                          "Deleting",
                          "Deleting provisioning state."
                        ],
                        [
                          "Deleted",
                          "Deleted provisioning state."
                        ],
                        [
                          "Succeeded",
                          "Succeeded provisioning state."
                        ],
                        [
                          "Failed",
                          "Failed provisioning state."
                        ],
                        [
                          "Canceled",
                          "Canceled provisioning state."
                        ],
                        [
                          "MovingResources",
                          "Moving resources provisioning state."
                        ],
                        [
                          "TransientFailure",
                          "Transient failure provisioning state."
                        ],
                        [
                          "RolloutInProgress",
                          "Rollout in progress provisioning state."
                        ],
                        [
                          "StorageProvisioningFailed",
                          "Storage provisioning failed provisioning state."
                        ]
                      ],
                      "old": [
                        [
                          "NotSpecified",
                          ""
                        ],
                        [
                          "Accepted",
                          ""
                        ],
                        [
                          "Running",
                          ""
                        ],
                        [
                          "Creating",
                          ""
                        ],
                        [
                          "Created",
                          ""
                        ],
                        [
                          "Updating",
                          ""
                        ],
                        [
                          "Updated",
                          ""
                        ],
                        [
                          "Deleting",
                          ""
                        ],
                        [
                          "Deleted",
                          ""
                        ],
                        [
                          "Succeeded",
                          ""
                        ],
                        [
                          "Failed",
                          ""
                        ],
                        [
                          "Canceled",
                          ""
                        ],
                        [
                          "MovingResources",
                          ""
                        ],
                        [
                          "TransientFailure",
                          ""
                        ],
                        [
                          "RolloutInProgress",
                          ""
                        ],
                        [
                          "StorageProvisioningFailed",
                          ""
                        ]
                      ]
                    }
                  }
                ]
              },
              {
                "#name": "identity",
                "Description": {
                  "new": "Managed identity properties.",
                  "old": "Managed identity properties"
                }
              }
            ]
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/encryptionSets
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The DevCenterEncryptionSet items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Properties of a devcenter encryption set. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
EncryptionSets_Get (updated)
Description :  Gets a devcenter encryption set.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EncryptionSets_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/encryptionSets/{encryptionSetName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
encryptionSetName:
{
Description: The name of the devcenter encryption set. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a devcenter encryption set. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ 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 ,
}
,
]
,
}
,
}
EncryptionSets_CreateOrUpdate (updated)
Description :  Creates or updates a devcenter encryption set resource.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EncryptionSets_CreateOrUpdate",
  "Description": {
    "new": "Creates or updates a devcenter encryption set resource.",
    "old": "Creates or updates a devcenter encryption set resource"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": [
          {
            "properties": [
              {
                "#name": "provisioningState",
                "Enum": {
                  "new": [
                    [
                      "NotSpecified",
                      "Not specified provisioning state."
                    ],
                    [
                      "Accepted",
                      "Accepted provisioning state."
                    ],
                    [
                      "Running",
                      "Running provisioning state."
                    ],
                    [
                      "Creating",
                      "Creating provisioning state."
                    ],
                    [
                      "Created",
                      "Created provisioning state."
                    ],
                    [
                      "Updating",
                      "Updating provisioning state."
                    ],
                    [
                      "Updated",
                      "Updated provisioning state."
                    ],
                    [
                      "Deleting",
                      "Deleting provisioning state."
                    ],
                    [
                      "Deleted",
                      "Deleted provisioning state."
                    ],
                    [
                      "Succeeded",
                      "Succeeded provisioning state."
                    ],
                    [
                      "Failed",
                      "Failed provisioning state."
                    ],
                    [
                      "Canceled",
                      "Canceled provisioning state."
                    ],
                    [
                      "MovingResources",
                      "Moving resources provisioning state."
                    ],
                    [
                      "TransientFailure",
                      "Transient failure provisioning state."
                    ],
                    [
                      "RolloutInProgress",
                      "Rollout in progress provisioning state."
                    ],
                    [
                      "StorageProvisioningFailed",
                      "Storage provisioning failed provisioning state."
                    ]
                  ],
                  "old": [
                    [
                      "NotSpecified",
                      ""
                    ],
                    [
                      "Accepted",
                      ""
                    ],
                    [
                      "Running",
                      ""
                    ],
                    [
                      "Creating",
                      ""
                    ],
                    [
                      "Created",
                      ""
                    ],
                    [
                      "Updating",
                      ""
                    ],
                    [
                      "Updated",
                      ""
                    ],
                    [
                      "Deleting",
                      ""
                    ],
                    [
                      "Deleted",
                      ""
                    ],
                    [
                      "Succeeded",
                      ""
                    ],
                    [
                      "Failed",
                      ""
                    ],
                    [
                      "Canceled",
                      ""
                    ],
                    [
                      "MovingResources",
                      ""
                    ],
                    [
                      "TransientFailure",
                      ""
                    ],
                    [
                      "RolloutInProgress",
                      ""
                    ],
                    [
                      "StorageProvisioningFailed",
                      ""
                    ]
                  ]
                }
              }
            ]
          },
          {
            "#name": "identity",
            "Description": {
              "new": "Managed identity properties.",
              "old": "Managed identity properties"
            }
          }
        ]
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    },
    "201": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/encryptionSets/{encryptionSetName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
encryptionSetName:
{
Description: The name of the devcenter encryption set. ,
Required: True ,
}
string ,
body:
{
Description: Represents a devcenter encryption set. ,
Required: True ,
}
{
properties:
{
Description: Properties of a devcenter encryption set. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a devcenter encryption set. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ 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: Represents a devcenter encryption set resource. ,
}
{
properties:
{
Description: Properties of a devcenter encryption set. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ 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 ,
}
,
]
,
}
,
}
EncryptionSets_Update (updated)
Description :  Partially updates a devcenter encryption set.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EncryptionSets_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": {
          "@added_6af0f05cf6b14429911e257f44b42792": {
            "#name": "tags",
            "Description": "Resource tags.",
            "Required": false,
            "Type": "object"
          },
          "@added_5f285366c9f246b29ba49f17652a549b": {
            "#name": "location",
            "Description": "The geo-location where the resource lives.",
            "Required": false,
            "Type": "string"
          },
          "properties": [
            {
              "#name": "devboxDisksEncryptionEnableStatus",
              "Enum": {
                "new": [
                  [
                    "Enabled",
                    "Devbox disks encryption is enabled."
                  ],
                  [
                    "Disabled",
                    "Devbox disks encryption is disabled."
                  ]
                ],
                "old": [
                  [
                    "Enabled",
                    ""
                  ],
                  [
                    "Disabled",
                    ""
                  ]
                ]
              }
            },
            {
              "keyEncryptionKeyIdentity": [
                {
                  "#name": "type",
                  "Enum": {
                    "new": [
                      [
                        "SystemAssigned",
                        "System assigned identity type."
                      ],
                      [
                        "UserAssigned",
                        "User assigned identity type."
                      ]
                    ],
                    "old": [
                      [
                        "SystemAssigned",
                        ""
                      ],
                      [
                        "UserAssigned",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/encryptionSets/{encryptionSetName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
encryptionSetName:
{
Description: The name of the devcenter encryption set. ,
Required: True ,
}
string ,
body:
{
Description: Updatable devcenter encryption set properties. ,
Required: True ,
}
{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The geo-location where the resource lives. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of a Dev Center encryption set to be updated. ,
Required: False ,
}
{
devboxDisksEncryptionEnableStatus:
{
Description: Devbox disk encryption enable or disable status. Indicates if Devbox disks encryption using DevCenter CMK is enabled or not. ,
Enum:
{
Enabled: Devbox disks encryption is enabled. ,
Disabled: Devbox disks encryption is disabled. ,
}
,
Required: False ,
}
enum ,
keyEncryptionKeyUrl:
{
Description: Key encryption key Url, versioned or non-versioned. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 or https://contosovault.vault.azure.net/keys/contosokek. ,
Format: uri ,
Required: False ,
}
string ,
keyEncryptionKeyIdentity:
{
Description: The managed identity configuration used for key vault access. ,
Required: False ,
}
{
type:
{
Description: The type of managed identity to use for key vault access. ,
Enum:
{
SystemAssigned: System assigned identity type. ,
UserAssigned: User assigned identity type. ,
}
,
Required: False ,
}
enum ,
userAssignedIdentityResourceId:
{
Description: For system assigned identity, this will be null. For user assigned identity, this should be the resource ID of the identity. ,
Required: False ,
}
string ,
}
,
}
,
identity:
{
Description: Managed identity properties ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a devcenter encryption set. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
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 ,
}
,
]
,
}
,
}
EncryptionSets_Delete (updated)
Description :  Deletes a devcenter encryption set.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EncryptionSets_Delete",
  "Description": {
    "new": "Deletes a devcenter encryption set.",
    "old": "Deletes a devcenter encryption set"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/encryptionSets/{encryptionSetName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
encryptionSetName:
{
Description: The name of the devcenter encryption set. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
EnvironmentTypes_ListByDevCenter (updated)
Description :  Lists environment types for the devcenter.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EnvironmentTypes_ListByDevCenter",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of EnvironmentType items",
        "old": "Result of the environment type list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The EnvironmentType items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/environmentTypes
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The EnvironmentType items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
EnvironmentTypes_Get (updated)
Description :  Gets an environment type.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EnvironmentTypes_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/environmentTypes/{environmentTypeName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
environmentTypeName:
{
Description: The name of the environment type. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
}

⚐ 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 ,
}
,
]
,
}
,
}
EnvironmentTypes_CreateOrUpdate (updated)
Description :  Creates or updates an environment type.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EnvironmentTypes_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/environmentTypes/{environmentTypeName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
environmentTypeName:
{
Description: The name of the environment type. ,
Required: True ,
}
string ,
body:
{
Description: Represents an Environment Type. ,
Required: True ,
}
{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
}

⚐ 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 ,
}
,
]
,
}
,
}
EnvironmentTypes_Update (updated)
Description :  Partially updates an environment type.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EnvironmentTypes_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/environmentTypes/{environmentTypeName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
environmentTypeName:
{
Description: The name of the environment type. ,
Required: True ,
}
string ,
body:
{
Description: Updatable environment type properties. ,
Required: True ,
}
{
properties:
{
Description: Properties of an environment type to be updated. ,
Required: False ,
}
{
displayName:
{
Description: The display name of the environment type. ,
Required: False ,
}
string ,
}
,
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
}

⚐ 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 ,
}
,
]
,
}
,
}
EnvironmentTypes_Delete (updated)
Description :  Deletes an environment type.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EnvironmentTypes_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/environmentTypes/{environmentTypeName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
environmentTypeName:
{
Description: The name of the environment type. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
Galleries_ListByDevCenter (updated)
Description :  Lists galleries for a devcenter.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Galleries_ListByDevCenter",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of Gallery items",
        "old": "Results of the gallery list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The Gallery items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/galleries
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The Gallery items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Gallery properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
galleryResourceId:
{
Description: The resource ID of the backing Azure Compute Gallery. ,
Required: True ,
}
string ,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
Galleries_Get (updated)
Description :  Gets a gallery.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Galleries_Get",
  "Description": {
    "new": "Gets a gallery.",
    "old": "Gets a gallery"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/galleries/{galleryName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
galleryName:
{
Description: The name of the gallery. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Gallery properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
galleryResourceId:
{
Description: The resource ID of the backing Azure Compute Gallery. ,
Required: True ,
}
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 ,
}
,
]
,
}
,
}
Galleries_CreateOrUpdate (updated)
Description :  Creates or updates a gallery.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Galleries_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/galleries/{galleryName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
galleryName:
{
Description: The name of the gallery. ,
Required: True ,
}
string ,
body:
{
Description: Represents a gallery. ,
Required: True ,
}
{
properties:
{
Description: Gallery properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
galleryResourceId:
{
Description: The resource ID of the backing Azure Compute Gallery. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Gallery properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
galleryResourceId:
{
Description: The resource ID of the backing Azure Compute Gallery. ,
Required: True ,
}
string ,
}
,
}

⚐ 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: Represents a gallery. ,
}
{
properties:
{
Description: Gallery properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
galleryResourceId:
{
Description: The resource ID of the backing Azure Compute Gallery. ,
Required: True ,
}
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 ,
}
,
]
,
}
,
}
Galleries_Delete (updated)
Description :  Deletes a gallery resource.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Galleries_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/galleries/{galleryName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
galleryName:
{
Description: The name of the gallery. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
Images_ListByGallery (updated)
Description :  Lists images for a gallery.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Images_ListByGallery",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of Image items",
        "old": "Results of the image list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The Image items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "hibernateSupport",
                  "Enum": {
                    "new": [
                      [
                        "Disabled",
                        "Hibernate is disabled."
                      ],
                      [
                        "Enabled",
                        "Hibernate is enabled."
                      ]
                    ],
                    "old": [
                      [
                        "Disabled",
                        ""
                      ],
                      [
                        "Enabled",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/galleries/{galleryName}/images
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
galleryName:
{
Description: The name of the gallery. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The Image items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Image properties. ,
Required: False ,
}
{
description:
{
Description: The description of the image. ,
Required: False ,
}
string ,
publisher:
{
Description: The publisher of the image. ,
Required: False ,
}
string ,
offer:
{
Description: The name of the image offer. ,
Required: False ,
}
string ,
sku:
{
Description: The SKU name for the image. ,
Required: False ,
}
string ,
recommendedMachineConfiguration:
{
Description: The recommended machine configuration to use with the image. ,
Required: False ,
}
{
memory:
{
Description: Recommended memory range. ,
Required: False ,
}
{
min:
{
Description: Minimum value. ,
Format: int32 ,
Required: False ,
}
integer ,
max:
{
Description: Maximum value. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
vCPUs:
{
Description: Recommended vCPU range. ,
Required: False ,
}
{
min:
{
Description: Minimum value. ,
Format: int32 ,
Required: False ,
}
integer ,
max:
{
Description: Maximum value. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
hibernateSupport:
{
Description: Indicates whether this image has hibernate enabled. Not all images are capable of supporting hibernation. To find out more see https://aka.ms/devbox/hibernate ,
Enum:
{
Disabled: Hibernate is disabled. ,
Enabled: Hibernate is enabled. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
Images_Get (updated)
Description :  Gets a gallery image.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Images_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "hibernateSupport",
            "Enum": {
              "new": [
                [
                  "Disabled",
                  "Hibernate is disabled."
                ],
                [
                  "Enabled",
                  "Hibernate is enabled."
                ]
              ],
              "old": [
                [
                  "Disabled",
                  ""
                ],
                [
                  "Enabled",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/galleries/{galleryName}/images/{imageName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
galleryName:
{
Description: The name of the gallery. ,
Required: True ,
}
string ,
imageName:
{
Description: The name of the image. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Image properties. ,
Required: False ,
}
{
description:
{
Description: The description of the image. ,
Required: False ,
}
string ,
publisher:
{
Description: The publisher of the image. ,
Required: False ,
}
string ,
offer:
{
Description: The name of the image offer. ,
Required: False ,
}
string ,
sku:
{
Description: The SKU name for the image. ,
Required: False ,
}
string ,
recommendedMachineConfiguration:
{
Description: The recommended machine configuration to use with the image. ,
Required: False ,
}
{
memory:
{
Description: Recommended memory range. ,
Required: False ,
}
{
min:
{
Description: Minimum value. ,
Format: int32 ,
Required: False ,
}
integer ,
max:
{
Description: Maximum value. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
vCPUs:
{
Description: Recommended vCPU range. ,
Required: False ,
}
{
min:
{
Description: Minimum value. ,
Format: int32 ,
Required: False ,
}
integer ,
max:
{
Description: Maximum value. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
hibernateSupport:
{
Description: Indicates whether this image has hibernate enabled. Not all images are capable of supporting hibernation. To find out more see https://aka.ms/devbox/hibernate ,
Enum:
{
Disabled: Hibernate is disabled. ,
Enabled: Hibernate is enabled. ,
}
,
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 ,
}
,
]
,
}
,
}
ImageVersions_ListByImage (updated)
Description :  Lists versions for an image.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ImageVersions_ListByImage",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of ImageVersion items",
        "old": "Results of the image version list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The ImageVersion items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/galleries/{galleryName}/images/{imageName}/versions
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
galleryName:
{
Description: The name of the gallery. ,
Required: True ,
}
string ,
imageName:
{
Description: The name of the image. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The ImageVersion items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Image version properties. ,
Required: False ,
}
{
name:
{
Description: The semantic version string. ,
Required: False ,
}
string ,
publishedDate:
{
Description: The datetime that the backing image version was published. ,
Format: date-time ,
Required: False ,
}
string ,
excludeFromLatest:
{
Description: If the version should be excluded from being treated as the latest version. ,
Required: False ,
}
boolean ,
osDiskImageSizeInGb:
{
Description: The size of the OS disk image, in GB. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ImageVersions_Get (updated)
Description :  Gets an image version.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ImageVersions_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/galleries/{galleryName}/images/{imageName}/versions/{versionName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
galleryName:
{
Description: The name of the gallery. ,
Required: True ,
}
string ,
imageName:
{
Description: The name of the image. ,
Required: True ,
}
string ,
versionName:
{
Description: The version of the image. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Image version properties. ,
Required: False ,
}
{
name:
{
Description: The semantic version string. ,
Required: False ,
}
string ,
publishedDate:
{
Description: The datetime that the backing image version was published. ,
Format: date-time ,
Required: False ,
}
string ,
excludeFromLatest:
{
Description: If the version should be excluded from being treated as the latest version. ,
Required: False ,
}
boolean ,
osDiskImageSizeInGb:
{
Description: The size of the OS disk image, in GB. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
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 ,
}
,
]
,
}
,
}
Images_ListByDevCenter (updated)
Description :  Lists images for a devcenter.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Images_ListByDevCenter",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of Image items",
        "old": "Results of the image list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The Image items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "hibernateSupport",
                  "Enum": {
                    "new": [
                      [
                        "Disabled",
                        "Hibernate is disabled."
                      ],
                      [
                        "Enabled",
                        "Hibernate is enabled."
                      ]
                    ],
                    "old": [
                      [
                        "Disabled",
                        ""
                      ],
                      [
                        "Enabled",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/images
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The Image items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Image properties. ,
Required: False ,
}
{
description:
{
Description: The description of the image. ,
Required: False ,
}
string ,
publisher:
{
Description: The publisher of the image. ,
Required: False ,
}
string ,
offer:
{
Description: The name of the image offer. ,
Required: False ,
}
string ,
sku:
{
Description: The SKU name for the image. ,
Required: False ,
}
string ,
recommendedMachineConfiguration:
{
Description: The recommended machine configuration to use with the image. ,
Required: False ,
}
{
memory:
{
Description: Recommended memory range. ,
Required: False ,
}
{
min:
{
Description: Minimum value. ,
Format: int32 ,
Required: False ,
}
integer ,
max:
{
Description: Maximum value. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
vCPUs:
{
Description: Recommended vCPU range. ,
Required: False ,
}
{
min:
{
Description: Minimum value. ,
Format: int32 ,
Required: False ,
}
integer ,
max:
{
Description: Maximum value. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
hibernateSupport:
{
Description: Indicates whether this image has hibernate enabled. Not all images are capable of supporting hibernation. To find out more see https://aka.ms/devbox/hibernate ,
Enum:
{
Disabled: Hibernate is disabled. ,
Enabled: Hibernate is enabled. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ProjectPolicies_ListByDevCenter (updated)
Description :  Lists all project policies in the dev center.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectPolicies_ListByDevCenter",
  "Description": {
    "new": "Lists all project policies in the dev center.",
    "old": "Lists all project policies in the dev center"
  },
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of ProjectPolicy items",
        "old": "Results of the project policy list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The ProjectPolicy items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/projectPolicies
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The ProjectPolicy items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Properties of an project policy. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ProjectPolicies_Get (updated)
Description :  Gets a specific project policy.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectPolicies_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/projectPolicies/{projectPolicyName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
projectPolicyName:
{
Description: The name of the project policy. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an project policy. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
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 ,
}
,
]
,
}
,
}
ProjectPolicies_CreateOrUpdate (updated)
Description :  Creates or updates an project policy.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectPolicies_CreateOrUpdate",
  "$parameters": {
    "body": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/projectPolicies/{projectPolicyName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
projectPolicyName:
{
Description: The name of the project policy. ,
Required: True ,
}
string ,
body:
{
Description: Represents an project policy. ,
Required: True ,
}
{
properties:
{
Description: Properties of an project policy. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an project policy. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
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: Represents an project policy resource. ,
}
{
properties:
{
Description: Properties of an project policy. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
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 ,
}
,
]
,
}
,
}
ProjectPolicies_Update (updated)
Description :  Partially updates an project policy.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectPolicies_Update",
  "$parameters": {
    "body": {
      "$properties": {
        "properties": [
          {
            "resourcePolicies": {
              "$properties": [
                {
                  "#name": "action",
                  "Enum": {
                    "new": [
                      [
                        "Allow",
                        "Allow action for the policy."
                      ],
                      [
                        "Deny",
                        "Deny action for the policy."
                      ]
                    ],
                    "old": [
                      [
                        "Allow",
                        ""
                      ],
                      [
                        "Deny",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "resourceType",
                  "Enum": {
                    "new": [
                      [
                        "Images",
                        "Images resource type."
                      ],
                      [
                        "AttachedNetworks",
                        "Attached networks resource type."
                      ],
                      [
                        "Skus",
                        "Skus resource type."
                      ]
                    ],
                    "old": [
                      [
                        "Images",
                        ""
                      ],
                      [
                        "AttachedNetworks",
                        ""
                      ],
                      [
                        "Skus",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/devcenters/{devCenterName}/projectPolicies/{projectPolicyName}
{
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 ,
devCenterName:
{
Description: The name of the devcenter. ,
Required: True ,
}
string ,
projectPolicyName:
{
Description: The name of the project policy. ,
Required: True ,
}
string ,
body:
{
Description: Updatable project policy properties. ,
Required: True ,
}
{
properties:
{
Description: Properties of an project policy to be updated. ,
Required: False ,
}
{
resourcePolicies:
{
Description: Resource policies that are a part of this project policy. ,
Required: False ,
}
[
{
resources:
{
Description: Resources that are included and shared as a part of a project policy. ,
Required: False ,
}
string ,
filter:
{
Description: Optional. When specified, this expression is used to filter the resources. ,
Required: False ,
}
string ,
action:
{
Description: Policy action to be taken on the resources. This is optional, and defaults to allow ,
Enum:
{
Allow: Allow action for the policy. ,
Deny: Deny action for the policy. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Optional. The resource type being restricted or allowed by a project policy. Used with a given action to restrict or allow access to a resource type. ,
Enum:
{
Images: Images resource type. ,
AttachedNetworks: Attached networks resource type. ,
Skus: Skus resource type. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
scopes:
{
Description: Resources that have access to the shared resources that are a part of this project policy. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an project policy. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
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 ,
}

⚐ 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 ,
}
,
]
,
}
,
}
Projects_ListByResourceGroup (updated)
Description :  Lists all projects in the resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Projects_ListByResourceGroup",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of Project items",
        "old": "Results of the project list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The Project items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": [
              {
                "properties": [
                  {
                    "#name": "provisioningState",
                    "Enum": {
                      "new": [
                        [
                          "NotSpecified",
                          "Not specified provisioning state."
                        ],
                        [
                          "Accepted",
                          "Accepted provisioning state."
                        ],
                        [
                          "Running",
                          "Running provisioning state."
                        ],
                        [
                          "Creating",
                          "Creating provisioning state."
                        ],
                        [
                          "Created",
                          "Created provisioning state."
                        ],
                        [
                          "Updating",
                          "Updating provisioning state."
                        ],
                        [
                          "Updated",
                          "Updated provisioning state."
                        ],
                        [
                          "Deleting",
                          "Deleting provisioning state."
                        ],
                        [
                          "Deleted",
                          "Deleted provisioning state."
                        ],
                        [
                          "Succeeded",
                          "Succeeded provisioning state."
                        ],
                        [
                          "Failed",
                          "Failed provisioning state."
                        ],
                        [
                          "Canceled",
                          "Canceled provisioning state."
                        ],
                        [
                          "MovingResources",
                          "Moving resources provisioning state."
                        ],
                        [
                          "TransientFailure",
                          "Transient failure provisioning state."
                        ],
                        [
                          "RolloutInProgress",
                          "Rollout in progress provisioning state."
                        ],
                        [
                          "StorageProvisioningFailed",
                          "Storage provisioning failed provisioning state."
                        ]
                      ],
                      "old": [
                        [
                          "NotSpecified",
                          ""
                        ],
                        [
                          "Accepted",
                          ""
                        ],
                        [
                          "Running",
                          ""
                        ],
                        [
                          "Creating",
                          ""
                        ],
                        [
                          "Created",
                          ""
                        ],
                        [
                          "Updating",
                          ""
                        ],
                        [
                          "Updated",
                          ""
                        ],
                        [
                          "Deleting",
                          ""
                        ],
                        [
                          "Deleted",
                          ""
                        ],
                        [
                          "Succeeded",
                          ""
                        ],
                        [
                          "Failed",
                          ""
                        ],
                        [
                          "Canceled",
                          ""
                        ],
                        [
                          "MovingResources",
                          ""
                        ],
                        [
                          "TransientFailure",
                          ""
                        ],
                        [
                          "RolloutInProgress",
                          ""
                        ],
                        [
                          "StorageProvisioningFailed",
                          ""
                        ]
                      ]
                    }
                  }
                ]
              },
              {
                "#name": "identity",
                "Description": {
                  "new": "Managed identity properties.",
                  "old": "Managed identity properties"
                }
              }
            ]
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects
{
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 ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The Project items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Properties of a project. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center resource this project is associated with. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
Projects_Get (updated)
Description :  Gets a specific project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Projects_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a project. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center resource this project is associated with. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ 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 ,
}
,
]
,
}
,
}
Projects_CreateOrUpdate (updated)
Description :  Creates or updates a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Projects_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": [
          {
            "properties": [
              {
                "#name": "provisioningState",
                "Enum": {
                  "new": [
                    [
                      "NotSpecified",
                      "Not specified provisioning state."
                    ],
                    [
                      "Accepted",
                      "Accepted provisioning state."
                    ],
                    [
                      "Running",
                      "Running provisioning state."
                    ],
                    [
                      "Creating",
                      "Creating provisioning state."
                    ],
                    [
                      "Created",
                      "Created provisioning state."
                    ],
                    [
                      "Updating",
                      "Updating provisioning state."
                    ],
                    [
                      "Updated",
                      "Updated provisioning state."
                    ],
                    [
                      "Deleting",
                      "Deleting provisioning state."
                    ],
                    [
                      "Deleted",
                      "Deleted provisioning state."
                    ],
                    [
                      "Succeeded",
                      "Succeeded provisioning state."
                    ],
                    [
                      "Failed",
                      "Failed provisioning state."
                    ],
                    [
                      "Canceled",
                      "Canceled provisioning state."
                    ],
                    [
                      "MovingResources",
                      "Moving resources provisioning state."
                    ],
                    [
                      "TransientFailure",
                      "Transient failure provisioning state."
                    ],
                    [
                      "RolloutInProgress",
                      "Rollout in progress provisioning state."
                    ],
                    [
                      "StorageProvisioningFailed",
                      "Storage provisioning failed provisioning state."
                    ]
                  ],
                  "old": [
                    [
                      "NotSpecified",
                      ""
                    ],
                    [
                      "Accepted",
                      ""
                    ],
                    [
                      "Running",
                      ""
                    ],
                    [
                      "Creating",
                      ""
                    ],
                    [
                      "Created",
                      ""
                    ],
                    [
                      "Updating",
                      ""
                    ],
                    [
                      "Updated",
                      ""
                    ],
                    [
                      "Deleting",
                      ""
                    ],
                    [
                      "Deleted",
                      ""
                    ],
                    [
                      "Succeeded",
                      ""
                    ],
                    [
                      "Failed",
                      ""
                    ],
                    [
                      "Canceled",
                      ""
                    ],
                    [
                      "MovingResources",
                      ""
                    ],
                    [
                      "TransientFailure",
                      ""
                    ],
                    [
                      "RolloutInProgress",
                      ""
                    ],
                    [
                      "StorageProvisioningFailed",
                      ""
                    ]
                  ]
                }
              }
            ]
          },
          {
            "#name": "identity",
            "Description": {
              "new": "Managed identity properties.",
              "old": "Managed identity properties"
            }
          }
        ]
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    },
    "201": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
body:
{
Description: Represents a project. ,
Required: True ,
}
{
properties:
{
Description: Properties of a project. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center resource this project is associated with. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a project. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center resource this project is associated with. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ 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: Represents a project resource. ,
}
{
properties:
{
Description: Properties of a project. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center resource this project is associated with. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ 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 ,
}
,
]
,
}
,
}
Projects_Update (updated)
Description :  Partially updates a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Projects_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": [
          {
            "@added_33234b3283384cc68a376cc00bc8164b": {
              "#name": "tags",
              "Description": "Resource tags.",
              "Required": false,
              "Type": "object"
            }
          },
          {
            "@added_288632c4e92248b3ab4a830d50c091f1": {
              "#name": "location",
              "Description": "The geo-location where the resource lives.",
              "Required": false,
              "Type": "string"
            }
          },
          {
            "properties": [
              {
                "#name": "devCenterId",
                "Description": {
                  "new": "Resource Id of an associated DevCenter.",
                  "old": "Resource Id of an associated DevCenter"
                }
              },
              {
                "catalogSettings": [
                  {
                    "catalogItemSyncTypes": {
                      "Enum": {
                        "new": [
                          [
                            "EnvironmentDefinition",
                            "Environment definition catalog item type."
                          ],
                          [
                            "ImageDefinition",
                            "Image definition catalog item type."
                          ]
                        ],
                        "old": [
                          [
                            "EnvironmentDefinition",
                            ""
                          ],
                          [
                            "ImageDefinition",
                            ""
                          ]
                        ]
                      }
                    }
                  }
                ]
              },
              {
                "customizationSettings": [
                  {
                    "identities": {
                      "$properties": [
                        {
                          "#name": "identityType",
                          "Description": {
                            "new": "Values can be systemAssignedIdentity or userAssignedIdentity.",
                            "old": "Values can be systemAssignedIdentity or userAssignedIdentity"
                          },
                          "Enum": {
                            "new": [
                              [
                                "systemAssignedIdentity",
                                "System assigned identity type."
                              ],
                              [
                                "userAssignedIdentity",
                                "User assigned identity type."
                              ]
                            ],
                            "old": [
                              [
                                "systemAssignedIdentity",
                                ""
                              ],
                              [
                                "userAssignedIdentity",
                                ""
                              ]
                            ]
                          }
                        }
                      ]
                    }
                  },
                  {
                    "#name": "userCustomizationsEnableStatus",
                    "Enum": {
                      "new": [
                        [
                          "Disabled",
                          "User customizations are disabled."
                        ],
                        [
                          "Enabled",
                          "User customizations are enabled."
                        ]
                      ],
                      "old": [
                        [
                          "Disabled",
                          ""
                        ],
                        [
                          "Enabled",
                          ""
                        ]
                      ]
                    }
                  }
                ]
              }
            ]
          },
          {
            "#name": "identity",
            "Description": {
              "new": "Managed identity properties.",
              "old": "Managed identity properties"
            }
          }
        ]
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        }
      ]
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
body:
{
Description: Updatable project properties. ,
Required: True ,
}
{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The geo-location where the resource lives. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of a project to be updated. ,
Required: False ,
}
{
devCenterId:
{
Description: Resource Id of an associated DevCenter. ,
Required: False ,
}
string ,
description:
{
Description: Description of the project. ,
Required: False ,
}
string ,
maxDevBoxesPerUser:
{
Description: When specified, limits the maximum number of Dev Boxes a single user can create across all pools in the project. This will have no effect on existing Dev Boxes when reduced. ,
Format: int32 ,
Required: False ,
}
integer ,
displayName:
{
Description: The display name of the project. ,
Required: False ,
}
string ,
catalogSettings:
{
Description: Settings to be used when associating a project with a catalog. ,
Required: False ,
}
{
catalogItemSyncTypes:
{
Description: Indicates catalog item types that can be synced. ,
Required: False ,
}
[
string ,
]
,
}
,
customizationSettings:
{
Description: Settings to be used for customizations. ,
Required: False ,
}
{
identities:
{
Description: The identities that can to be used in customization scenarios; e.g., to clone a repository. ,
Required: False ,
}
[
{
identityType:
{
Description: Values can be systemAssignedIdentity or userAssignedIdentity. ,
Enum:
{
systemAssignedIdentity: System assigned identity type. ,
userAssignedIdentity: User assigned identity type. ,
}
,
Required: False ,
}
enum ,
identityResourceId:
{
Description: Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutually exclusive with identityType systemAssignedIdentity. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
]
,
userCustomizationsEnableStatus:
{
Description: Indicates whether user customizations are enabled. ,
Enum:
{
Disabled: User customizations are disabled. ,
Enabled: User customizations are enabled. ,
}
,
Required: False ,
}
enum ,
}
,
devBoxAutoDeleteSettings:
{
Description: Dev Box Auto Delete settings. ,
Required: False ,
}
{
deleteMode:
{
Description: Indicates the delete mode for Dev Boxes within this project. ,
Enum:
{
Manual: Dev Boxes will not be deleted automatically, and user must manually delete. This is the default. ,
Auto: Dev Boxes will be deleted automatically according to configured settings. ,
}
,
Required: False ,
}
enum ,
inactiveThreshold:
{
Description: ISO8601 duration required for the dev box to not be inactive prior to it being scheduled for deletion. ISO8601 format PT[n]H[n]M[n]S. ,
Required: False ,
}
string ,
gracePeriod:
{
Description: ISO8601 duration required for the dev box to be marked for deletion prior to it being deleted. ISO8601 format PT[n]H[n]M[n]S. ,
Required: False ,
}
string ,
}
,
azureAiServicesSettings:
{
Description: Indicates whether Azure AI services are enabled for a project. ,
Required: False ,
}
{
azureAiServicesMode:
{
Description: The property indicates whether Azure AI services is enabled. ,
Enum:
{
Disabled: Azure AI services are disabled for this project. ,
AutoDeploy: Azure AI services are enabled for this project and necessary resources will be automatically setup. ,
}
,
Required: False ,
}
enum ,
}
,
serverlessGpuSessionsSettings:
{
Description: Settings to be used for serverless GPU. ,
Required: False ,
}
{
serverlessGpuSessionsMode:
{
Description: The property indicates whether serverless GPU access is enabled on the project. ,
Enum:
{
Disabled: Serverless GPU session access is disabled. ,
AutoDeploy: Serverless GPU session access is enabled and necessary resources will be automatically setup. ,
}
,
Required: False ,
}
enum ,
maxConcurrentSessionsPerProject:
{
Description: When specified, limits the maximum number of concurrent sessions across all pools in the project. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
workspaceStorageSettings:
{
Description: Settings to be used for workspace storage. ,
Required: False ,
}
{
workspaceStorageMode:
{
Description: Indicates whether workspace storage is enabled. ,
Enum:
{
Disabled: Workspace storage is disabled. ,
AutoDeploy: Workspace storage is enabled and necessary resources will be automatically setup. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a project. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
devCenterUri:
{
Description: The URI of the Dev Center resource this project is associated with. ,
Required: False ,
}
string ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
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 ,
}
,
]
,
}
,
}
Projects_Delete (updated)
Description :  Deletes a project resource.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Projects_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
ProjectAllowedEnvironmentTypes_List (updated)
Description :  Lists allowed environment types for a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectAllowedEnvironmentTypes_List",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of AllowedEnvironmentType items",
        "old": "Result of the allowed environment type list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The AllowedEnvironmentType items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/allowedEnvironmentTypes
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The AllowedEnvironmentType items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Properties of an allowed environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
displayName:
{
Description: The display name of the allowed environment type. ,
Required: False ,
}
string ,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ProjectAllowedEnvironmentTypes_Get (updated)
Description :  Gets an allowed environment type.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectAllowedEnvironmentTypes_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/allowedEnvironmentTypes/{environmentTypeName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
environmentTypeName:
{
Description: The name of the environment type. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an allowed environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
displayName:
{
Description: The display name of the allowed environment type. ,
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 ,
}
,
]
,
}
,
}
AttachedNetworks_ListByProject (updated)
Description :  Lists the attached NetworkConnections for a Project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AttachedNetworks_ListByProject",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of AttachedNetworkConnection items",
        "old": "Results of the Attached Networks list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The AttachedNetworkConnection items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "networkConnectionId",
                  "Required": {
                    "new": false,
                    "old": true
                  }
                },
                {
                  "#name": "healthCheckStatus",
                  "Description": {
                    "new": "Health check status values.",
                    "old": "Health check status values"
                  },
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown health check status."
                      ],
                      [
                        "Pending",
                        "Pending health check status."
                      ],
                      [
                        "Running",
                        "Running health check status."
                      ],
                      [
                        "Passed",
                        "Passed health check status."
                      ],
                      [
                        "Warning",
                        "Warning health check status."
                      ],
                      [
                        "Failed",
                        "Failed health check status."
                      ],
                      [
                        "Informational",
                        "Informational health check status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Passed",
                        ""
                      ],
                      [
                        "Warning",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Informational",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "domainJoinType",
                  "Enum": {
                    "new": [
                      [
                        "HybridAzureADJoin",
                        "Hybrid Azure AD Join type."
                      ],
                      [
                        "AzureADJoin",
                        "Azure AD Join type."
                      ],
                      [
                        "None",
                        "No Active Directory join type."
                      ]
                    ],
                    "old": [
                      [
                        "HybridAzureADJoin",
                        ""
                      ],
                      [
                        "AzureADJoin",
                        ""
                      ],
                      [
                        "None",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/attachednetworks
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The AttachedNetworkConnection items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Attached NetworkConnection properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
networkConnectionId:
{
Description: The resource ID of the NetworkConnection you want to attach. ,
Required: False ,
}
string ,
networkConnectionLocation:
{
Description: The geo-location where the NetworkConnection resource specified in 'networkConnectionResourceId' property lives. ,
Required: False ,
}
string ,
healthCheckStatus:
{
Description: Health check status values. ,
Enum:
{
Unknown: Unknown health check status. ,
Pending: Pending health check status. ,
Running: Running health check status. ,
Passed: Passed health check status. ,
Warning: Warning health check status. ,
Failed: Failed health check status. ,
Informational: Informational health check status. ,
}
,
Required: False ,
}
enum ,
domainJoinType:
{
Description: AAD Join type of the network. This is populated based on the referenced Network Connection. ,
Enum:
{
HybridAzureADJoin: Hybrid Azure AD Join type. ,
AzureADJoin: Azure AD Join type. ,
None: No Active Directory join type. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
AttachedNetworks_GetByProject (updated)
Description :  Gets an attached NetworkConnection.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AttachedNetworks_GetByProject",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "networkConnectionId",
            "Required": {
              "new": false,
              "old": true
            }
          },
          {
            "#name": "healthCheckStatus",
            "Description": {
              "new": "Health check status values.",
              "old": "Health check status values"
            },
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown health check status."
                ],
                [
                  "Pending",
                  "Pending health check status."
                ],
                [
                  "Running",
                  "Running health check status."
                ],
                [
                  "Passed",
                  "Passed health check status."
                ],
                [
                  "Warning",
                  "Warning health check status."
                ],
                [
                  "Failed",
                  "Failed health check status."
                ],
                [
                  "Informational",
                  "Informational health check status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Passed",
                  ""
                ],
                [
                  "Warning",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Informational",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "domainJoinType",
            "Enum": {
              "new": [
                [
                  "HybridAzureADJoin",
                  "Hybrid Azure AD Join type."
                ],
                [
                  "AzureADJoin",
                  "Azure AD Join type."
                ],
                [
                  "None",
                  "No Active Directory join type."
                ]
              ],
              "old": [
                [
                  "HybridAzureADJoin",
                  ""
                ],
                [
                  "AzureADJoin",
                  ""
                ],
                [
                  "None",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/attachednetworks/{attachedNetworkConnectionName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
attachedNetworkConnectionName:
{
Description: The name of the attached NetworkConnection. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Attached NetworkConnection properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
networkConnectionId:
{
Description: The resource ID of the NetworkConnection you want to attach. ,
Required: False ,
}
string ,
networkConnectionLocation:
{
Description: The geo-location where the NetworkConnection resource specified in 'networkConnectionResourceId' property lives. ,
Required: False ,
}
string ,
healthCheckStatus:
{
Description: Health check status values. ,
Enum:
{
Unknown: Unknown health check status. ,
Pending: Pending health check status. ,
Running: Running health check status. ,
Passed: Passed health check status. ,
Warning: Warning health check status. ,
Failed: Failed health check status. ,
Informational: Informational health check status. ,
}
,
Required: False ,
}
enum ,
domainJoinType:
{
Description: AAD Join type of the network. This is populated based on the referenced Network Connection. ,
Enum:
{
HybridAzureADJoin: Hybrid Azure AD Join type. ,
AzureADJoin: Azure AD Join type. ,
None: No Active Directory join type. ,
}
,
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 ,
}
,
]
,
}
,
}
ProjectCatalogs_List (updated)
Description :  Lists the catalogs associated with a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogs_List",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of Catalog items",
        "old": "Results of the catalog list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The Catalog items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "syncState",
                  "Enum": {
                    "new": [
                      [
                        "Succeeded",
                        "Succeeded synchronization state."
                      ],
                      [
                        "InProgress",
                        "In progress synchronization state."
                      ],
                      [
                        "Failed",
                        "Failed synchronization state."
                      ],
                      [
                        "Canceled",
                        "Canceled synchronization state."
                      ]
                    ],
                    "old": [
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "InProgress",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "lastSyncStats": [
                    {
                      "syncedCatalogItemTypes": {
                        "Enum": {
                          "new": [
                            [
                              "EnvironmentDefinition",
                              "Environment definition catalog item type."
                            ],
                            [
                              "ImageDefinition",
                              "Image definition catalog item type."
                            ]
                          ],
                          "old": [
                            [
                              "EnvironmentDefinition",
                              ""
                            ],
                            [
                              "ImageDefinition",
                              ""
                            ]
                          ]
                        }
                      }
                    }
                  ]
                },
                {
                  "#name": "connectionState",
                  "Enum": {
                    "new": [
                      [
                        "Connected",
                        "Connected state."
                      ],
                      [
                        "Disconnected",
                        "Disconnected state."
                      ]
                    ],
                    "old": [
                      [
                        "Connected",
                        ""
                      ],
                      [
                        "Disconnected",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The Catalog items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ProjectCatalogs_Get (updated)
Description :  Gets an associated project catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogs_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "syncState",
            "Enum": {
              "new": [
                [
                  "Succeeded",
                  "Succeeded synchronization state."
                ],
                [
                  "InProgress",
                  "In progress synchronization state."
                ],
                [
                  "Failed",
                  "Failed synchronization state."
                ],
                [
                  "Canceled",
                  "Canceled synchronization state."
                ]
              ],
              "old": [
                [
                  "Succeeded",
                  ""
                ],
                [
                  "InProgress",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ]
              ]
            }
          },
          {
            "lastSyncStats": [
              {
                "syncedCatalogItemTypes": {
                  "Enum": {
                    "new": [
                      [
                        "EnvironmentDefinition",
                        "Environment definition catalog item type."
                      ],
                      [
                        "ImageDefinition",
                        "Image definition catalog item type."
                      ]
                    ],
                    "old": [
                      [
                        "EnvironmentDefinition",
                        ""
                      ],
                      [
                        "ImageDefinition",
                        ""
                      ]
                    ]
                  }
                }
              }
            ]
          },
          {
            "#name": "connectionState",
            "Enum": {
              "new": [
                [
                  "Connected",
                  "Connected state."
                ],
                [
                  "Disconnected",
                  "Disconnected state."
                ]
              ],
              "old": [
                [
                  "Connected",
                  ""
                ],
                [
                  "Disconnected",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
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 ,
}
,
]
,
}
,
}
ProjectCatalogs_CreateOrUpdate (updated)
Description :  Creates or updates a project catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogs_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            },
            {
              "#name": "syncState",
              "Enum": {
                "new": [
                  [
                    "Succeeded",
                    "Succeeded synchronization state."
                  ],
                  [
                    "InProgress",
                    "In progress synchronization state."
                  ],
                  [
                    "Failed",
                    "Failed synchronization state."
                  ],
                  [
                    "Canceled",
                    "Canceled synchronization state."
                  ]
                ],
                "old": [
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "InProgress",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ]
                ]
              }
            },
            {
              "lastSyncStats": [
                {
                  "syncedCatalogItemTypes": {
                    "Enum": {
                      "new": [
                        [
                          "EnvironmentDefinition",
                          "Environment definition catalog item type."
                        ],
                        [
                          "ImageDefinition",
                          "Image definition catalog item type."
                        ]
                      ],
                      "old": [
                        [
                          "EnvironmentDefinition",
                          ""
                        ],
                        [
                          "ImageDefinition",
                          ""
                        ]
                      ]
                    }
                  }
                }
              ]
            },
            {
              "#name": "connectionState",
              "Enum": {
                "new": [
                  [
                    "Connected",
                    "Connected state."
                  ],
                  [
                    "Disconnected",
                    "Disconnected state."
                  ]
                ],
                "old": [
                  [
                    "Connected",
                    ""
                  ],
                  [
                    "Disconnected",
                    ""
                  ]
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "syncState",
            "Enum": {
              "new": [
                [
                  "Succeeded",
                  "Succeeded synchronization state."
                ],
                [
                  "InProgress",
                  "In progress synchronization state."
                ],
                [
                  "Failed",
                  "Failed synchronization state."
                ],
                [
                  "Canceled",
                  "Canceled synchronization state."
                ]
              ],
              "old": [
                [
                  "Succeeded",
                  ""
                ],
                [
                  "InProgress",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ]
              ]
            }
          },
          {
            "lastSyncStats": [
              {
                "syncedCatalogItemTypes": {
                  "Enum": {
                    "new": [
                      [
                        "EnvironmentDefinition",
                        "Environment definition catalog item type."
                      ],
                      [
                        "ImageDefinition",
                        "Image definition catalog item type."
                      ]
                    ],
                    "old": [
                      [
                        "EnvironmentDefinition",
                        ""
                      ],
                      [
                        "ImageDefinition",
                        ""
                      ]
                    ]
                  }
                }
              }
            ]
          },
          {
            "#name": "connectionState",
            "Enum": {
              "new": [
                [
                  "Connected",
                  "Connected state."
                ],
                [
                  "Disconnected",
                  "Disconnected state."
                ]
              ],
              "old": [
                [
                  "Connected",
                  ""
                ],
                [
                  "Disconnected",
                  ""
                ]
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "syncState",
            "Enum": {
              "new": [
                [
                  "Succeeded",
                  "Succeeded synchronization state."
                ],
                [
                  "InProgress",
                  "In progress synchronization state."
                ],
                [
                  "Failed",
                  "Failed synchronization state."
                ],
                [
                  "Canceled",
                  "Canceled synchronization state."
                ]
              ],
              "old": [
                [
                  "Succeeded",
                  ""
                ],
                [
                  "InProgress",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ]
              ]
            }
          },
          {
            "lastSyncStats": [
              {
                "syncedCatalogItemTypes": {
                  "Enum": {
                    "new": [
                      [
                        "EnvironmentDefinition",
                        "Environment definition catalog item type."
                      ],
                      [
                        "ImageDefinition",
                        "Image definition catalog item type."
                      ]
                    ],
                    "old": [
                      [
                        "EnvironmentDefinition",
                        ""
                      ],
                      [
                        "ImageDefinition",
                        ""
                      ]
                    ]
                  }
                }
              }
            ]
          },
          {
            "#name": "connectionState",
            "Enum": {
              "new": [
                [
                  "Connected",
                  "Connected state."
                ],
                [
                  "Disconnected",
                  "Disconnected state."
                ]
              ],
              "old": [
                [
                  "Connected",
                  ""
                ],
                [
                  "Disconnected",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
body:
{
Description: Represents a catalog. ,
Required: True ,
}
{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ 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: Represents a catalog. ,
}
{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
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 ,
}
,
]
,
}
,
}
ProjectCatalogs_Patch (updated)
Description :  Partially updates a project catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogs_Patch",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": {
          "properties": [
            {
              "#name": "syncType",
              "Enum": {
                "new": [
                  [
                    "Manual",
                    "Manual sync type."
                  ],
                  [
                    "Scheduled",
                    "Scheduled sync type."
                  ]
                ],
                "old": [
                  [
                    "Manual",
                    ""
                  ],
                  [
                    "Scheduled",
                    ""
                  ]
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "syncState",
            "Enum": {
              "new": [
                [
                  "Succeeded",
                  "Succeeded synchronization state."
                ],
                [
                  "InProgress",
                  "In progress synchronization state."
                ],
                [
                  "Failed",
                  "Failed synchronization state."
                ],
                [
                  "Canceled",
                  "Canceled synchronization state."
                ]
              ],
              "old": [
                [
                  "Succeeded",
                  ""
                ],
                [
                  "InProgress",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ]
              ]
            }
          },
          {
            "lastSyncStats": [
              {
                "syncedCatalogItemTypes": {
                  "Enum": {
                    "new": [
                      [
                        "EnvironmentDefinition",
                        "Environment definition catalog item type."
                      ],
                      [
                        "ImageDefinition",
                        "Image definition catalog item type."
                      ]
                    ],
                    "old": [
                      [
                        "EnvironmentDefinition",
                        ""
                      ],
                      [
                        "ImageDefinition",
                        ""
                      ]
                    ]
                  }
                }
              }
            ]
          },
          {
            "#name": "connectionState",
            "Enum": {
              "new": [
                [
                  "Connected",
                  "Connected state."
                ],
                [
                  "Disconnected",
                  "Disconnected state."
                ]
              ],
              "old": [
                [
                  "Connected",
                  ""
                ],
                [
                  "Disconnected",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
body:
{
Description: Updatable project catalog properties. ,
Required: True ,
}
{
properties:
{
Description: Catalog properties for update. ,
Required: False ,
}
{
gitHub:
{
Description: Properties for a GitHub catalog type. ,
Required: False ,
}
{
uri:
{
Description: Git URI. ,
Required: False ,
}
string ,
branch:
{
Description: Git branch. ,
Required: False ,
}
string ,
secretIdentifier:
{
Description: A reference to the Key Vault secret containing a security token to authenticate to a Git repository. ,
Required: False ,
}
string ,
path:
{
Description: The folder where the catalog items can be found inside the repository. ,
Required: False ,
}
string ,
}
,
adoGit:
{
Description: Properties for an Azure DevOps catalog type. ,
Required: False ,
}
{
uri:
{
Description: Git URI. ,
Required: False ,
}
string ,
branch:
{
Description: Git branch. ,
Required: False ,
}
string ,
secretIdentifier:
{
Description: A reference to the Key Vault secret containing a security token to authenticate to a Git repository. ,
Required: False ,
}
string ,
path:
{
Description: The folder where the catalog items can be found inside the repository. ,
Required: False ,
}
string ,
}
,
syncType:
{
Description: Indicates the type of sync that is configured for the catalog. ,
Enum:
{
Manual: Manual sync type. ,
Scheduled: Scheduled sync type. ,
}
,
Required: False ,
}
enum ,
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Catalog properties. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
syncState:
{
Description: The synchronization state of the catalog. ,
Enum:
{
Succeeded: Succeeded synchronization state. ,
InProgress: In progress synchronization state. ,
Failed: Failed synchronization state. ,
Canceled: Canceled synchronization state. ,
}
,
Required: False ,
}
enum ,
lastSyncStats:
{
Description: Stats of the latest synchronization. ,
Required: False ,
}
{
added:
{
Description: Count of catalog items added during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
updated:
{
Description: Count of catalog items updated during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
unchanged:
{
Description: Count of catalog items that were unchanged during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
removed:
{
Description: Count of catalog items removed during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
validationErrors:
{
Description: Count of catalog items that had validation errors during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
synchronizationErrors:
{
Description: Count of synchronization errors that occured during synchronization. ,
Format: int32 ,
Required: False ,
}
integer ,
syncedCatalogItemTypes:
{
Description: Indicates catalog item types that were synced. ,
Required: False ,
}
[
string ,
]
,
}
,
connectionState:
{
Description: The connection state of the catalog. ,
Enum:
{
Connected: Connected state. ,
Disconnected: Disconnected state. ,
}
,
Required: False ,
}
enum ,
lastConnectionTime:
{
Description: When the catalog was last connected. ,
Format: date-time ,
Required: False ,
}
string ,
lastSyncTime:
{
Description: When the catalog was last synced. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
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 ,
}
,
]
,
}
,
}
ProjectCatalogs_Delete (updated)
Description :  Deletes a project catalog resource.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogs_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
ProjectCatalogs_Connect (updated)
Description :  Connects a project catalog to enable syncing.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogs_Connect",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}/connect
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
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 ,
}
,
]
,
}
,
}
EnvironmentDefinitions_ListByProjectCatalog (updated)
Description :  Lists the environment definitions in this project catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EnvironmentDefinitions_ListByProjectCatalog",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of EnvironmentDefinition items",
        "old": "Results of the environment definition list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The EnvironmentDefinition items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "parameters": {
                    "Description": {
                      "new": "Properties of an Environment Definition parameter.",
                      "old": "Properties of an Environment Definition parameter"
                    },
                    "$properties": [
                      {
                        "#name": "id",
                        "Description": {
                          "new": "Unique ID of the parameter.",
                          "old": "Unique ID of the parameter"
                        }
                      },
                      {
                        "#name": "name",
                        "Description": {
                          "new": "Display name of the parameter.",
                          "old": "Display name of the parameter"
                        }
                      },
                      {
                        "#name": "description",
                        "Description": {
                          "new": "Description of the parameter.",
                          "old": "Description of the parameter"
                        }
                      },
                      {
                        "#name": "type",
                        "Description": {
                          "new": "A string of one of the basic JSON types (number, integer, array, object, boolean, string).",
                          "old": "A string of one of the basic JSON types (number, integer, array, object, boolean, string)"
                        }
                      },
                      {
                        "#name": "required",
                        "Description": {
                          "new": "Whether or not this parameter is required.",
                          "old": "Whether or not this parameter is required"
                        }
                      }
                    ]
                  }
                },
                {
                  "#name": "validationStatus",
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown validation status."
                      ],
                      [
                        "Pending",
                        "Pending validation status."
                      ],
                      [
                        "Succeeded",
                        "Succeeded validation status."
                      ],
                      [
                        "Failed",
                        "Failed validation status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}/environmentDefinitions
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The EnvironmentDefinition items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Environment definition properties. ,
Required: False ,
}
{
description:
{
Description: A short description of the environment definition. ,
Required: False ,
}
string ,
parameters:
{
Description: Input parameters passed to an environment. ,
Required: False ,
}
[
{
id:
{
Description: Unique ID of the parameter. ,
Required: False ,
}
string ,
name:
{
Description: Display name of the parameter. ,
Required: False ,
}
string ,
description:
{
Description: Description of the parameter. ,
Required: False ,
}
string ,
type:
{
Description: A string of one of the basic JSON types (number, integer, array, object, boolean, string). ,
Enum:
{
array: The parameter accepts an array of values. ,
boolean: The parameter accepts a boolean value. ,
integer: The parameter accepts an integer value. ,
number: The parameter accepts a number value. ,
object: The parameter accepts an object value. ,
string: The parameter accepts a string value. ,
}
,
Required: False ,
}
enum ,
readOnly:
{
Description: Whether or not this parameter is read-only. If true, default should have a value. ,
Required: False ,
}
boolean ,
required:
{
Description: Whether or not this parameter is required. ,
Required: False ,
}
boolean ,
}
,
]
,
templatePath:
{
Description: Path to the Environment Definition entrypoint file. ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status for the environment definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
EnvironmentDefinitions_GetByProjectCatalog (updated)
Description :  Gets an environment definition from the catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EnvironmentDefinitions_GetByProjectCatalog",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "parameters": {
              "Description": {
                "new": "Properties of an Environment Definition parameter.",
                "old": "Properties of an Environment Definition parameter"
              },
              "$properties": [
                {
                  "#name": "id",
                  "Description": {
                    "new": "Unique ID of the parameter.",
                    "old": "Unique ID of the parameter"
                  }
                },
                {
                  "#name": "name",
                  "Description": {
                    "new": "Display name of the parameter.",
                    "old": "Display name of the parameter"
                  }
                },
                {
                  "#name": "description",
                  "Description": {
                    "new": "Description of the parameter.",
                    "old": "Description of the parameter"
                  }
                },
                {
                  "#name": "type",
                  "Description": {
                    "new": "A string of one of the basic JSON types (number, integer, array, object, boolean, string).",
                    "old": "A string of one of the basic JSON types (number, integer, array, object, boolean, string)"
                  }
                },
                {
                  "#name": "required",
                  "Description": {
                    "new": "Whether or not this parameter is required.",
                    "old": "Whether or not this parameter is required"
                  }
                }
              ]
            }
          },
          {
            "#name": "validationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown validation status."
                ],
                [
                  "Pending",
                  "Pending validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded validation status."
                ],
                [
                  "Failed",
                  "Failed validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}/environmentDefinitions/{environmentDefinitionName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
environmentDefinitionName:
{
Description: The name of the Environment Definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Environment definition properties. ,
Required: False ,
}
{
description:
{
Description: A short description of the environment definition. ,
Required: False ,
}
string ,
parameters:
{
Description: Input parameters passed to an environment. ,
Required: False ,
}
[
{
id:
{
Description: Unique ID of the parameter. ,
Required: False ,
}
string ,
name:
{
Description: Display name of the parameter. ,
Required: False ,
}
string ,
description:
{
Description: Description of the parameter. ,
Required: False ,
}
string ,
type:
{
Description: A string of one of the basic JSON types (number, integer, array, object, boolean, string). ,
Enum:
{
array: The parameter accepts an array of values. ,
boolean: The parameter accepts a boolean value. ,
integer: The parameter accepts an integer value. ,
number: The parameter accepts a number value. ,
object: The parameter accepts an object value. ,
string: The parameter accepts a string value. ,
}
,
Required: False ,
}
enum ,
readOnly:
{
Description: Whether or not this parameter is read-only. If true, default should have a value. ,
Required: False ,
}
boolean ,
required:
{
Description: Whether or not this parameter is required. ,
Required: False ,
}
boolean ,
}
,
]
,
templatePath:
{
Description: Path to the Environment Definition entrypoint file. ,
Required: False ,
}
string ,
validationStatus:
{
Description: Validation status for the environment definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
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 ,
}
,
]
,
}
,
}
ProjectCatalogEnvironmentDefinitions_GetErrorDetails (updated)
Description :  Gets Environment Definition error details.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogEnvironmentDefinitions_GetErrorDetails",
  "Description": {
    "new": "Gets Environment Definition error details.",
    "old": "Gets Environment Definition error details"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}/environmentDefinitions/{environmentDefinitionName}/getErrorDetails
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
environmentDefinitionName:
{
Description: The name of the Environment Definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
errors:
{
Description: Errors associated with resources synchronized from the catalog. ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
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 ,
}
,
]
,
}
,
}
ProjectCatalogs_GetSyncErrorDetails (updated)
Description :  Gets project catalog synchronization error details
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogs_GetSyncErrorDetails",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}/getSyncErrorDetails
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
operationError:
{
Description: Error information for the overall synchronization operation. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
conflicts:
{
Description: Catalog items that have conflicting names. ,
Required: False ,
}
[
{
path:
{
Description: The path of the file that has a conflicting name. ,
Required: False ,
}
string ,
name:
{
Description: Name of the conflicting catalog item. ,
Required: False ,
}
string ,
}
,
]
,
errors:
{
Description: Errors that occured during synchronization. ,
Required: False ,
}
[
{
path:
{
Description: The path of the file the error is associated with. ,
Required: False ,
}
string ,
errorDetails:
{
Description: Errors associated with the file. ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
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 ,
}
,
]
,
}
,
}
ProjectCatalogImageDefinitions_ListByProjectCatalog (updated)
Description :  List Image Definitions in the catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogImageDefinitions_ListByProjectCatalog",
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of ImageDefinition items",
        "old": "Results of the Image Definition list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The ImageDefinition items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "imageValidationStatus",
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown image validation status."
                      ],
                      [
                        "Pending",
                        "Pending image validation status."
                      ],
                      [
                        "Succeeded",
                        "Succeeded image validation status."
                      ],
                      [
                        "Failed",
                        "Failed image validation status."
                      ],
                      [
                        "TimedOut",
                        "Timed out image validation status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "TimedOut",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "validationStatus",
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown validation status."
                      ],
                      [
                        "Pending",
                        "Pending validation status."
                      ],
                      [
                        "Succeeded",
                        "Succeeded validation status."
                      ],
                      [
                        "Failed",
                        "Failed validation status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "autoImageBuild",
                  "Enum": {
                    "new": [
                      [
                        "Disabled",
                        "Auto image build is disabled."
                      ],
                      [
                        "Enabled",
                        "Auto image build is enabled."
                      ]
                    ],
                    "old": [
                      [
                        "Disabled",
                        ""
                      ],
                      [
                        "Enabled",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}/imageDefinitions
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The ImageDefinition items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Image Definition properties ,
Required: False ,
}
{
imageReference:
{
Description: Image reference information. ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
fileUrl:
{
Description: The URL to the repository file containing the image definition. ,
Required: False ,
}
string ,
latestBuild:
{
Description: Details about the latest build. ,
Required: False ,
}
{
name:
{
Description: Identifier of a build. ,
Required: False ,
}
string ,
startTime:
{
Description: Start time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
status:
{
Description: The state of an Image Definition Build. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
}
,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Image Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
autoImageBuild:
{
Description: Indicates if automatic image builds will be triggered for image definition updates ,
Enum:
{
Disabled: Auto image build is disabled. ,
Enabled: Auto image build is enabled. ,
}
,
Required: False ,
}
enum ,
tasks:
{
Description: Tasks to run at Dev Box provisioning time. ,
Required: False ,
}
[
{
name:
{
Description: Name of the task. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the task. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
displayName:
{
Description: Display name to help differentiate multiple instances of the same task. ,
Required: False ,
}
string ,
timeoutInSeconds:
{
Description: Timeout, in seconds. Overrides any timeout provided on the task definition. ,
Format: int32 ,
Required: False ,
}
integer ,
condition:
{
Description: An expression that must evaluate to true in order for the task to run. ,
Required: False ,
}
string ,
}
,
]
,
userTasks:
{
Description: Tasks to run when a user first logs into a Dev Box. ,
Required: False ,
}
[
{
name:
{
Description: Name of the task. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the task. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
displayName:
{
Description: Display name to help differentiate multiple instances of the same task. ,
Required: False ,
}
string ,
timeoutInSeconds:
{
Description: Timeout, in seconds. Overrides any timeout provided on the task definition. ,
Format: int32 ,
Required: False ,
}
integer ,
condition:
{
Description: An expression that must evaluate to true in order for the task to run. ,
Required: False ,
}
string ,
}
,
]
,
extends:
{
Description: Another Image Definition that this one extends. ,
Required: False ,
}
{
imageDefinition:
{
Description: Name of the referenced Image Definition. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the referenced Image Definition. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
}
,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ProjectCatalogImageDefinitions_GetByProjectCatalog (updated)
Description :  Gets an Image Definition from the catalog.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogImageDefinitions_GetByProjectCatalog",
  "Description": {
    "new": "Gets an Image Definition from the catalog.",
    "old": "Gets an Image Definition from the catalog"
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "imageValidationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown image validation status."
                ],
                [
                  "Pending",
                  "Pending image validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded image validation status."
                ],
                [
                  "Failed",
                  "Failed image validation status."
                ],
                [
                  "TimedOut",
                  "Timed out image validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "TimedOut",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "validationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown validation status."
                ],
                [
                  "Pending",
                  "Pending validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded validation status."
                ],
                [
                  "Failed",
                  "Failed validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "autoImageBuild",
            "Enum": {
              "new": [
                [
                  "Disabled",
                  "Auto image build is disabled."
                ],
                [
                  "Enabled",
                  "Auto image build is enabled."
                ]
              ],
              "old": [
                [
                  "Disabled",
                  ""
                ],
                [
                  "Enabled",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}/imageDefinitions/{imageDefinitionName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
imageDefinitionName:
{
Description: The name of the Image Definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Image Definition properties ,
Required: False ,
}
{
imageReference:
{
Description: Image reference information. ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
fileUrl:
{
Description: The URL to the repository file containing the image definition. ,
Required: False ,
}
string ,
latestBuild:
{
Description: Details about the latest build. ,
Required: False ,
}
{
name:
{
Description: Identifier of a build. ,
Required: False ,
}
string ,
startTime:
{
Description: Start time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
status:
{
Description: The state of an Image Definition Build. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
}
,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Image Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
autoImageBuild:
{
Description: Indicates if automatic image builds will be triggered for image definition updates ,
Enum:
{
Disabled: Auto image build is disabled. ,
Enabled: Auto image build is enabled. ,
}
,
Required: False ,
}
enum ,
tasks:
{
Description: Tasks to run at Dev Box provisioning time. ,
Required: False ,
}
[
{
name:
{
Description: Name of the task. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the task. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
displayName:
{
Description: Display name to help differentiate multiple instances of the same task. ,
Required: False ,
}
string ,
timeoutInSeconds:
{
Description: Timeout, in seconds. Overrides any timeout provided on the task definition. ,
Format: int32 ,
Required: False ,
}
integer ,
condition:
{
Description: An expression that must evaluate to true in order for the task to run. ,
Required: False ,
}
string ,
}
,
]
,
userTasks:
{
Description: Tasks to run when a user first logs into a Dev Box. ,
Required: False ,
}
[
{
name:
{
Description: Name of the task. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the task. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
displayName:
{
Description: Display name to help differentiate multiple instances of the same task. ,
Required: False ,
}
string ,
timeoutInSeconds:
{
Description: Timeout, in seconds. Overrides any timeout provided on the task definition. ,
Format: int32 ,
Required: False ,
}
integer ,
condition:
{
Description: An expression that must evaluate to true in order for the task to run. ,
Required: False ,
}
string ,
}
,
]
,
extends:
{
Description: Another Image Definition that this one extends. ,
Required: False ,
}
{
imageDefinition:
{
Description: Name of the referenced Image Definition. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters for the referenced Image Definition. ,
Required: False ,
}
[
{
name:
{
Description: Name of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: value of the parameter. ,
Required: True ,
}
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 ,
}
,
]
,
}
,
}
ProjectCatalogImageDefinitionBuilds_ListByImageDefinition (updated)
Description :  Lists builds for a specified image definition.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogImageDefinitionBuilds_ListByImageDefinition",
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of ImageDefinitionBuild items",
        "old": "Results of the Image Definition Build list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The ImageDefinitionBuild items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}/imageDefinitions/{imageDefinitionName}/builds
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
imageDefinitionName:
{
Description: The name of the Image Definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The ImageDefinitionBuild items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Image Definition Build properties ,
Required: False ,
}
{
imageReference:
{
Description: The specific image version used by the build. ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
status:
{
Description: The status of the build. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
errorDetails:
{
Description: Details for image creation error. Populated when the image creation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ProjectCatalogImageDefinitionBuild_GetBuildDetails (updated)
Description :  Gets Build details.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogImageDefinitionBuild_GetBuildDetails",
  "Description": {
    "new": "Gets Build details.",
    "old": "Gets Build details"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}/imageDefinitions/{imageDefinitionName}/builds/{buildName}/getBuildDetails
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
imageDefinitionName:
{
Description: The name of the Image Definition. ,
Required: True ,
}
string ,
buildName:
{
Description: The ID of the Image Definition Build. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
imageReference:
{
Description: The specific image version used by the build. ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
status:
{
Description: The status of the build. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
errorDetails:
{
Description: Details for image creation error. Populated when the image creation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
taskGroups:
{
Description: The list of task groups executed during the image definition build. ,
Required: False ,
}
[
{
name:
{
Description: The name of the task group. ,
Required: False ,
}
string ,
status:
{
Description: The status of the task group. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task group. ,
Format: date-time ,
Required: False ,
}
string ,
tasks:
{
Description: The list of tasks executed during the task group. ,
Required: False ,
}
[
{
name:
{
Description: The name of the task. ,
Required: False ,
}
string ,
parameters:
{
Description: Parameters for the task. ,
Required: False ,
}
[
{
key:
{
Description: Key of the parameter. ,
Required: True ,
}
string ,
value:
{
Description: Value of the parameter. ,
Required: True ,
}
string ,
}
,
]
,
displayName:
{
Description: Display name to help differentiate multiple instances of the same task. ,
Required: False ,
}
string ,
id:
{
Description: ID of the task instance. ,
Required: False ,
}
string ,
startTime:
{
Description: Start time of the task. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End time of the task. ,
Format: date-time ,
Required: False ,
}
string ,
status:
{
Description: The status of the task. ,
Enum:
{
Succeeded: The image build has succeeded. ,
Running: The image build is running. ,
ValidationFailed: The built image has failed validation. ,
Failed: The image build has failed. ,
Cancelled: The image build has been cancelled. ,
TimedOut: The image build has timed out. ,
}
,
Required: False ,
}
enum ,
logUri:
{
Description: The URI for retrieving logs for the task execution. ,
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 ,
}
,
]
,
}
,
}
ProjectCatalogImageDefinitions_GetErrorDetails (updated)
Description :  Gets Image Definition error details.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogImageDefinitions_GetErrorDetails",
  "Description": {
    "new": "Gets Image Definition error details.",
    "old": "Gets Image Definition error details"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}/imageDefinitions/{imageDefinitionName}/getErrorDetails
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
imageDefinitionName:
{
Description: The name of the Image Definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
errors:
{
Description: Errors associated with resources synchronized from the catalog. ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
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 ,
}
,
]
,
}
,
}
ProjectCatalogs_Sync (updated)
Description :  Syncs templates for a template source.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectCatalogs_Sync",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/catalogs/{catalogName}/sync
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
catalogName:
{
Description: The name of the Catalog. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
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 ,
}
,
]
,
}
,
}
DevBoxDefinitions_ListByProject (updated)
Description :  List Dev Box definitions configured for a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevBoxDefinitions_ListByProject",
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of DevBoxDefinition items",
        "old": "Results of the Dev Box definition list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The DevBoxDefinition items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "imageValidationStatus",
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown image validation status."
                      ],
                      [
                        "Pending",
                        "Pending image validation status."
                      ],
                      [
                        "Succeeded",
                        "Succeeded image validation status."
                      ],
                      [
                        "Failed",
                        "Failed image validation status."
                      ],
                      [
                        "TimedOut",
                        "Timed out image validation status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "TimedOut",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "validationStatus",
                  "Enum": {
                    "new": [
                      [
                        "Unknown",
                        "Unknown validation status."
                      ],
                      [
                        "Pending",
                        "Pending validation status."
                      ],
                      [
                        "Succeeded",
                        "Succeeded validation status."
                      ],
                      [
                        "Failed",
                        "Failed validation status."
                      ]
                    ],
                    "old": [
                      [
                        "Unknown",
                        ""
                      ],
                      [
                        "Pending",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/devboxdefinitions
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The DevBoxDefinition items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Dev Box definition properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Dev Box Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
DevBoxDefinitions_GetByProject (updated)
Description :  Gets a Dev Box definition configured for a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DevBoxDefinitions_GetByProject",
  "Description": {
    "new": "Gets a Dev Box definition configured for a project.",
    "old": "Gets a Dev Box definition configured for a project"
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "imageValidationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown image validation status."
                ],
                [
                  "Pending",
                  "Pending image validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded image validation status."
                ],
                [
                  "Failed",
                  "Failed image validation status."
                ],
                [
                  "TimedOut",
                  "Timed out image validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "TimedOut",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "validationStatus",
            "Enum": {
              "new": [
                [
                  "Unknown",
                  "Unknown validation status."
                ],
                [
                  "Pending",
                  "Pending validation status."
                ],
                [
                  "Succeeded",
                  "Succeeded validation status."
                ],
                [
                  "Failed",
                  "Failed validation status."
                ]
              ],
              "old": [
                [
                  "Unknown",
                  ""
                ],
                [
                  "Pending",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/devboxdefinitions/{devBoxDefinitionName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
devBoxDefinitionName:
{
Description: The name of the Dev Box definition. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Dev Box definition properties ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
imageValidationStatus:
{
Description: Validation status of the configured image. ,
Enum:
{
Unknown: Unknown image validation status. ,
Pending: Pending image validation status. ,
Succeeded: Succeeded image validation status. ,
Failed: Failed image validation status. ,
TimedOut: Timed out image validation status. ,
}
,
Required: False ,
}
enum ,
imageValidationErrorDetails:
{
Description: Details for image validator error. Populated when the image validation is not successful. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error. ,
Required: False ,
}
string ,
}
,
validationStatus:
{
Description: Validation status for the Dev Box Definition. ,
Enum:
{
Unknown: Unknown validation status. ,
Pending: Pending validation status. ,
Succeeded: Succeeded validation status. ,
Failed: Failed validation status. ,
}
,
Required: False ,
}
enum ,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
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 ,
}
,
]
,
}
,
}
ProjectEnvironmentTypes_List (updated)
Description :  Lists environment types for a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectEnvironmentTypes_List",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of ProjectEnvironmentType items",
        "old": "Result of the project environment type list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The ProjectEnvironmentType items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": [
              {
                "properties": [
                  {
                    "#name": "provisioningState",
                    "Enum": {
                      "new": [
                        [
                          "NotSpecified",
                          "Not specified provisioning state."
                        ],
                        [
                          "Accepted",
                          "Accepted provisioning state."
                        ],
                        [
                          "Running",
                          "Running provisioning state."
                        ],
                        [
                          "Creating",
                          "Creating provisioning state."
                        ],
                        [
                          "Created",
                          "Created provisioning state."
                        ],
                        [
                          "Updating",
                          "Updating provisioning state."
                        ],
                        [
                          "Updated",
                          "Updated provisioning state."
                        ],
                        [
                          "Deleting",
                          "Deleting provisioning state."
                        ],
                        [
                          "Deleted",
                          "Deleted provisioning state."
                        ],
                        [
                          "Succeeded",
                          "Succeeded provisioning state."
                        ],
                        [
                          "Failed",
                          "Failed provisioning state."
                        ],
                        [
                          "Canceled",
                          "Canceled provisioning state."
                        ],
                        [
                          "MovingResources",
                          "Moving resources provisioning state."
                        ],
                        [
                          "TransientFailure",
                          "Transient failure provisioning state."
                        ],
                        [
                          "RolloutInProgress",
                          "Rollout in progress provisioning state."
                        ],
                        [
                          "StorageProvisioningFailed",
                          "Storage provisioning failed provisioning state."
                        ]
                      ],
                      "old": [
                        [
                          "NotSpecified",
                          ""
                        ],
                        [
                          "Accepted",
                          ""
                        ],
                        [
                          "Running",
                          ""
                        ],
                        [
                          "Creating",
                          ""
                        ],
                        [
                          "Created",
                          ""
                        ],
                        [
                          "Updating",
                          ""
                        ],
                        [
                          "Updated",
                          ""
                        ],
                        [
                          "Deleting",
                          ""
                        ],
                        [
                          "Deleted",
                          ""
                        ],
                        [
                          "Succeeded",
                          ""
                        ],
                        [
                          "Failed",
                          ""
                        ],
                        [
                          "Canceled",
                          ""
                        ],
                        [
                          "MovingResources",
                          ""
                        ],
                        [
                          "TransientFailure",
                          ""
                        ],
                        [
                          "RolloutInProgress",
                          ""
                        ],
                        [
                          "StorageProvisioningFailed",
                          ""
                        ]
                      ]
                    }
                  }
                ]
              },
              {
                "#name": "identity",
                "Description": {
                  "new": "Managed identity properties.",
                  "old": "Managed identity properties"
                }
              },
              {
                "@removed_4c66817db7bb46908d067ea10dd1d19c": {
                  "#name": "tags",
                  "Description": "Resource tags.",
                  "Required": false,
                  "Type": "object"
                }
              },
              {
                "@removed_844e8887cde24470adee6102fa8f3626": {
                  "#name": "location",
                  "Description": "The geo-location for the environment type",
                  "Required": false,
                  "Type": "string"
                }
              }
            ]
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/environmentTypes
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of resources to return from the operation. Example: '$top=10'. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The ProjectEnvironmentType items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
environmentCount:
{
Description: The number of environments of this type. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ProjectEnvironmentTypes_Get (updated)
Description :  Gets a project environment type.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectEnvironmentTypes_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        },
        {
          "@removed_b28fa63d41a24bc48bc75d1a9bccf3ff": {
            "#name": "tags",
            "Description": "Resource tags.",
            "Required": false,
            "Type": "object"
          }
        },
        {
          "@removed_5dc0450bc9b64f1c81fe069cc4d5c8bc": {
            "#name": "location",
            "Description": "The geo-location for the environment type",
            "Required": false,
            "Type": "string"
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/environmentTypes/{environmentTypeName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
environmentTypeName:
{
Description: The name of the environment type. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
environmentCount:
{
Description: The number of environments of this type. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ 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 ,
}
,
]
,
}
,
}
ProjectEnvironmentTypes_CreateOrUpdate (updated)
Description :  Creates or updates a project environment type.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectEnvironmentTypes_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": [
          {
            "properties": [
              {
                "#name": "provisioningState",
                "Enum": {
                  "new": [
                    [
                      "NotSpecified",
                      "Not specified provisioning state."
                    ],
                    [
                      "Accepted",
                      "Accepted provisioning state."
                    ],
                    [
                      "Running",
                      "Running provisioning state."
                    ],
                    [
                      "Creating",
                      "Creating provisioning state."
                    ],
                    [
                      "Created",
                      "Created provisioning state."
                    ],
                    [
                      "Updating",
                      "Updating provisioning state."
                    ],
                    [
                      "Updated",
                      "Updated provisioning state."
                    ],
                    [
                      "Deleting",
                      "Deleting provisioning state."
                    ],
                    [
                      "Deleted",
                      "Deleted provisioning state."
                    ],
                    [
                      "Succeeded",
                      "Succeeded provisioning state."
                    ],
                    [
                      "Failed",
                      "Failed provisioning state."
                    ],
                    [
                      "Canceled",
                      "Canceled provisioning state."
                    ],
                    [
                      "MovingResources",
                      "Moving resources provisioning state."
                    ],
                    [
                      "TransientFailure",
                      "Transient failure provisioning state."
                    ],
                    [
                      "RolloutInProgress",
                      "Rollout in progress provisioning state."
                    ],
                    [
                      "StorageProvisioningFailed",
                      "Storage provisioning failed provisioning state."
                    ]
                  ],
                  "old": [
                    [
                      "NotSpecified",
                      ""
                    ],
                    [
                      "Accepted",
                      ""
                    ],
                    [
                      "Running",
                      ""
                    ],
                    [
                      "Creating",
                      ""
                    ],
                    [
                      "Created",
                      ""
                    ],
                    [
                      "Updating",
                      ""
                    ],
                    [
                      "Updated",
                      ""
                    ],
                    [
                      "Deleting",
                      ""
                    ],
                    [
                      "Deleted",
                      ""
                    ],
                    [
                      "Succeeded",
                      ""
                    ],
                    [
                      "Failed",
                      ""
                    ],
                    [
                      "Canceled",
                      ""
                    ],
                    [
                      "MovingResources",
                      ""
                    ],
                    [
                      "TransientFailure",
                      ""
                    ],
                    [
                      "RolloutInProgress",
                      ""
                    ],
                    [
                      "StorageProvisioningFailed",
                      ""
                    ]
                  ]
                }
              }
            ]
          },
          {
            "#name": "identity",
            "Description": {
              "new": "Managed identity properties.",
              "old": "Managed identity properties"
            }
          },
          {
            "@removed_56adf581860a4d6fb1094f0b7f0f28b3": {
              "#name": "tags",
              "Description": "Resource tags.",
              "Required": false,
              "Type": "object"
            }
          },
          {
            "@removed_8bb9300a48e3486ca56dcb20f2d7d8f0": {
              "#name": "location",
              "Description": "The geo-location for the environment type",
              "Required": false,
              "Type": "string"
            }
          }
        ]
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        },
        {
          "@removed_13d457d3724b4190b82a23f6f75a51db": {
            "#name": "tags",
            "Description": "Resource tags.",
            "Required": false,
            "Type": "object"
          }
        },
        {
          "@removed_393b8bf92ae44bef989a98b71308cf15": {
            "#name": "location",
            "Description": "The geo-location for the environment type",
            "Required": false,
            "Type": "string"
          }
        }
      ]
    },
    "201": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        },
        {
          "@removed_dc8206edb68b4791adf7c2783b14171c": {
            "#name": "tags",
            "Description": "Resource tags.",
            "Required": false,
            "Type": "object"
          }
        },
        {
          "@removed_5abaaf073a2d45fe8f7651feca988060": {
            "#name": "location",
            "Description": "The geo-location for the environment type",
            "Required": false,
            "Type": "string"
          }
        }
      ]
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/environmentTypes/{environmentTypeName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
environmentTypeName:
{
Description: The name of the environment type. ,
Required: True ,
}
string ,
body:
{
Description: Represents a Project Environment Type. ,
Required: True ,
}
{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
environmentCount:
{
Description: The number of environments of this type. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
environmentCount:
{
Description: The number of environments of this type. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
environmentCount:
{
Description: The number of environments of this type. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ 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 ,
}
,
]
,
}
,
}
ProjectEnvironmentTypes_Update (updated)
Description :  Partially updates a project environment type.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectEnvironmentTypes_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    },
    {
      "body": {
        "$properties": [
          {
            "properties": [
              {
                "#name": "status",
                "Enum": {
                  "new": [
                    [
                      "Enabled",
                      "Environment type is enabled."
                    ],
                    [
                      "Disabled",
                      "Environment type is disabled."
                    ]
                  ],
                  "old": [
                    [
                      "Enabled",
                      ""
                    ],
                    [
                      "Disabled",
                      ""
                    ]
                  ]
                }
              }
            ]
          },
          {
            "#name": "identity",
            "Description": {
              "new": "Managed identity properties.",
              "old": "Managed identity properties"
            }
          }
        ]
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "NotSpecified",
                    "Not specified provisioning state."
                  ],
                  [
                    "Accepted",
                    "Accepted provisioning state."
                  ],
                  [
                    "Running",
                    "Running provisioning state."
                  ],
                  [
                    "Creating",
                    "Creating provisioning state."
                  ],
                  [
                    "Created",
                    "Created provisioning state."
                  ],
                  [
                    "Updating",
                    "Updating provisioning state."
                  ],
                  [
                    "Updated",
                    "Updated provisioning state."
                  ],
                  [
                    "Deleting",
                    "Deleting provisioning state."
                  ],
                  [
                    "Deleted",
                    "Deleted provisioning state."
                  ],
                  [
                    "Succeeded",
                    "Succeeded provisioning state."
                  ],
                  [
                    "Failed",
                    "Failed provisioning state."
                  ],
                  [
                    "Canceled",
                    "Canceled provisioning state."
                  ],
                  [
                    "MovingResources",
                    "Moving resources provisioning state."
                  ],
                  [
                    "TransientFailure",
                    "Transient failure provisioning state."
                  ],
                  [
                    "RolloutInProgress",
                    "Rollout in progress provisioning state."
                  ],
                  [
                    "StorageProvisioningFailed",
                    "Storage provisioning failed provisioning state."
                  ]
                ],
                "old": [
                  [
                    "NotSpecified",
                    ""
                  ],
                  [
                    "Accepted",
                    ""
                  ],
                  [
                    "Running",
                    ""
                  ],
                  [
                    "Creating",
                    ""
                  ],
                  [
                    "Created",
                    ""
                  ],
                  [
                    "Updating",
                    ""
                  ],
                  [
                    "Updated",
                    ""
                  ],
                  [
                    "Deleting",
                    ""
                  ],
                  [
                    "Deleted",
                    ""
                  ],
                  [
                    "Succeeded",
                    ""
                  ],
                  [
                    "Failed",
                    ""
                  ],
                  [
                    "Canceled",
                    ""
                  ],
                  [
                    "MovingResources",
                    ""
                  ],
                  [
                    "TransientFailure",
                    ""
                  ],
                  [
                    "RolloutInProgress",
                    ""
                  ],
                  [
                    "StorageProvisioningFailed",
                    ""
                  ]
                ]
              }
            }
          ]
        },
        {
          "#name": "identity",
          "Description": {
            "new": "Managed identity properties.",
            "old": "Managed identity properties"
          }
        },
        {
          "@removed_c8c7dfadc5874f0f91ed242a7c7fcab6": {
            "#name": "tags",
            "Description": "Resource tags.",
            "Required": false,
            "Type": "object"
          }
        },
        {
          "@removed_c377b28a68a44eab89aab848befde45e": {
            "#name": "location",
            "Description": "The geo-location for the environment type",
            "Required": false,
            "Type": "string"
          }
        }
      ]
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/environmentTypes/{environmentTypeName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
environmentTypeName:
{
Description: The name of the environment type. ,
Required: True ,
}
string ,
body:
{
Description: Updatable project environment type properties. ,
Required: True ,
}
{
properties:
{
Description: Properties to configure an environment type. ,
Required: False ,
}
{
deploymentTargetId:
{
Description: Id of a subscription that the environment type will be mapped to. The environment's resources will be deployed into this subscription. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the project environment type. ,
Required: False ,
}
string ,
status:
{
Description: Defines whether this Environment Type can be used in this Project. ,
Enum:
{
Enabled: Environment type is enabled. ,
Disabled: Environment type is disabled. ,
}
,
Required: False ,
}
enum ,
creatorRoleAssignment:
{
Description: The role definition assigned to the environment creator on backing resources. ,
Required: False ,
}
{
roles:
{
Description: A map of roles to assign to the environment creator. ,
Required: False ,
}
object ,
}
,
userRoleAssignments:
{
Description: Role Assignments created on environment backing resources. This is a mapping from a user object ID to an object of role definition IDs. ,
Required: False ,
}
object ,
}
,
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an environment type. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
environmentCount:
{
Description: The number of environments of this type. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed identity properties. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ 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 ,
}
,
]
,
}
,
}
ProjectEnvironmentTypes_Delete (updated)
Description :  Deletes a project environment type.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ProjectEnvironmentTypes_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/environmentTypes/{environmentTypeName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
environmentTypeName:
{
Description: The name of the environment type. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
Projects_GetInheritedSettings (updated)
Description :  Gets applicable inherited settings for this project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Projects_GetInheritedSettings",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "projectCatalogSettings": [
          {
            "#name": "catalogItemSyncEnableStatus",
            "Enum": {
              "new": [
                [
                  "Enabled",
                  "Catalog item sync is enabled."
                ],
                [
                  "Disabled",
                  "Catalog item sync is disabled."
                ]
              ],
              "old": [
                [
                  "Enabled",
                  ""
                ],
                [
                  "Disabled",
                  ""
                ]
              ]
            }
          }
        ],
        "networkSettings": [
          {
            "#name": "microsoftHostedNetworkEnableStatus",
            "Enum": {
              "new": [
                [
                  "Enabled",
                  "Microsoft Hosted Networks are enabled for this Dev Center."
                ],
                [
                  "Disabled",
                  "Microsoft Hosted Networks are disabled for this Dev Center."
                ]
              ],
              "old": [
                [
                  "Enabled",
                  ""
                ],
                [
                  "Disabled",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/getInheritedSettings
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
projectCatalogSettings:
{
Description: Dev Center settings to be used when associating a project with a catalog. ,
Required: False ,
}
{
catalogItemSyncEnableStatus:
{
Description: Whether project catalogs associated with projects in this dev center can be configured to sync catalog items. ,
Enum:
{
Enabled: Catalog item sync is enabled. ,
Disabled: Catalog item sync is disabled. ,
}
,
Required: False ,
}
enum ,
}
,
networkSettings:
{
Description: Network settings that will be enforced on this project. ,
Required: False ,
}
{
microsoftHostedNetworkEnableStatus:
{
Description: Indicates whether pools in this Dev Center can use Microsoft Hosted Networks. Defaults to Enabled if not set. ,
Enum:
{
Enabled: Microsoft Hosted Networks are enabled for this Dev Center. ,
Disabled: Microsoft Hosted Networks are disabled for this Dev Center. ,
}
,
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 ,
}
,
]
,
}
,
}
Images_ListByProject (updated)
Description :  Lists images for a project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Images_ListByProject",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of Image items",
        "old": "Results of the image list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The Image items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                },
                {
                  "#name": "hibernateSupport",
                  "Enum": {
                    "new": [
                      [
                        "Disabled",
                        "Hibernate is disabled."
                      ],
                      [
                        "Enabled",
                        "Hibernate is enabled."
                      ]
                    ],
                    "old": [
                      [
                        "Disabled",
                        ""
                      ],
                      [
                        "Enabled",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/images
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The Image items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Image properties. ,
Required: False ,
}
{
description:
{
Description: The description of the image. ,
Required: False ,
}
string ,
publisher:
{
Description: The publisher of the image. ,
Required: False ,
}
string ,
offer:
{
Description: The name of the image offer. ,
Required: False ,
}
string ,
sku:
{
Description: The SKU name for the image. ,
Required: False ,
}
string ,
recommendedMachineConfiguration:
{
Description: The recommended machine configuration to use with the image. ,
Required: False ,
}
{
memory:
{
Description: Recommended memory range. ,
Required: False ,
}
{
min:
{
Description: Minimum value. ,
Format: int32 ,
Required: False ,
}
integer ,
max:
{
Description: Maximum value. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
vCPUs:
{
Description: Recommended vCPU range. ,
Required: False ,
}
{
min:
{
Description: Minimum value. ,
Format: int32 ,
Required: False ,
}
integer ,
max:
{
Description: Maximum value. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
hibernateSupport:
{
Description: Indicates whether this image has hibernate enabled. Not all images are capable of supporting hibernation. To find out more see https://aka.ms/devbox/hibernate ,
Enum:
{
Disabled: Hibernate is disabled. ,
Enabled: Hibernate is enabled. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
Images_GetByProject (updated)
Description :  Gets an image.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Images_GetByProject",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          },
          {
            "#name": "hibernateSupport",
            "Enum": {
              "new": [
                [
                  "Disabled",
                  "Hibernate is disabled."
                ],
                [
                  "Enabled",
                  "Hibernate is enabled."
                ]
              ],
              "old": [
                [
                  "Disabled",
                  ""
                ],
                [
                  "Enabled",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/images/{imageName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
imageName:
{
Description: The name of the image. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Image properties. ,
Required: False ,
}
{
description:
{
Description: The description of the image. ,
Required: False ,
}
string ,
publisher:
{
Description: The publisher of the image. ,
Required: False ,
}
string ,
offer:
{
Description: The name of the image offer. ,
Required: False ,
}
string ,
sku:
{
Description: The SKU name for the image. ,
Required: False ,
}
string ,
recommendedMachineConfiguration:
{
Description: The recommended machine configuration to use with the image. ,
Required: False ,
}
{
memory:
{
Description: Recommended memory range. ,
Required: False ,
}
{
min:
{
Description: Minimum value. ,
Format: int32 ,
Required: False ,
}
integer ,
max:
{
Description: Maximum value. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
vCPUs:
{
Description: Recommended vCPU range. ,
Required: False ,
}
{
min:
{
Description: Minimum value. ,
Format: int32 ,
Required: False ,
}
integer ,
max:
{
Description: Maximum value. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
Required: False ,
}
enum ,
hibernateSupport:
{
Description: Indicates whether this image has hibernate enabled. Not all images are capable of supporting hibernation. To find out more see https://aka.ms/devbox/hibernate ,
Enum:
{
Disabled: Hibernate is disabled. ,
Enabled: Hibernate is enabled. ,
}
,
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 ,
}
,
]
,
}
,
}
ImageVersions_ListByProject (updated)
Description :  Lists versions for an image.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ImageVersions_ListByProject",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "Paged collection of ImageVersion items",
        "old": "Results of the image version list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The ImageVersion items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "properties": [
                {
                  "#name": "provisioningState",
                  "Enum": {
                    "new": [
                      [
                        "NotSpecified",
                        "Not specified provisioning state."
                      ],
                      [
                        "Accepted",
                        "Accepted provisioning state."
                      ],
                      [
                        "Running",
                        "Running provisioning state."
                      ],
                      [
                        "Creating",
                        "Creating provisioning state."
                      ],
                      [
                        "Created",
                        "Created provisioning state."
                      ],
                      [
                        "Updating",
                        "Updating provisioning state."
                      ],
                      [
                        "Updated",
                        "Updated provisioning state."
                      ],
                      [
                        "Deleting",
                        "Deleting provisioning state."
                      ],
                      [
                        "Deleted",
                        "Deleted provisioning state."
                      ],
                      [
                        "Succeeded",
                        "Succeeded provisioning state."
                      ],
                      [
                        "Failed",
                        "Failed provisioning state."
                      ],
                      [
                        "Canceled",
                        "Canceled provisioning state."
                      ],
                      [
                        "MovingResources",
                        "Moving resources provisioning state."
                      ],
                      [
                        "TransientFailure",
                        "Transient failure provisioning state."
                      ],
                      [
                        "RolloutInProgress",
                        "Rollout in progress provisioning state."
                      ],
                      [
                        "StorageProvisioningFailed",
                        "Storage provisioning failed provisioning state."
                      ]
                    ],
                    "old": [
                      [
                        "NotSpecified",
                        ""
                      ],
                      [
                        "Accepted",
                        ""
                      ],
                      [
                        "Running",
                        ""
                      ],
                      [
                        "Creating",
                        ""
                      ],
                      [
                        "Created",
                        ""
                      ],
                      [
                        "Updating",
                        ""
                      ],
                      [
                        "Updated",
                        ""
                      ],
                      [
                        "Deleting",
                        ""
                      ],
                      [
                        "Deleted",
                        ""
                      ],
                      [
                        "Succeeded",
                        ""
                      ],
                      [
                        "Failed",
                        ""
                      ],
                      [
                        "Canceled",
                        ""
                      ],
                      [
                        "MovingResources",
                        ""
                      ],
                      [
                        "TransientFailure",
                        ""
                      ],
                      [
                        "RolloutInProgress",
                        ""
                      ],
                      [
                        "StorageProvisioningFailed",
                        ""
                      ]
                    ]
                  }
                }
              ]
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/images/{imageName}/versions
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
imageName:
{
Description: The name of the image. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The ImageVersion items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Image version properties. ,
Required: False ,
}
{
name:
{
Description: The semantic version string. ,
Required: False ,
}
string ,
publishedDate:
{
Description: The datetime that the backing image version was published. ,
Format: date-time ,
Required: False ,
}
string ,
excludeFromLatest:
{
Description: If the version should be excluded from being treated as the latest version. ,
Required: False ,
}
boolean ,
osDiskImageSizeInGb:
{
Description: The size of the OS disk image, in GB. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
ImageVersions_GetByProject (updated)
Description :  Gets an image version.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ImageVersions_GetByProject",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "NotSpecified",
                  "Not specified provisioning state."
                ],
                [
                  "Accepted",
                  "Accepted provisioning state."
                ],
                [
                  "Running",
                  "Running provisioning state."
                ],
                [
                  "Creating",
                  "Creating provisioning state."
                ],
                [
                  "Created",
                  "Created provisioning state."
                ],
                [
                  "Updating",
                  "Updating provisioning state."
                ],
                [
                  "Updated",
                  "Updated provisioning state."
                ],
                [
                  "Deleting",
                  "Deleting provisioning state."
                ],
                [
                  "Deleted",
                  "Deleted provisioning state."
                ],
                [
                  "Succeeded",
                  "Succeeded provisioning state."
                ],
                [
                  "Failed",
                  "Failed provisioning state."
                ],
                [
                  "Canceled",
                  "Canceled provisioning state."
                ],
                [
                  "MovingResources",
                  "Moving resources provisioning state."
                ],
                [
                  "TransientFailure",
                  "Transient failure provisioning state."
                ],
                [
                  "RolloutInProgress",
                  "Rollout in progress provisioning state."
                ],
                [
                  "StorageProvisioningFailed",
                  "Storage provisioning failed provisioning state."
                ]
              ],
              "old": [
                [
                  "NotSpecified",
                  ""
                ],
                [
                  "Accepted",
                  ""
                ],
                [
                  "Running",
                  ""
                ],
                [
                  "Creating",
                  ""
                ],
                [
                  "Created",
                  ""
                ],
                [
                  "Updating",
                  ""
                ],
                [
                  "Updated",
                  ""
                ],
                [
                  "Deleting",
                  ""
                ],
                [
                  "Deleted",
                  ""
                ],
                [
                  "Succeeded",
                  ""
                ],
                [
                  "Failed",
                  ""
                ],
                [
                  "Canceled",
                  ""
                ],
                [
                  "MovingResources",
                  ""
                ],
                [
                  "TransientFailure",
                  ""
                ],
                [
                  "RolloutInProgress",
                  ""
                ],
                [
                  "StorageProvisioningFailed",
                  ""
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/images/{imageName}/versions/{versionName}
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
imageName:
{
Description: The name of the image. ,
Required: True ,
}
string ,
versionName:
{
Description: The version of the image. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Image version properties. ,
Required: False ,
}
{
name:
{
Description: The semantic version string. ,
Required: False ,
}
string ,
publishedDate:
{
Description: The datetime that the backing image version was published. ,
Format: date-time ,
Required: False ,
}
string ,
excludeFromLatest:
{
Description: If the version should be excluded from being treated as the latest version. ,
Required: False ,
}
boolean ,
osDiskImageSizeInGb:
{
Description: The size of the OS disk image, in GB. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: Not specified provisioning state. ,
Accepted: Accepted provisioning state. ,
Running: Running provisioning state. ,
Creating: Creating provisioning state. ,
Created: Created provisioning state. ,
Updating: Updating provisioning state. ,
Updated: Updated provisioning state. ,
Deleting: Deleting provisioning state. ,
Deleted: Deleted provisioning state. ,
Succeeded: Succeeded provisioning state. ,
Failed: Failed provisioning state. ,
Canceled: Canceled provisioning state. ,
MovingResources: Moving resources provisioning state. ,
TransientFailure: Transient failure provisioning state. ,
RolloutInProgress: Rollout in progress provisioning state. ,
StorageProvisioningFailed: Storage provisioning failed provisioning state. ,
}
,
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 ,
}
,
]
,
}
,
}
Skus_ListByProject (updated)
Description :  Lists SKUs available to the project.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Skus_ListByProject",
  "Description": {
    "new": "Lists SKUs available to the project.",
    "old": "Lists SKUs available to the project"
  },
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The ID of the target subscription."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The DevCenterSku items on this page",
            "old": "Current page of results."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "Description": {
              "new": "The resource model definition representing SKU for DevCenter resources.",
              "old": "The resource model definition representing SKU for DevCenter resources"
            },
            "$properties": [
              {
                "#name": "resourceType",
                "Description": {
                  "new": "The name of the resource type.",
                  "old": "The name of the resource type"
                }
              }
            ]
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "URL to get the next set of results if there are any."
          }
        }
      ]
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/listSkus
{
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The DevCenterSku items on this page ,
Required: True ,
}
[
{
resourceType:
{
Description: The name of the resource type. ,
Required: False ,
}
string ,
locations:
{
Description: SKU supported locations. ,
Required: False ,
}
[
string ,
]
,
capabilities:
{
Description: Collection of name/value pairs to describe the SKU capabilities. ,
Required: False ,
}
[
{
name:
{
Description: Name of the capability. ,
Required: False ,
}
string ,
value:
{
Description: Value of the capability. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
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 ,
}
[
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 ,
}
,
]
,
}
,
}
Skus_ListBySubscription (removed)
Description :  Lists the Microsoft.DevCenter SKUs available in a subscription
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.DevCenter/skus
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
resourceType:
{
Description: The name of the resource type ,
Required: False ,
}
string ,
locations:
{
Description: SKU supported locations. ,
Required: False ,
}
[
string ,
]
,
capabilities:
{
Description: Collection of name/value pairs to describe the SKU capabilities. ,
Required: False ,
}
[
{
name:
{
Description: Name of the capability. ,
Required: False ,
}
string ,
value:
{
Description: Value of the capability. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
Pools_ListByProject (removed)
Description :  Lists pools for a project
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
Pools_Get (removed)
Description :  Gets a machine pool
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}
{}

⚐ Response (200)

{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: 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 ,
}
,
]
,
}
,
}
Pools_CreateOrUpdate (removed)
Description :  Creates or updates a machine pool
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}
{
body:
{
Description: Represents a machine pool ,
Required: True ,
}
{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: 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 ,
}
,
]
,
}
,
}
Pools_Update (removed)
Description :  Partially updates a machine pool
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}
{
body:
{
Description: Represents a machine pool ,
Required: True ,
}
{
properties:
{
Description: Properties of a pool to be updated. ,
Required: False ,
}
{
devBoxDefinitionType:
{
Description: Indicates if the pool is created from an existing Dev Box Definition or if one is provided directly. ,
Enum:
{
Reference: No description available. ,
Value: No description available. ,
}
,
Required: False ,
}
enum ,
devBoxDefinitionName:
{
Description: Name of a Dev Box definition in parent Project of this Pool. Will be ignored if devBoxDefinitionType is Value. ,
Required: False ,
}
string ,
devBoxDefinition:
{
Description: A definition of the machines that are created from this Pool. Will be ignored if devBoxDefinitionType is Reference or not provided. ,
Required: False ,
}
{
imageReference:
{
Description: Image reference information. ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
sku:
{
Description: The SKU for Dev Boxes created from the Pool. ,
Required: False ,
}
{
name:
{
Description: The name of the SKU. E.g. P3. It is typically a letter+number code ,
Required: True ,
}
string ,
tier:
{
Description: This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT. ,
Enum:
{
Free: No description available. ,
Basic: No description available. ,
Standard: No description available. ,
Premium: No description available. ,
}
,
Required: False ,
}
enum ,
size:
{
Description: The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code. ,
Required: False ,
}
string ,
family:
{
Description: If the service has different generations of hardware, for the same SKU, then that can be captured here. ,
Required: False ,
}
string ,
capacity:
{
Description: If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
activeImageReference:
{
Description: Image reference information for the currently active image (only populated during updates). ,
Required: False ,
}
{
id:
{
Description: Image ID, or Image version ID. When Image ID is provided, its latest version will be used. ,
Required: False ,
}
string ,
exactVersion:
{
Description: The actual version of the image after use. When id references a gallery image latest version, this will indicate the actual version in use. ,
Required: False ,
}
string ,
}
,
}
,
networkConnectionName:
{
Description: Name of a Network Connection in parent Project of this Pool ,
Required: False ,
}
string ,
licenseType:
{
Description: Specifies the license type indicating the caller has already acquired licenses for the Dev Boxes that will be created. ,
Enum:
{
Windows_Client: No description available. ,
}
,
Required: False ,
}
enum ,
localAdministrator:
{
Description: Indicates whether owners of Dev Boxes in this pool are added as local administrators on the Dev Box. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
stopOnDisconnect:
{
Description: Stop on disconnect configuration settings for Dev Boxes created in this pool. ,
Required: False ,
}
{
status:
{
Description: Whether the feature to stop the Dev Box on disconnect once the grace period has lapsed is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
gracePeriodMinutes:
{
Description: The specified time in minutes to wait before stopping a Dev Box once disconnect is detected. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
stopOnNoConnect:
{
Description: Stop on no connect configuration settings for Dev Boxes created in this pool. ,
Required: False ,
}
{
status:
{
Description: Enables the feature to stop a started Dev Box when it has not been connected to, once the grace period has lapsed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
gracePeriodMinutes:
{
Description: The specified time in minutes to wait before stopping a Dev Box if no connection is made. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
singleSignOnStatus:
{
Description: Indicates whether Dev Boxes in this pool are created with single sign on enabled. The also requires that single sign on be enabled on the tenant. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
displayName:
{
Description: The display name of the pool. ,
Required: False ,
}
string ,
virtualNetworkType:
{
Description: Indicates whether the pool uses a Virtual Network managed by Microsoft or a customer provided network. ,
Enum:
{
Managed: No description available. ,
Unmanaged: No description available. ,
}
,
Required: False ,
}
enum ,
managedVirtualNetworkRegions:
{
Description: The regions of the managed virtual network (required when managedNetworkType is Managed). ,
Required: False ,
}
[
string ,
]
,
activeHoursConfiguration:
{
Description: Active hours configuration settings for Dev Boxes created in this pool. ,
Required: False ,
}
{
keepAwakeEnableStatus:
{
Description: Enables or disables whether the Dev Box should be kept awake during active hours. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
autoStartEnableStatus:
{
Description: Enables or disables whether the Dev Box should be automatically started at commencement of active hours. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
defaultTimeZone:
{
Description: The default IANA timezone id of the active hours. ,
Required: False ,
}
string ,
defaultStartTimeHour:
{
Description: The default start time of the active hours. ,
Format: int32 ,
Required: False ,
}
integer ,
defaultEndTimeHour:
{
Description: The default end time of the active hours ,
Format: int32 ,
Required: False ,
}
integer ,
defaultDaysOfWeek:
{
Description: The days of the week that active hours features will be enabled. This serves as a default that can be updated by each individual user. ,
Required: False ,
}
[
string ,
]
,
daysOfWeekLimit:
{
Description: The maximum amount of days per week that a user can enable active hours related features. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
devBoxTunnelEnableStatus:
{
Description: Indicates whether Dev Box Tunnel is enabled for a the pool. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Pool properties ,
Required: False ,
}
{
healthStatus:
{
Description: Overall health status of the Pool. Indicates whether or not the Pool is available to create Dev Boxes. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Healthy: No description available. ,
Warning: No description available. ,
Unhealthy: No description available. ,
}
,
Required: False ,
}
enum ,
healthStatusDetails:
{
Description: Details on the Pool health status to help diagnose issues. This is only populated when the pool status indicates the pool is in a non-healthy state ,
Required: False ,
}
[
{
code:
{
Description: An identifier for the issue. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the issue, intended to be suitable for display in a user interface ,
Required: False ,
}
string ,
}
,
]
,
devBoxCount:
{
Description: Indicates the number of provisioned Dev Boxes in this pool. ,
Format: int32 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
location: 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 ,
}
,
]
,
}
,
}
Pools_Delete (removed)
Description :  Deletes a machine pool
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}
{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
Pools_RunHealthChecks (removed)
Description :  Triggers a refresh of the pool status.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/runHealthChecks
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
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 ,
projectName:
{
Description: The name of the project. ,
Required: True ,
}
string ,
poolName:
{
Description: Name of the pool. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location: 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 ,
}
,
]
,
}
,
}
Schedules_ListByPool (removed)
Description :  Lists schedules for a pool
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
Schedules_Get (removed)
Description :  Gets a schedule resource.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}
{}

⚐ Response (200)

{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: 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 ,
}
,
]
,
}
,
}
Schedules_CreateOrUpdate (removed)
Description :  Creates or updates a Schedule.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}
{
body:
{
Description: Represents a scheduled task ,
Required: True ,
}
{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: 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 ,
}
,
]
,
}
,
}
Schedules_Update (removed)
Description :  Partially updates a Scheduled.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}
{
body:
{
Description: Represents a scheduled task. ,
Required: True ,
}
{
properties:
{
Description: Properties of a schedule resource to be updated. ,
Required: False ,
}
{
type:
{
Description: Supported type this scheduled task represents. ,
Enum:
{
StopDevBox: No description available. ,
}
,
Required: False ,
}
enum ,
frequency:
{
Description: The frequency of this scheduled task. ,
Enum:
{
Daily: No description available. ,
}
,
Required: False ,
}
enum ,
time:
{
Description: The target time to trigger the action. The format is HH:MM. ,
Required: False ,
}
string ,
timeZone:
{
Description: The IANA timezone id at which the schedule should execute. ,
Required: False ,
}
string ,
state:
{
Description: Indicates whether or not this scheduled task is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a Schedule resource ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
location: 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 ,
}
,
]
,
}
,
}
Schedules_Delete (removed)
Description :  Deletes a Scheduled.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}
{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
NetworkConnections_ListBySubscription (removed)
Description :  Lists network connections in a subscription
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.DevCenter/networkConnections
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
NetworkConnections_ListByResourceGroup (removed)
Description :  Lists network connections in a resource group
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
NetworkConnections_Get (removed)
Description :  Gets a network connection resource
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}
{}

⚐ Response (200)

{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
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 ,
}
,
]
,
}
,
}
NetworkConnections_CreateOrUpdate (removed)
Description :  Creates or updates a Network Connections resource
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}
{
body:
{
Description: Represents network connection ,
Required: True ,
}
{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
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 ,
}
,
]
,
}
,
}
NetworkConnections_Update (removed)
Description :  Partially updates a Network Connection
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}
{
body:
{
Description: Represents network connection ,
Required: True ,
}
{
properties:
{
Description: Properties of a network connection resource to be updated. ,
Required: False ,
}
{
subnetId:
{
Description: The subnet to attach Virtual Machines to ,
Required: False ,
}
string ,
domainName:
{
Description: Active Directory domain name ,
Required: False ,
}
string ,
organizationUnit:
{
Description: Active Directory domain Organization Unit (OU) ,
Required: False ,
}
string ,
domainUsername:
{
Description: The username of an Active Directory account (user or service account) that has permissions to create computer objects in Active Directory. Required format: admin@contoso.com. ,
Required: False ,
}
string ,
domainPassword:
{
Description: The password for the account used to join domain ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of a Network Connection ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the resource. ,
Enum:
{
NotSpecified: No description available. ,
Accepted: No description available. ,
Running: No description available. ,
Creating: No description available. ,
Created: No description available. ,
Updating: No description available. ,
Updated: No description available. ,
Deleting: No description available. ,
Deleted: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
MovingResources: No description available. ,
TransientFailure: No description available. ,
RolloutInProgress: No description available. ,
StorageProvisioningFailed: No description available. ,
}
,
Required: False ,
}
enum ,
healthCheckStatus:
{
Description: Overall health status of the network connection. Health checks are run on creation, update, and periodically to validate the network connection. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
networkingResourceGroupName:
{
Description: The name for resource group where NICs will be placed. ,
Required: False ,
}
string ,
domainJoinType:
{
Description: AAD Join type. ,
Enum:
{
HybridAzureADJoin: No description available. ,
AzureADJoin: No description available. ,
None: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (202)

{
location: 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 ,
}
,
]
,
}
,
}
NetworkConnections_Delete (removed)
Description :  Deletes a Network Connections resource
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}
{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ 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 ,
}
,
]
,
}
,
}
NetworkConnections_ListHealthDetails (removed)
Description :  Lists health check status details
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}/healthChecks
{}

⚐ Response (200)

{
value:
{
Description: Current page of results. ,
Required: False ,
}
[
{
properties:
{
Description: Health check status details properties. ,
Required: False ,
}
{
startDateTime:
{
Description: Start time of last execution of the health checks. ,
Format: date-time ,
Required: False ,
}
string ,
endDateTime:
{
Description: End time of last execution of the health checks. ,
Format: date-time ,
Required: False ,
}
string ,
healthChecks:
{
Description: Details for each health check item. ,
Required: False ,
}
[
{
status:
{
Description: The status of the health check item. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
displayName:
{
Description: The display name of this health check item. ,
Required: False ,
}
string ,
startDateTime:
{
Description: Start time of health check item. ,
Format: date-time ,
Required: False ,
}
string ,
endDateTime:
{
Description: End time of the health check item. ,
Format: date-time ,
Required: False ,
}
string ,
errorType:
{
Description: The type of error that occurred during this health check. ,
Required: False ,
}
string ,
recommendedAction:
{
Description: The recommended action to fix the corresponding error. ,
Required: False ,
}
string ,
additionalDetails:
{
Description: Additional details about the health check or the recommended action. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results if there are any. ,
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 ,
}
,
]
,
}
,
}
NetworkConnections_GetHealthDetails (removed)
Description :  Gets health check status details.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}/healthChecks/latest
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
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 ,
networkConnectionName:
{
Description: Name of the Network Connection that can be applied to a Pool. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Health check status details properties. ,
Required: False ,
}
{
startDateTime:
{
Description: Start time of last execution of the health checks. ,
Format: date-time ,
Required: False ,
}
string ,
endDateTime:
{
Description: End time of last execution of the health checks. ,
Format: date-time ,
Required: False ,
}
string ,
healthChecks:
{
Description: Details for each health check item. ,
Required: False ,
}
[
{
status:
{
Description: The status of the health check item. ,
Enum:
{
Unknown: No description available. ,
Pending: No description available. ,
Running: No description available. ,
Passed: No description available. ,
Warning: No description available. ,
Failed: No description available. ,
Informational: No description available. ,
}
,
Required: False ,
}
enum ,
displayName:
{
Description: The display name of this health check item. ,
Required: False ,
}
string ,
startDateTime:
{
Description: Start time of health check item. ,
Format: date-time ,
Required: False ,
}
string ,
endDateTime:
{
Description: End time of the health check item. ,
Format: date-time ,
Required: False ,
}
string ,
errorType:
{
Description: The type of error that occurred during this health check. ,
Required: False ,
}
string ,
recommendedAction:
{
Description: The recommended action to fix the corresponding error. ,
Required: False ,
}
string ,
additionalDetails:
{
Description: Additional details about the health check or the recommended action. ,
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 ,
}
,
]
,
}
,
}
NetworkConnections_RunHealthChecks (removed)
Description :  Triggers a new health check run. The execution and health check result can be tracked via the network Connection health check details
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}/runHealthChecks
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
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 ,
networkConnectionName:
{
Description: Name of the Network Connection that can be applied to a Pool. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location: 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 ,
}
,
]
,
}
,
}
NetworkConnections_ListOutboundNetworkDependenciesEndpoints (removed)
Description :  Lists the endpoints that agents may call as part of Dev Box service administration. These FQDNs should be allowed for outbound access in order for the Dev Box service to function.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}/outboundNetworkDependenciesEndpoints
{}

⚐ Response (200)

{
value:
{
Description: The collection of outbound network dependency endpoints returned by the listing operation. ,
Required: False ,
}
[
{
category:
{
Description: The type of service that the agent connects to. ,
Required: False ,
}
string ,
endpoints:
{
Description: The endpoints for this service for which the agent requires outbound access. ,
Required: False ,
}
[
{
domainName:
{
Description: The domain name of the dependency. Domain names may be fully qualified or may contain a * wildcard. ,
Required: False ,
}
string ,
description:
{
Description: Human-readable supplemental information about the dependency and when it is applicable. ,
Required: False ,
}
string ,
endpointDetails:
{
Description: The list of connection details for this endpoint. ,
Required: False ,
}
[
{
port:
{
Description: The port an endpoint is connected to. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
]
,
}
,
]
,
nextLink:
{
Description: The continuation token. ,
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 ,
}
,
]
,
}
,
}