Skip to content

Commit bfe7bf3

Browse files
authored
Merge pull request #220807 from baanders/12-7-links
ADT: Update C# SDK links
2 parents 01d0f16 + 160f4a7 commit bfe7bf3

14 files changed

+23
-23
lines changed

articles/digital-twins/TOC.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -164,13 +164,13 @@
164164
- name: Control plane
165165
items:
166166
- name: .NET (C#) SDK
167-
href: /dotnet/api/overview/azure/digitaltwins/management?view=azure-dotnet&preserve-view=true
167+
href: /dotnet/api/overview/azure/digitaltwins
168168
- name: Java SDK
169169
href: /java/api/com.azure.resourcemanager.digitaltwins
170170
- name: Data plane
171171
items:
172172
- name: .NET (C#) SDK
173-
href: /dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true
173+
href: /dotnet/api/overview/azure/digitaltwins.core-readme
174174
- name: Java SDK
175175
href: /java/api/overview/azure/digital-twins
176176
- name: JavaScript SDK
@@ -224,9 +224,9 @@
224224
- name: Control plane Swagger
225225
href: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable
226226
- name: .NET (C#) SDK - NuGet
227-
href: https://www.nuget.org/packages/Microsoft.Azure.Management.DigitalTwins/
227+
href: https://www.nuget.org/packages/Azure.ResourceManager.DigitalTwins
228228
- name: .NET (C#) SDK - Source code
229-
href: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/digitaltwins/Microsoft.Azure.Management.DigitalTwins
229+
href: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/digitaltwins/Azure.ResourceManager.DigitalTwins
230230
- name: Java SDK - Maven
231231
href: https://search.maven.org/search?q=a:azure-mgmt-digitaltwins
232232
- name: Java SDK - Source code

articles/digital-twins/concepts-apis-sdks.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ The control plane APIs are [ARM](../azure-resource-manager/management/overview.m
3131
To use the control plane APIs:
3232
* You can call the APIs directly by referencing the latest Swagger folder in the [control plane Swagger repo](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable). This folder also includes a folder of examples that show the usage.
3333
* You can currently access SDKs for control APIs in...
34-
- [.NET (C#)](https://www.nuget.org/packages/Microsoft.Azure.Management.DigitalTwins/) ([reference [auto-generated]](/dotnet/api/overview/azure/digitaltwins/management?view=azure-dotnet&preserve-view=true)) ([source](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/digitaltwins/Microsoft.Azure.Management.DigitalTwins))
34+
- [.NET (C#)](https://www.nuget.org/packages/Azure.ResourceManager.DigitalTwins) ([reference [auto-generated]](/dotnet/api/overview/azure/digitaltwins)) ([source](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/digitaltwins/Azure.ResourceManager.DigitalTwins))
3535
- [Java](https://search.maven.org/search?q=a:azure-mgmt-digitaltwins) ([reference [auto-generated]](/java/api/overview/azure/digital-twins)) ([source](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/digitaltwins))
3636
- [JavaScript](https://www.npmjs.com/package/@azure/arm-digitaltwins) ([source](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/digitaltwins/arm-digitaltwins))
3737
- [Python](https://pypi.org/project/azure-mgmt-digitaltwins/) ([source](https://github.com/Azure/azure-sdk-for-python/tree/release/v3/sdk/digitaltwins/azure-mgmt-digitaltwins))
@@ -53,7 +53,7 @@ To use the data plane APIs:
5353
- Viewing the [API reference documentation](/rest/api/azure-digitaltwins/).
5454
* You can use the .NET (C#) SDK. To use the .NET SDK...
5555
- You can view and add the package from NuGet: [Azure.DigitalTwins.Core](https://www.nuget.org/packages/Azure.DigitalTwins.Core).
56-
- You can view the [SDK reference documentation](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true).
56+
- You can view the [SDK reference documentation](/dotnet/api/overview/azure/digitaltwins.core-readme).
5757
- You can find the SDK source, including a folder of samples, in GitHub: [Azure IoT Digital Twins client library for .NET](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/digitaltwins/Azure.DigitalTwins.Core).
5858
- You can see detailed information and usage examples by continuing to the [.NET (C#) SDK (data plane)](#net-c-sdk-data-plane) section of this article.
5959
* You can use the Java SDK. To use the Java SDK...
@@ -79,7 +79,7 @@ The Azure Digital Twins .NET (C#) SDK is part of the Azure SDK for .NET. It's op
7979
> For more information on SDK design, see the general [design principles for Azure SDKs](https://azure.github.io/azure-sdk/general_introduction.html) and the specific [.NET design guidelines](https://azure.github.io/azure-sdk/dotnet_introduction.html).
8080
8181
To use the SDK, include the NuGet package `Azure.DigitalTwins.Core` with your project. You'll also need the latest version of the `Azure.Identity` package. In Visual Studio, you can add these packages using the NuGet Package Manager (accessed through **Tools > NuGet Package Manager > Manage NuGet Packages for Solution**). You can also use the .NET command-line tool with the commands found in the NuGet package links below to add these packages to your project:
82-
* [Azure.DigitalTwins.Core](https://www.nuget.org/packages/Azure.DigitalTwins.Core): The package for the [Azure Digital Twins SDK for .NET](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true).
82+
* [Azure.DigitalTwins.Core](https://www.nuget.org/packages/Azure.DigitalTwins.Core): The package for the [Azure Digital Twins SDK for .NET](/dotnet/api/overview/azure/digitaltwins.core-readme).
8383
* [Azure.Identity](https://www.nuget.org/packages/Azure.Identity): The library that provides tools to help with authentication against Azure.
8484

8585
For a detailed walk-through of using the APIs in practice, see [Code a client app](tutorial-code.md).

articles/digital-twins/concepts-route-events.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ The endpoint APIs that are available in control plane are:
7373

7474
To [create an event route](how-to-manage-routes.md#create-an-event-route), you can use the Azure Digital Twins REST APIs, CLI commands, or the Azure portal.
7575

76-
Here's an example of creating an event route within a client application, using the `CreateOrReplaceEventRouteAsync` [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true) call:
76+
Here's an example of creating an event route within a client application, using the `CreateOrReplaceEventRouteAsync` [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins.core-readme) call:
7777

7878
:::code language="csharp" source="~/digital-twins-docs-samples/sdks/csharp/eventRoute_operations.cs" id="CreateEventRoute":::
7979

articles/digital-twins/how-to-authenticate-client.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ After you [set up an Azure Digital Twins instance and authentication](how-to-set
2121

2222
Azure Digital Twins authenticates using [Azure AD Security Tokens based on OAUTH 2.0](../active-directory/develop/security-tokens.md#json-web-tokens-and-claims). To authenticate your SDK, you'll need to get a bearer token with the right permissions to Azure Digital Twins, and pass it along with your API calls.
2323

24-
This article describes how to obtain credentials using the `Azure.Identity` client library. While this article shows code examples in C#, such as what you'd write for the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true), you can use a version of `Azure.Identity` regardless of what SDK you're using (for more on the SDKs available for Azure Digital Twins, see [Azure Digital Twins APIs and SDKs](concepts-apis-sdks.md).
24+
This article describes how to obtain credentials using the `Azure.Identity` client library. While this article shows code examples in C#, such as what you'd write for the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins.core-readme), you can use a version of `Azure.Identity` regardless of what SDK you're using (for more on the SDKs available for Azure Digital Twins, see [Azure Digital Twins APIs and SDKs](concepts-apis-sdks.md).
2525

2626
## Prerequisites
2727

@@ -44,7 +44,7 @@ Three common credential-obtaining methods in `Azure.Identity` are:
4444
* [ManagedIdentityCredential](/dotnet/api/azure.identity.managedidentitycredential?view=azure-dotnet&preserve-view=true) works great in cases where you need [managed identities (MSI)](../active-directory/managed-identities-azure-resources/overview.md), and is a good candidate for working with Azure Functions and deploying to Azure services.
4545
* [InteractiveBrowserCredential](/dotnet/api/azure.identity.interactivebrowsercredential?view=azure-dotnet&preserve-view=true) is intended for interactive applications, and can be used to create an authenticated SDK client.
4646

47-
The rest of this article shows how to use these methods with the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true).
47+
The rest of this article shows how to use these methods with the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins.core-readme).
4848

4949
### Add Azure.Identity to your .NET project
5050

articles/digital-twins/how-to-integrate-logic-apps.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ You also need to complete the following items as part of prerequisite setup. The
4444

4545
This article uses Logic Apps to update a twin in your Azure Digital Twins instance. To continue, you should add at least one twin in your instance.
4646

47-
You can add twins using the [DigitalTwins APIs](/rest/api/digital-twins/dataplane/twins), the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true), or the [Azure Digital Twins CLI](/cli/azure/dt). For detailed steps on how to create twins using these methods, see [Manage digital twins](how-to-manage-twin.md).
47+
You can add twins using the [DigitalTwins APIs](/rest/api/digital-twins/dataplane/twins), the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins.core-readme), or the [Azure Digital Twins CLI](/cli/azure/dt). For detailed steps on how to create twins using these methods, see [Manage digital twins](how-to-manage-twin.md).
4848

4949
You'll need the Twin ID of a twin in your instance that you've created.
5050

articles/digital-twins/how-to-manage-graph.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -199,7 +199,7 @@ Then, **copy the following code** of the runnable sample into your project:
199199
Next, complete the following steps to configure your project code:
200200
1. Add the **Room.json** and **Floor.json** files you downloaded earlier to your project, and replace the `<path-to>` placeholders in the code to tell your program where to find them.
201201
1. Replace the placeholder `<your-instance-hostname>` with your Azure Digital Twins instance's host name.
202-
1. Add two dependencies to your project that will be needed to work with Azure Digital Twins. The first is the package for the [Azure Digital Twins SDK for .NET](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true), and the second provides tools to help with authentication against Azure.
202+
1. Add two dependencies to your project that will be needed to work with Azure Digital Twins. The first is the package for the [Azure Digital Twins SDK for .NET](/dotnet/api/overview/azure/digitaltwins.core-readme), and the second provides tools to help with authentication against Azure.
203203

204204
```cmd/sh
205205
dotnet add package Azure.DigitalTwins.Core

articles/digital-twins/how-to-manage-model.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ Following this method, you can go on to define models for the hospital's wards,
5757

5858
Once models are created, you can upload them to the Azure Digital Twins instance.
5959

60-
When you're ready to upload a model, you can use the following code snippet for the [.NET SDK](/dotnet/api/overview/azure/digitaltwins/management?view=azure-dotnet&preserve-view=true):
60+
When you're ready to upload a model, you can use the following code snippet for the [.NET SDK](/dotnet/api/overview/azure/digitaltwins.core-readme):
6161

6262
:::code language="csharp" source="~/digital-twins-docs-samples/sdks/csharp/model_operations.cs" id="CreateModel":::
6363

articles/digital-twins/how-to-manage-routes.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ ms.service: digital-twins
1717

1818
# Manage endpoints and routes in Azure Digital Twins
1919

20-
This article walks you through the process of creating endpoints and routes using the [Azure portal](https://portal.azure.com), the [REST APIs](/rest/api/azure-digitaltwins/), the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true), and the [Azure Digital Twins CLI](/cli/azure/dt).
20+
This article walks you through the process of creating endpoints and routes using the [Azure portal](https://portal.azure.com), the [REST APIs](/rest/api/azure-digitaltwins/), the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins.core-readme), and the [Azure Digital Twins CLI](/cli/azure/dt).
2121

2222
In Azure Digital Twins, you can route [event notifications](concepts-event-notifications.md) to downstream services or connected compute resources. This process is done by first setting up *endpoints* that can receive the events. You can then create [event routes](concepts-route-events.md) that specify which events generated by Azure Digital Twins are delivered to which endpoints.
2323

@@ -302,7 +302,7 @@ For more information about using the CLI and what commands are available, see [A
302302

303303
# [.NET SDK](#tab/sdk2)
304304

305-
This section shows how to create an event route using the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true).
305+
This section shows how to create an event route using the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins.core-readme).
306306

307307
`CreateOrReplaceEventRouteAsync` is the SDK call that is used to add an event route. Here's an example of its usage:
308308

articles/digital-twins/how-to-manage-twin.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -282,7 +282,7 @@ Then, **copy the following code** of the runnable sample into your project:
282282
Next, complete the following steps to configure your project code:
283283
1. Add the **Room.json** file you downloaded earlier to your project, and replace the `<path-to>` placeholder in the code to tell your program where to find it.
284284
2. Replace the placeholder `<your-instance-hostname>` with your Azure Digital Twins instance's host name.
285-
3. Add two dependencies to your project that will be needed to work with Azure Digital Twins. The first is the package for the [Azure Digital Twins SDK for .NET](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true), and the second provides tools to help with authentication against Azure.
285+
3. Add two dependencies to your project that will be needed to work with Azure Digital Twins. The first is the package for the [Azure Digital Twins SDK for .NET](/dotnet/api/overview/azure/digitaltwins.core-readme), and the second provides tools to help with authentication against Azure.
286286
287287
```cmd/sh
288288
dotnet add package Azure.DigitalTwins.Core

articles/digital-twins/how-to-query-graph.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -233,7 +233,7 @@ Once you've decided on a query string, you execute it by making a call to the [Q
233233

234234
You can call the API directly, or use one of the [SDKs](concepts-apis-sdks.md#overview-data-plane-apis) available for Azure Digital Twins.
235235

236-
The following code snippet illustrates the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins/client?view=azure-dotnet&preserve-view=true) call from a client app:
236+
The following code snippet illustrates the [.NET (C#) SDK](/dotnet/api/overview/azure/digitaltwins.core-readme) call from a client app:
237237

238238
:::code language="csharp" source="~/digital-twins-docs-samples/sdks/csharp/queries.cs" id="RunQuery":::
239239

0 commit comments

Comments
 (0)