Microsoft.DigitalTwins (preview:2020-03-01)

2025/10/23 • 12 new, 12 deleted methods

DigitalTwins_Get (new)
Description :  Get DigitalTwinsInstances resource.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_CreateOrUpdate (new)
Description :  Create or update the metadata of a DigitalTwinsInstance. The usual pattern to modify a property is to retrieve the DigitalTwinsInstance and security metadata, and then combine them with the modified values in a new body to update the DigitalTwinsInstance.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
digitalTwinsCreate:
{
Description: The DigitalTwinsInstance and security metadata. ,
Required: True ,
}
{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_Update (new)
Description :  Update metadata of DigitalTwinsInstance.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
digitalTwinsPatchDescription:
{
Description: The DigitalTwinsInstance and security metadata. ,
Required: True ,
}
{
tags:
{
Description: Instance tags ,
Required: False ,
}
object ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (201)

{}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_Delete (new)
Description :  Delete a DigitalTwinsInstance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwinsEndpoint_List (new)
Description :  Get DigitalTwinsInstance Endpoints.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of DigitalTwinsInstance Endpoints. ,
Required: False ,
}
string ,
value:
{
Description: A list of DigitalTwinsInstance Endpoints. ,
Required: False ,
}
[
{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwinsEndpoint_Get (new)
Description :  Get DigitalTwinsInstances Endpoint.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of Endpoint Resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwinsEndpoint_CreateOrUpdate (new)
Description :  Create or update DigitalTwinsInstance endpoint.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of Endpoint Resource. ,
Required: True ,
}
string ,
endpointDescription:
{
Description: The DigitalTwinsInstance endpoint metadata and security metadata. ,
Required: True ,
}
{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwinsEndpoint_Delete (new)
Description :  Delete a DigitalTwinsInstance endpoint.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of Endpoint Resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_List (new)
Description :  Get all the DigitalTwinsInstances in a subscription.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/digitalTwinsInstances
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of DigitalTwins description objects. ,
Required: False ,
}
string ,
value:
{
Description: A list of DigitalTwins description objects. ,
Required: False ,
}
[
{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_ListByResourceGroup (new)
Description :  Get all the DigitalTwinsInstances in a resource group.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of DigitalTwins description objects. ,
Required: False ,
}
string ,
value:
{
Description: A list of DigitalTwins description objects. ,
Required: False ,
}
[
{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
Operations_List (new)
Description :  Lists all of the available DigitalTwins service REST API operations.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.DigitalTwins/operations
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of DigitalTwins description objects. ,
Required: False ,
}
string ,
value:
{
Description: A list of DigitalTwins operations supported by the Microsoft.DigitalTwins resource provider. ,
Required: False ,
}
[
{
name:
{
Description: Operation name: {provider}/{resource}/{read | write | action | delete} ,
Required: False ,
}
string ,
display:
{
Description: Operation properties display ,
Required: False ,
}
{
provider:
{
Description: Service provider: Microsoft DigitalTwins ,
Required: False ,
}
string ,
resource:
{
Description: Resource Type: DigitalTwinsInstances ,
Required: False ,
}
string ,
operation:
{
Description: Name of the operation ,
Required: False ,
}
string ,
description:
{
Description: Friendly description for the operation, ,
Required: False ,
}
string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_CheckNameAvailability (new)
Description :  Check if a DigitalTwinsInstance name is available.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/locations/{location}/checkNameAvailability
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
location:
{
Description: Location of DigitalTwinsInstance. ,
Required: True ,
}
string ,
digitalTwinsInstanceCheckName:
{
Description: Set the name parameter in the DigitalTwinsInstanceCheckName structure to the name of the DigitalTwinsInstance to check. ,
Required: True ,
}
{
name:
{
Description: Resource name. ,
Required: True ,
}
string ,
type:
{
Description: The type of resource, for instance Microsoft.DigitalTwins/digitalTwinsInstances. ,
Enum:
{
Microsoft.DigitalTwins/digitalTwinsInstances: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (200)

{
nameAvailable:
{
Description: Specifies a Boolean value that indicates if the name is available. ,
Required: False ,
}
boolean ,
name:
{
Description: The name that was checked. ,
Required: False ,
}
string ,
message:
{
Description: Message indicating an unavailable name due to a conflict, or a description of the naming rules that are violated. ,
Required: False ,
}
string ,
reason:
{
Description: Message providing the reason why the given name is invalid. ,
Enum:
{
Invalid: No description available. ,
AlreadyExists: No description available. ,
}
,
Required: False ,
}
enum ,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_Get (removed)
Description :  Get DigitalTwinsInstances resource.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_CreateOrUpdate (removed)
Description :  Create or update the metadata of a DigitalTwinsInstance. The usual pattern to modify a property is to retrieve the DigitalTwinsInstance and security metadata, and then combine them with the modified values in a new body to update the DigitalTwinsInstance.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
digitalTwinsCreate:
{
Description: The DigitalTwinsInstance and security metadata. ,
Required: True ,
}
{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_Update (removed)
Description :  Update metadata of DigitalTwinsInstance.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
digitalTwinsPatchDescription:
{
Description: The DigitalTwinsInstance and security metadata. ,
Required: True ,
}
{
tags:
{
Description: Instance tags ,
Required: False ,
}
object ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (201)

{}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_Delete (removed)
Description :  Delete a DigitalTwinsInstance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwinsEndpoint_List (removed)
Description :  Get DigitalTwinsInstance Endpoints.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of DigitalTwinsInstance Endpoints. ,
Required: False ,
}
string ,
value:
{
Description: A list of DigitalTwinsInstance Endpoints. ,
Required: False ,
}
[
{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwinsEndpoint_Get (removed)
Description :  Get DigitalTwinsInstances Endpoint.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of Endpoint Resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwinsEndpoint_CreateOrUpdate (removed)
Description :  Create or update DigitalTwinsInstance endpoint.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of Endpoint Resource. ,
Required: True ,
}
string ,
endpointDescription:
{
Description: The DigitalTwinsInstance endpoint metadata and security metadata. ,
Required: True ,
}
{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwinsEndpoint_Delete (removed)
Description :  Delete a DigitalTwinsInstance endpoint.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
resourceName:
{
Description: The name of the DigitalTwinsInstance. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of Endpoint Resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
properties:
{
Description: DigitalTwinsInstance endpoint resource properties. ,
Required: False ,
}
{
endpointType:
{
Description: The type of Digital Twins endpoint ,
Enum:
{
EventHub: No description available. ,
EventGrid: No description available. ,
ServiceBus: No description available. ,
}
,
Required: True ,
}
enum ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
createdTime:
{
Description: Time when the Endpoint was added to DigitalTwinsInstance. ,
Format: date-time ,
Required: False ,
}
string ,
tags:
{
Description: The resource tags. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_List (removed)
Description :  Get all the DigitalTwinsInstances in a subscription.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/digitalTwinsInstances
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of DigitalTwins description objects. ,
Required: False ,
}
string ,
value:
{
Description: A list of DigitalTwins description objects. ,
Required: False ,
}
[
{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_ListByResourceGroup (removed)
Description :  Get all the DigitalTwinsInstances in a resource group.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the DigitalTwinsInstance. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of DigitalTwins description objects. ,
Required: False ,
}
string ,
value:
{
Description: A list of DigitalTwins description objects. ,
Required: False ,
}
[
{
properties:
{
Description: DigitalTwins instance properties. ,
Required: False ,
}
{
createdTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
lastUpdatedTime:
{
Description: Time when DigitalTwinsInstance was created. ,
Format: date-time ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state. ,
Enum:
{
Provisioning: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: Api endpoint to work with DigitalTwinsInstance. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
Operations_List (removed)
Description :  Lists all of the available DigitalTwins service REST API operations.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.DigitalTwins/operations
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of DigitalTwins description objects. ,
Required: False ,
}
string ,
value:
{
Description: A list of DigitalTwins operations supported by the Microsoft.DigitalTwins resource provider. ,
Required: False ,
}
[
{
name:
{
Description: Operation name: {provider}/{resource}/{read | write | action | delete} ,
Required: False ,
}
string ,
display:
{
Description: Operation properties display ,
Required: False ,
}
{
provider:
{
Description: Service provider: Microsoft DigitalTwins ,
Required: False ,
}
string ,
resource:
{
Description: Resource Type: DigitalTwinsInstances ,
Required: False ,
}
string ,
operation:
{
Description: Name of the operation ,
Required: False ,
}
string ,
description:
{
Description: Friendly description for the operation, ,
Required: False ,
}
string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}
DigitalTwins_CheckNameAvailability (removed)
Description :  Check if a DigitalTwinsInstance name is available.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/locations/{location}/checkNameAvailability
{
api-version:
{
Description: Version of the DigitalTwinsInstance Management API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
location:
{
Description: Location of DigitalTwinsInstance. ,
Required: True ,
}
string ,
digitalTwinsInstanceCheckName:
{
Description: Set the name parameter in the DigitalTwinsInstanceCheckName structure to the name of the DigitalTwinsInstance to check. ,
Required: True ,
}
{
name:
{
Description: Resource name. ,
Required: True ,
}
string ,
type:
{
Description: The type of resource, for instance Microsoft.DigitalTwins/digitalTwinsInstances. ,
Enum:
{
Microsoft.DigitalTwins/digitalTwinsInstances: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (200)

{
nameAvailable:
{
Description: Specifies a Boolean value that indicates if the name is available. ,
Required: False ,
}
boolean ,
name:
{
Description: The name that was checked. ,
Required: False ,
}
string ,
message:
{
Description: Message indicating an unavailable name due to a conflict, or a description of the naming rules that are violated. ,
Required: False ,
}
string ,
reason:
{
Description: Message providing the reason why the given name is invalid. ,
Enum:
{
Invalid: No description available. ,
AlreadyExists: No description available. ,
}
,
Required: False ,
}
enum ,
}

⚐ Response (default)

{
error:
{
Description: Error description ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: Internal error details. ,
Required: False ,
}
[
string ,
]
,
}
,
}