Skip to content

Commit ab54b1b

Browse files
committed
Update docs metadata
1 parent 646601b commit ab54b1b

File tree

2 files changed

+52
-19
lines changed

2 files changed

+52
-19
lines changed

api/overview/azure/preview/communication.phonenumbers-readme.md

Lines changed: 47 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: Azure Communication Phone Numbers client library for .NET
33
keywords: Azure, dotnet, SDK, API, Azure.Communication.PhoneNumbers, communication
4-
ms.date: 07/22/2025
4+
ms.date: 07/31/2025
55
ms.topic: reference
66
ms.devlang: dotnet
77
ms.service: communication
88
---
9-
# Azure Communication Phone Numbers client library for .NET - version 1.5.0-beta.1
9+
# Azure Communication Phone Numbers client library for .NET - version 1.5.0-beta.2
1010

1111

1212
Azure Communication Phone Numbers is managing phone numbers for Azure Communication Services.
@@ -102,7 +102,7 @@ Reservations represent a collection of phone numbers that are locked by a specif
102102

103103
### SIP routing client
104104

105-
Direct routing feature allows connecting customer-provided telephony infrastructure to Azure Communication Resources. In order to setup routing configuration properly, customer needs to supply the SIP trunk configuration and SIP routing rules for calls. SIP routing client provides the necessary interface for setting this configuration.
105+
Direct routing feature allows connecting customer-provided telephony infrastructure to Azure Communication Resources. In order to setup routing configuration properly, customer needs to supply the SIP domains configuration, the SIP trunk configuration and SIP routing rules for calls. SIP routing client provides the necessary interface for setting this configuration.
106106

107107
When a call is made, the system tries to match the destination number with regex number patterns of defined routes. The first route to match the number will be selected. The order of regex matching is the same as the order of routes in configuration, therefore the order of routes matters.
108108
Once a route is matched, the call is routed to the first trunk in the route's trunks list. If the trunk is not available, next trunk in the list is selected.
@@ -112,11 +112,11 @@ We guarantee that all client instance methods are thread-safe and independent of
112112

