Skip to content

Commit

Permalink
feat(adt): track2 control plane SDK (#12880)
Browse files Browse the repository at this point in the history
  • Loading branch information
David R. Williamson authored and prmathur-microsoft committed Jul 8, 2020
1 parent 9751105 commit 117b395
Show file tree
Hide file tree
Showing 72 changed files with 7,907 additions and 1 deletion.
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 16
VisualStudioVersion = 16.0.30204.135
MinimumVisualStudioVersion = 15.0.26124.0
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Azure.ResourceManager.DigitalTwins", "src\Azure.ResourceManager.DigitalTwins.csproj", "{3E14F9B0-C6D2-4660-9209-987A3D171A7F}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Azure.ResourceManager.DigitalTwins.Tests", "tests\Azure.ResourceManager.DigitalTwins.Tests.csproj", "{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Azure.Core", "..\..\core\Azure.Core\src\Azure.Core.csproj", "{355F35B5-7B40-4993-8BE3-60E0236CB2FB}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Azure.Core.TestFramework", "..\..\core\Azure.Core.TestFramework\src\Azure.Core.TestFramework.csproj", "{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
Debug|x64 = Debug|x64
Debug|x86 = Debug|x86
Release|Any CPU = Release|Any CPU
Release|x64 = Release|x64
Release|x86 = Release|x86
EndGlobalSection
GlobalSection(ProjectConfigurationPlatforms) = postSolution
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Debug|Any CPU.Build.0 = Debug|Any CPU
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Debug|x64.ActiveCfg = Debug|Any CPU
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Debug|x64.Build.0 = Debug|Any CPU
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Debug|x86.ActiveCfg = Debug|Any CPU
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Debug|x86.Build.0 = Debug|Any CPU
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Release|Any CPU.ActiveCfg = Release|Any CPU
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Release|Any CPU.Build.0 = Release|Any CPU
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Release|x64.ActiveCfg = Release|Any CPU
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Release|x64.Build.0 = Release|Any CPU
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Release|x86.ActiveCfg = Release|Any CPU
{3E14F9B0-C6D2-4660-9209-987A3D171A7F}.Release|x86.Build.0 = Release|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Debug|Any CPU.Build.0 = Debug|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Debug|x64.ActiveCfg = Debug|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Debug|x64.Build.0 = Debug|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Debug|x86.ActiveCfg = Debug|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Debug|x86.Build.0 = Debug|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Release|Any CPU.ActiveCfg = Release|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Release|Any CPU.Build.0 = Release|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Release|x64.ActiveCfg = Release|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Release|x64.Build.0 = Release|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Release|x86.ActiveCfg = Release|Any CPU
{6E2E01B4-3E7C-4CFE-8968-6C4113F29536}.Release|x86.Build.0 = Release|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Debug|Any CPU.Build.0 = Debug|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Debug|x64.ActiveCfg = Debug|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Debug|x64.Build.0 = Debug|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Debug|x86.ActiveCfg = Debug|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Debug|x86.Build.0 = Debug|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Release|Any CPU.ActiveCfg = Release|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Release|Any CPU.Build.0 = Release|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Release|x64.ActiveCfg = Release|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Release|x64.Build.0 = Release|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Release|x86.ActiveCfg = Release|Any CPU
{355F35B5-7B40-4993-8BE3-60E0236CB2FB}.Release|x86.Build.0 = Release|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Debug|Any CPU.Build.0 = Debug|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Debug|x64.ActiveCfg = Debug|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Debug|x64.Build.0 = Debug|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Debug|x86.ActiveCfg = Debug|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Debug|x86.Build.0 = Debug|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Release|Any CPU.ActiveCfg = Release|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Release|Any CPU.Build.0 = Release|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Release|x64.ActiveCfg = Release|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Release|x64.Build.0 = Release|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Release|x86.ActiveCfg = Release|Any CPU
{6A0368A7-EBE7-426E-9793-F1B37BA04C5B}.Release|x86.Build.0 = Release|Any CPU
EndGlobalSection
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
EndGlobalSection
GlobalSection(ExtensibilityGlobals) = postSolution
SolutionGuid = {3352FF85-41F6-4C34-B700-C73A55858E8B}
EndGlobalSection
EndGlobal
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Release History

## 1.0.0-preview.1

### New features

- Public preview, track2, control plane SDK library for Azure Digital Twins service.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<!--
Add any shared properties you want for the projects under this package directory that need to be set before the auto imported Directory.Build.props
-->
<Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory).., Directory.Build.props))\Directory.Build.props" />
<Import Condition="'$(IsMgmtClientLibrary)' == 'true'" Project="$(RepoRoot)/sdk/core/Azure.Core/src/Azure.Core.props" />
</Project>
88 changes: 88 additions & 0 deletions sdk/digitaltwins/Azure.ResourceManager.DigitalTwins/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
# Azure Digital Twins management client library for .NET

