This library provides access to the Azure Digital Twins service for managing twins, models, relationships, etc.
Getting startedThe complete Microsoft Azure SDK can be downloaded from the Microsoft Azure downloads page, and it ships with support for building deployment packages, integrating with tooling, rich command line tooling, and more.
For the best development experience, developers should use the official Microsoft NuGet packages for libraries. NuGet packages are regularly updated with new functionality and hotfixes.
Install the packageInstall the Azure Digital Twins client library for .NET with NuGet:
dotnet add package Azure.DigitalTwins.Core
View the package details at nuget.org.
PrerequisitesIn order to interact with the Azure Digital Twins service, you will need to create an instance of a TokenCredential class and pass it to the constructor of your DigitalTwinsClient.
Key conceptsAzure Digital Twins is an Azure IoT service that creates comprehensive models of the physical environment. It can create spatial intelligence graphs to model the relationships and interactions between people, spaces, and devices.
You can learn more about Azure Digital Twins by visiting Azure Digital Twins Documentation
Thread safetyWe guarantee that all client instance methods are thread-safe and independent of each other (guideline). This ensures that the recommendation of reusing client instances is always safe, even across threads.
Additional conceptsClient options | Accessing the response | Long-running operations | Handling failures | Diagnostics | Mocking | Client lifetime
ExamplesYou can familiarize yourself with different APIs using samples for Digital Twins.
Source code folder structure /srcThe Digital Twins public client, DigitalTwinsClient
, and the additional configuration options, DigitalTwinsClientOptions
, that can be sent to the Digital Twins service.
The code generated by autorest using the swagger file defined in the autorest config file.
To regenerate the code, run the powershell script generate.ps1.
Any time the client library code is updated, the following scripts need to be run:
The customzied code written to override the following behavior of auto-generated code:
Model classes useful for use with the Digital Twins client operations.
/src/PropertiesAssembly properties required for running unit tests.
/src/SerializationSerialization helpers provided to help serialize/deserialize commonly used types within the Digital Twins service.
TroubleshootingAll service operations will throw RequestFailedException on failure reported by the service, with helpful error codes and other information.
For example, use the GetModelAsync
operation to check if the model exists before creating it, catch only when that specific HttpStatusCode is specified.
try
{
Response<ModelData> desiredModel = await DigitalTwinsClient.GetModelAsync(desiredModelId);
}
catch (RequestFailedException ex) when (ex.Status == (int)HttpStatusCode.NotFound)
{
// Model does not exist, so create it.
}
Next steps
See implementation examples with our code samples.
ContributingThis project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4