113113
### Additional concepts
114114
<!-- CLIENT COMMON BAR -->
115-
[Client options](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.1/sdk/core/Azure.Core/README.md#configuring-service-clients-using-clientoptions) |
116-
[Accessing the response](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.1/sdk/core/Azure.Core/README.md#accessing-http-response-details-using-responset) |
117-
[Long-running operations](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.1/sdk/core/Azure.Core/README.md#consuming-long-running-operations-using-operationt) |
118-
[Handling failures](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.1/sdk/core/Azure.Core/README.md#reporting-errors-requestfailedexception) |
119-
[Diagnostics](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.1/sdk/core/Azure.Core/samples/Diagnostics.md) |
115+
[Client options](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.2/sdk/core/Azure.Core/README.md#configuring-service-clients-using-clientoptions) |
116+
[Accessing the response](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.2/sdk/core/Azure.Core/README.md#accessing-http-response-details-using-responset) |
117+
[Long-running operations](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.2/sdk/core/Azure.Core/README.md#consuming-long-running-operations-using-operationt) |
118+
[Handling failures](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.2/sdk/core/Azure.Core/README.md#reporting-errors-requestfailedexception) |
119+
[Diagnostics](https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.2/sdk/core/Azure.Core/samples/Diagnostics.md) |
120120
[Mocking](https://learn.microsoft.com/dotnet/azure/sdk/unit-testing-mocking) |
121121
[Client lifetime](https://devblogs.microsoft.com/azure-sdk/lifetime-management-and-thread-safety-guarantees-of-azure-sdk-net-clients/)
122122
<!-- CLIENT COMMON BAR -->
@@ -230,28 +230,60 @@ await purchaseReservationOperation.WaitForCompletionResponseAsync();
230230

231231
### SipRoutingClient
232232

233-
#### Retrieve SIP trunks and routes
233+
#### Retrieve SIP domains, trunks and routes
234234

235-
Get the list of currently configured trunks or routes.
235+
Get the list of currently configured domains, trunks or routes.
236236

237237
```C# Snippet:RetrieveListAsync
238+
var domainsResponse = await client.GetDomainsAsync();
238239
var trunksResponse = await client.GetTrunksAsync();
239240
var routesResponse = await client.GetRoutesAsync();
240241
```
241242

242-
#### Replace SIP trunks and routes
243+
#### Replace SIP domains, trunks and routes
243244

244-
Replace the list of currently configured trunks or routes.
245+
Replace the list of currently configured domains, trunks or routes.
245246

246247
```C# Snippet:ReplaceAsync
247248
// The service will not allow trunks that are used in any of the routes to be deleted, therefore first set the routes as empty list, and then update the routes.
249+
var newDomains = "<new_domains_list>";
248250
var newTrunks = "<new_trunks_list>";
249251
var newRoutes = "<new_routes_list>";
250252
await client.SetRoutesAsync(new List<SipTrunkRoute>());
253+
await client.SetDomainsAsync(newDomains);
251254
await client.SetTrunksAsync(newTrunks);
252255
await client.SetRoutesAsync(newRoutes);
253256
```
254257

258+
#### Manage single domain
259+
260+
SIP domains can be managed separately by using the `SipRoutingClient` to retrieve, set or delete a single domain.
261+
262+
#### Retrieve single domain
263+
264+
```C# Snippet:RetrieveDomainAsync
265+
// Get domain object, based on it's FQDN.
266+
var domainFqdnToRetrieve = "<domain_fqdn>";
267+
var domainResponse = await client.GetDomainAsync(domainFqdnToRetrieve);
268+
```
269+
270+
#### Set single domain
271+
272+
```C# Snippet:SetDomainAsync
273+
// Set function will either modify existing item or add new item to the collection.
274+
// The domain is matched based on it's FQDN.
275+
var domainToSet = "<domain_to_set>";
276+
await client.SetDomainAsync(domainToSet);
277+
```
278+
279+
#### Delete single domain
280+
281+
```C# Snippet:DeleteDomainAsync
282+
// Deletes domain with supplied FQDN.
283+
var domainFqdnToDelete = "<domain_fqdn>";
284+
await client.DeleteDomainAsync(domainFqdnToDelete);
285+
```
286+
255287
#### Manage single trunk
256288

257289
SIP trunks can be managed separately by using the `SipRoutingClient` to retrieve, set or delete a single trunk.
@@ -263,6 +295,7 @@ SIP trunks can be managed separately by using the `SipRoutingClient` to retrieve
263295
var fqdnToRetrieve = "<fqdn>";
264296
var trunkResponse = await client.GetTrunkAsync(fqdnToRetrieve);
265297
```
298+
266299
#### Set single trunk
267300

268301
```C# Snippet:SetTrunkAsync
@@ -299,8 +332,8 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m
299332
[azure_sub]: https://azure.microsoft.com/free/dotnet/
300333
[azure_portal]: https://portal.azure.com
301334
[azure_identity]: https://learn.microsoft.com/dotnet/api/azure.identity?view=azure-dotnet
302-
[source]: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Communication.PhoneNumbers_1.5.0-beta.1/sdk/communication/Azure.Communication.PhoneNumbers/src
303-
[source_samples]: https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.1/sdk/communication/Azure.Communication.PhoneNumbers/samples
335+
[source]: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Communication.PhoneNumbers_1.5.0-beta.2/sdk/communication/Azure.Communication.PhoneNumbers/src
336+
[source_samples]: https://github.com/Azure/azure-sdk-for-net/blob/Azure.Communication.PhoneNumbers_1.5.0-beta.2/sdk/communication/Azure.Communication.PhoneNumbers/samples
304337
[cla]: https://cla.microsoft.com
305338
[coc]: https://opensource.microsoft.com/codeofconduct/
306339
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/

metadata/preview/Azure.Communication.PhoneNumbers.json

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"Name": "Azure.Communication.PhoneNumbers",
3-
"Version": "1.5.0-beta.1",
3+
"Version": "1.5.0-beta.2",
44
"DevVersion": null,
55
"DirectoryPath": "sdk/communication/Azure.Communication.PhoneNumbers",
66
"ServiceDirectory": "communication",
@@ -10,21 +10,21 @@
1010
"SdkType": "client",
1111
"IsNewSdk": true,
1212
"ArtifactName": "Azure.Communication.PhoneNumbers",
13-
"ReleaseStatus": "2025-07-22",
13+
"ReleaseStatus": "2025-08-01",
1414
"IncludedForValidation": false,
1515
"AdditionalValidationPackages": null,
1616
"ArtifactDetails": {
17+
"safeName": "AzureCommunicationPhoneNumbers",
1718
"triggeringPaths": [
1819
"/sdk/communication/ci.yml"
1920
],
20-
"safeName": "AzureCommunicationPhoneNumbers",
2121
"name": "Azure.Communication.PhoneNumbers"
2222
},
2323
"CIParameters": {
2424
"BuildSnippets": false,
25+
"CheckAOTCompat": false,
2526
"CIMatrixConfigs": [],
26-
"AOTTestInputs": [],
27-
"CheckAOTCompat": false
27+
"AOTTestInputs": []
2828
},
2929
"Namespaces": [
3030
"Azure.Communication.PhoneNumbers",

0 commit comments

Comments
 (0)