Azure Digital Twins is a developer platform for next-generation IoT solutions that lets you create, run, and manage digital representations of your business environment, securely and efficiently in the cloud.

Use the client library for Digital Twins to:

- Digital twins instances
- Digital twins endpoints

[Source code][source] | [Package (NuGet)][adt_nuget] | [API reference documentation][TODO] | [Product documentation][digital_twins_documentation]

## Getting started

### Install the package

Install the Azure Digital Twins management library for .NET with NuGet:

```console
Install-Package Azure.ResourceMnager.DigitalTwins
```

### Prerequisites

- A Microsoft Azure Subscription
- To call Microsoft Azure services, create an [Azure subscription][azure_sub].

### Authenticate the client

In order to interact with the Azure Digital Twins service, you will need to create an instance of a [TokenCredential class][token_credential] and pass it to the constructor of your [DigitalTwinsClient][digital_twins_client].

## Key concepts

Azure Digital Twins Preview 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][digital_twins_documentation]

## Examples

TODO

* [Create the thing](#create-the-thing)
* [Get the thing](#get-the-thing)
* [List the things](#list-the-things)

### Create the thing

Use the [create_thing](not-valid-link) method to create a Thing reference; this method does not make a network call. To persist the Thing in the service, call [Thing.save](not-valid-link).

### Get the thing

The [get_thing](not-valid-link) method retrieves a Thing from the service. The `id` parameter is the unique ID of the Thing, not its "name" property.

## Troubleshooting

All service operations will throw RequestFailedException on failure reported by the service, with helpful error codes and other information.

## Next steps

TODO

* Provide a link to additional code examples, ideally to those sitting alongside the README in the package's `/samples` directory.
* If appropriate, point users to other packages that might be useful.
* If you think there's a good chance that developers might stumble across your package in error (because they're searching for specific functionality and mistakenly think the package provides that functionality), point them to the packages they might be looking for.

## Contributing

This 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][code_of_conduct].
For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

<!-- LINKS -->
[azure_sub]: https://azure.microsoft.com/free/
[source]: https://github.com/Azure/azure-sdk-for-net/tree/master/digitaltwins/Azure.ResourceManager.DigitalTwins
[package]: https://www.nuget.org/packages/Azure.DigitalTwins.Core
[code_of_conduct]: https://opensource.microsoft.com/codeofconduct/
[token_credential]: https://docs.microsoft.com/en-us/dotnet/api/azure.core.tokencredential?view=azure-dotnet
[digital_twins_documentation]: https://docs.microsoft.com/en-us/azure/digital-twins/
[adt_nuget]: https://www.nuget.org/packages/Azure.ResourceManager.DigitalTwins

![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-net%2Fsdk%2Fdigitaltwins%2FAzure.ResourceManager.DigitalTwins%2FREADME.md)
Loading

0 comments on commit 117b395

Please sign in to comment.