Skip to content

Commit c7f3ba0

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into rolyon-rbac-role-assignments-portal-classic
2 parents b3ee5c6 + 75bd5dc commit c7f3ba0

14 files changed

+55
-51
lines changed

articles/azure-video-indexer/textless-slate-scene-matching.md

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -21,11 +21,6 @@ In order to set the indexing process to include the slate metadata, select the *
2121
> [!div class="mx-imgBorder"]
2222
> :::image type="content" source="./media/slate-detection-process/advanced-setting.png" alt-text="This image shows the advanced setting in order to view post-production clapperboards insights.":::
2323
24-
After the file has been uploaded and indexed, if you want to view the timeline of the insight, select the **Post-production** checkmark from the list of insights.
25-
26-
> [!div class="mx-imgBorder"]
27-
> :::image type="content" source="./media/slate-detection-process/post-production-checkmark.png" alt-text="This image shows the post-production checkmark needed to view clapperboards.":::
28-
2924
### Insight
3025

3126
This insight can only be viewed in the form of the downloaded json file.
25.9 KB
Loading
Binary file not shown.

articles/communication-services/concepts/rooms/room-concept.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ Use rooms when you need any of the following capabilities:
5858

5959
The picture below illustrates the concept of managing and joining the rooms.
6060

61-
:::image type="content" source="../media/rooms/rooms-management.png" alt-text="Diagram showing Rooms Management.":::
61+
:::image type="content" source="../media/rooms/rooms-join-call.png" alt-text="Diagram showing Rooms Management.":::
6262

6363
### Rooms API/SDKs
6464

articles/digital-twins/concepts-event-notifications.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ titleSuffix: Azure Digital Twins
55
description: Learn to interpret various event types and their different notification messages.
66
author: baanders
77
ms.author: baanders # Microsoft employees only
8-
ms.date: 03/01/2022
8+
ms.date: 09/20/2022
99
ms.topic: conceptual
1010
ms.service: digital-twins
1111
ms.custom: contperf-fy21q4
@@ -106,7 +106,8 @@ The data in the corresponding notification (if synchronously executed by the ser
106106
}
107107
```
108108

109-
This data is the information that will go in the `data` field of the lifecycle notification message.
109+
>[!NOTE]
110+
> Azure Digital Twins currently doesn't support [filtering events](how-to-manage-routes.md#filter-events) based on fields within an array. This includes filtering on properties within a `patch` section of a digital twin change notification.
110111
111112
## Digital twin lifecycle notifications
112113

@@ -274,7 +275,7 @@ Here's an example of the data for a create or delete relationship notification.
274275

275276
## Digital twin telemetry messages
276277

277-
*Telemetry messages* are received in Azure Digital Twins from connected devices that collect and send measurements.
278+
Digital twins can use the [SendTelemetry API](/rest/api/digital-twins/dataplane/twins/digitaltwins_sendtelemetry) to emit *telemetry messages* and send them to egress endpoints.
278279

279280
### Properties
280281

@@ -283,17 +284,17 @@ Here are the fields in the body of a telemetry message.
283284
| Name | Value |
284285
| --- | --- |
285286
| `id` | Identifier of the notification, which is provided by the customer when calling the telemetry API. |
286-
| `source` | Fully qualified name of the twin that the telemetry event was sent to. Uses the following format: `<your-Digital-Twin-instance>.api.<your-region>.digitaltwins.azure.net/<twin-ID>`. |
287+
| `source` | Fully qualified name of the twin that the telemetry event was sent from. Uses the following format: `<your-Digital-Twin-instance>.api.<your-region>.digitaltwins.azure.net/<twin-ID>`. |
287288
| `specversion` | *1.0*<br>The message conforms to this version of the [CloudEvents spec](https://github.com/cloudevents/spec). |
288289
| `type` | `microsoft.iot.telemetry` |
289-
| `data` | The telemetry message that has been sent to twins. The payload is unmodified and may not align with the schema of the twin that has been sent the telemetry. |
290+
| `data` | The telemetry message being sent from the twin. The payload does not need to align with any schema defined in your Azure Digital Twins instance. |
290291
| `dataschema` | The data schema is the model ID of the twin or the component that emits the telemetry. For example, `dtmi:example:com:floor4;2`. |
291292
| `datacontenttype` | `application/json` |
292293
| `traceparent` | A W3C trace context for the event. |
293294

294295
### Body details
295296

296-
The body contains the telemetry measurement along with some contextual information about the device.
297+
The body contains the telemetry measurement along with some contextual information about the twin.
297298

298299
Here's an example telemetry message body:
299300

articles/service-bus-messaging/service-bus-performance-improvements.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Best practices for improving performance using Azure Service Bus
33
description: Describes how to use Service Bus to optimize performance when exchanging brokered messages.
44
ms.topic: article
5-
ms.date: 02/16/2022
5+
ms.date: 09/28/2022
66
ms.devlang: csharp
77
---
88

@@ -14,15 +14,15 @@ Throughout this article, the term "client" refers to any entity that accesses Se
1414

1515
## Resource planning and considerations
1616

17-
As with any technical resourcing, prudent planning is key in ensuring that Azure Service Bus is providing the performance that your application expects. The right configuration or topology for your Service Bus namespaces depends on a host of factors involving your application architecture and how each of the Service Bus features are used.
17+
As with any technical resourcing, prudent planning is key in ensuring that Azure Service Bus is providing the performance that your application expects. The right configuration or topology for your Service Bus namespaces depends on a host of factors involving your application architecture and how each of the Service Bus features is used.
1818

1919
### Pricing tier
2020

21-
Service Bus offers various pricing tiers. It is recommended to pick the appropriate tier for your application requirements.
21+
Service Bus offers various pricing tiers. It's recommended to pick the appropriate tier for your application requirements.
2222

2323
* **Standard tier** - Suited for developer/test environments or low throughput scenarios where the applications are **not sensitive** to throttling.
2424

25-
* **Premium tier** - Suited for production environments with varied throughput requirements where predictable latency and throughput is required. Additionally, Service Bus premium namespaces can be [auto scaled](automate-update-messaging-units.md) and can be enabled to accommodate spikes in throughput.
25+
* **Premium tier** - Suited for production environments with varied throughput requirements where predictable latency and throughput are required. Additionally, Service Bus premium namespaces can be [auto scaled](automate-update-messaging-units.md) and can be enabled to accommodate spikes in throughput.
2626

2727
> [!NOTE]
2828
> If the right tier is not picked, there is a risk of overwhelming the Service Bus namespace which may lead to [throttling](service-bus-throttling.md).
@@ -40,7 +40,7 @@ As expected, throughput is higher for smaller message payloads that can be batch
4040

4141
#### Benchmarks
4242

43-
Here is a [GitHub sample](https://github.com/Azure-Samples/service-bus-dotnet-messaging-performance) which you can run to see the expected throughput you will receive for your SB namespace. In our [benchmark tests](https://techcommunity.microsoft.com/t5/Service-Bus-blog/Premium-Messaging-How-fast-is-it/ba-p/370722), we observed approximately 4 MB/second per Messaging Unit (MU) of ingress and egress.
43+
Here's a [GitHub sample](https://github.com/Azure-Samples/service-bus-dotnet-messaging-performance) which you can run to see the expected throughput you'll receive for your SB namespace. In our [benchmark tests](https://techcommunity.microsoft.com/t5/Service-Bus-blog/Premium-Messaging-How-fast-is-it/ba-p/370722), we observed approximately 4 MB/second per Messaging Unit (MU) of ingress and egress.
4444

4545
The benchmarking sample doesn't use any advanced features, so the throughput your applications observe will be different based on your scenarios.
4646

@@ -57,7 +57,7 @@ Using certain Service Bus features may require compute utilization that may decr
5757
7. De-duplication & look back time window.
5858
8. Forward to (forwarding from one entity to another).
5959

60-
If your application leverages any of the above features and you are not receiving the expected throughput, you can review the **CPU usage** metrics and consider scaling up your Service Bus Premium namespace.
60+
If your application leverages any of the above features and you aren't receiving the expected throughput, you can review the **CPU usage** metrics and consider scaling up your Service Bus Premium namespace.
6161

6262
You can also utilize Azure Monitor to [automatically scale the Service Bus namespace](automate-update-messaging-units.md).
6363

@@ -241,7 +241,7 @@ To increase the throughput of a queue, topic, or subscription, Service Bus batch
241241
242242
Additional store operations that occur during this interval are added to the batch. Batched store access only affects **Send** and **Complete** operations; receive operations aren't affected. Batched store access is a property on an entity. Batching occurs across all entities that enable batched store access.
243243

244-
When creating a new queue, topic or subscription, batched store access is enabled by default.
244+
When you create a new queue, topic or subscription, batched store access is enabled by default.
245245

246246

247247
# [Azure.Messaging.ServiceBus SDK](#tab/net-standard-sdk-2)
@@ -283,7 +283,7 @@ Batched store access doesn't affect the number of billable messaging operations.
283283

284284
When a message is prefetched, the service locks the prefetched message. With the lock, the prefetched message can't be received by a different receiver. If the receiver can't complete the message before the lock expires, the message becomes available to other receivers. The prefetched copy of the message remains in the cache. The receiver that consumes the expired cached copy will receive an exception when it tries to complete that message. By default, the message lock expires after 60 seconds. This value can be extended to 5 minutes. To prevent the consumption of expired messages, set the cache size smaller than the number of messages that a client can consume within the lock timeout interval.
285285

286-
When using the default lock expiration of 60 seconds, a good value for `PrefetchCount` is 20 times the maximum processing rates of all receivers of the factory. For example, a factory creates three receivers, and each receiver can process up to 10 messages per second. The prefetch count shouldn't exceed 20 X 3 X 10 = 600. By default, `PrefetchCount` is set to 0, which means that no additional messages are fetched from the service.
286+
When you use the default lock expiration of 60 seconds, a good value for `PrefetchCount` is 20 times the maximum processing rates of all receivers of the factory. For example, a factory creates three receivers, and each receiver can process up to 10 messages per second. The prefetch count shouldn't exceed 20 X 3 X 10 = 600. By default, `PrefetchCount` is set to 0, which means that no additional messages are fetched from the service.
287287

288288
Prefetching messages increases the overall throughput for a queue or subscription because it reduces the overall number of message operations, or round trips. Fetching the first message, however, will take longer (because of the increased message size). Receiving prefetched messages from the cache will be faster because these messages have already been downloaded by the client.
289289

@@ -320,10 +320,14 @@ While using these approaches together, consider the following cases -
320320

321321
There are some challenges with having a greedy approach, that is, keeping the prefetch count high, because it implies that the message is locked to a particular receiver. The recommendation is to try out prefetch values between the thresholds mentioned above and empirically identify what fits.
322322

323-
## Multiple queues
323+
## Multiple queues or topics
324324

325325
If a single queue or topic can't handle the expected, use multiple messaging entities. When using multiple entities, create a dedicated client for each entity, instead of using the same client for all entities.
326326

327+
More queues or topics mean that you have more entities to manage at deployment time. From a scalability perspective, there really isn't too much of a difference that you would notice as Service Bus already spreads the load across multiple logs internally, so if you use six queues or topics or two queues or topics won't make a material difference.
328+
329+
The tier of service you use impacts performance predictability. If you choose **Standard** tier, throughput and latency are best effort over a shared multi-tenant infrastructure. Other tenants on the same cluster may impact your throughput. If you choose **Premium**, you get resources that give you predictable performance, and your multiple queues or topics get processed out of that resource pool. For more information, see [Pricing tiers](#pricing-tier).
330+
327331
## Scenarios
328332

329333
The following sections describe typical messaging scenarios and outline the preferred Service Bus settings. Throughput rates are classified as small (less than 1 message/second), moderate (1 message/second or greater but less than 100 messages/second) and high (100 messages/second or greater). The number of clients are classified as small (5 or fewer), moderate (more than 5 but less than or equal to 20), and large (more than 20).
@@ -398,7 +402,7 @@ To maximize throughput, follow these guidelines:
398402

399403
Goal: Maximize the throughput of a topic with a large number of subscriptions. A message is received by many subscriptions, which means the combined receive rate over all subscriptions is much larger than the send rate. The number of senders is small. The number of receivers per subscription is small.
400404

401-
Topics with a large number of subscriptions typically expose a low overall throughput if all messages are routed to all subscriptions. It's because each message is received many times, and all messages in a topic and all its subscriptions are stored in the same store. The assumption here is that the number of senders and number of receivers per subscription is small. Service Bus supports up to 2,000 subscriptions per topic.
405+
Topics with a large number of subscriptions typically expose a low overall throughput if all messages are routed to all subscriptions. It's because each message is received many times, and all messages in a topic and all its subscriptions are stored in the same store. The assumption here's that the number of senders and number of receivers per subscription is small. Service Bus supports up to 2,000 subscriptions per topic.
402406

403407
To maximize throughput, try the following steps:
404408

articles/service-bus-messaging/service-bus-transactions.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Overview of transaction processing in Azure Service Bus
33
description: This article gives you an overview of transaction processing and the send via feature in Azure Service Bus.
44
ms.topic: article
5-
ms.date: 03/21/2022
5+
ms.date: 09/28/2022
66
ms.devlang: csharp
77
ms.custom: devx-track-csharp
88
---
@@ -12,7 +12,8 @@ ms.custom: devx-track-csharp
1212
This article discusses the transaction capabilities of Microsoft Azure Service Bus. Much of the discussion is illustrated by the [AMQP Transactions with Service Bus sample](https://github.com/Azure/azure-service-bus/tree/master/samples/DotNet/Microsoft.Azure.ServiceBus/TransactionsAndSendVia/TransactionsAndSendVia/AMQPTransactionsSendVia). This article is limited to an overview of transaction processing and the *send via* feature in Service Bus, while the Atomic Transactions sample is broader and more complex in scope.
1313

1414
> [!NOTE]
15-
> The basic tier of Service Bus doesn't support transactions. The standard and premium tiers support transactions. For differences between these tiers, see [Service Bus pricing](https://azure.microsoft.com/pricing/details/service-bus/).
15+
> - The basic tier of Service Bus doesn't support transactions. The standard and premium tiers support transactions. For differences between these tiers, see [Service Bus pricing](https://azure.microsoft.com/pricing/details/service-bus/).
16+
> - Mixing management and messaging operations in a transaction isn't supported.
1617
1718
## Transactions in Service Bus
1819

articles/storage/blobs/storage-auth-abac-attributes.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
---
2-
title: Actions and attributes for Azure role assignment conditions in Azure Storage
2+
title: Actions and attributes for Azure role assignment conditions for Azure Blob Storage
33
titleSuffix: Azure Storage
4-
description: Supported actions and attributes for Azure role assignment conditions and Azure attribute-based access control (Azure ABAC) in Azure Storage.
4+
description: Supported actions and attributes for Azure role assignment conditions and Azure attribute-based access control (Azure ABAC) for Azure Blob Storage.
55
services: storage
66
author: jimmart-dev
77

88
ms.service: storage
99
ms.topic: conceptual
10-
ms.date: 09/14/2022
10+
ms.date: 09/28/2022
1111
ms.author: jammart
1212
ms.reviewer: nachakra
1313
ms.subservice: blobs
1414
---
1515

16-
# Actions and attributes for Azure role assignment conditions in Azure Storage (preview)
16+
# Actions and attributes for Azure role assignment conditions for Azure Blob Storage (preview)
1717

1818
> [!IMPORTANT]
1919
> Azure ABAC and Azure role assignment conditions are currently in preview.
@@ -47,9 +47,9 @@ In this preview, storage accounts support the following suboperations:
4747
> | [Sets the access tier on a blob](#sets-the-access-tier-on-a-blob) | `Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write` | `Blob.Write.Tier` |
4848
> | [Write to a blob with blob index tags](#write-to-a-blob-with-blob-index-tags) | `Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write` <br/> `Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action` | `Blob.Write.WithTagHeaders` |
4949
50-
## Azure Blob storage actions and suboperations
50+
## Azure Blob Storage actions and suboperations
5151

52-
This section lists the supported Azure Blob storage actions and suboperations you can target for conditions.
52+
This section lists the supported Azure Blob Storage actions and suboperations you can target for conditions.
5353

5454
### List blobs
5555

@@ -295,9 +295,9 @@ This section lists the supported Azure Blob storage actions and suboperations yo
295295
> | **Examples** | [Example: Read, write, or delete blobs in named containers](storage-auth-abac-examples.md#example-read-write-or-delete-blobs-in-named-containers)<br/>[Example: Read blobs in named containers with a path](storage-auth-abac-examples.md#example-read-blobs-in-named-containers-with-a-path)<br/>[Example: Read or list blobs in named containers with a path](storage-auth-abac-examples.md#example-read-or-list-blobs-in-named-containers-with-a-path)<br/>[Example: Write blobs in named containers with a path](storage-auth-abac-examples.md#example-write-blobs-in-named-containers-with-a-path)<br/>[Example: Read only current blob versions](storage-auth-abac-examples.md#example-read-only-current-blob-versions)<br/>[Example: Read current blob versions and any blob snapshots](storage-auth-abac-examples.md#example-read-current-blob-versions-and-any-blob-snapshots)<br/>[Example: Read only storage accounts with hierarchical namespace enabled](storage-auth-abac-examples.md#example-read-only-storage-accounts-with-hierarchical-namespace-enabled) |
296296
> | **Learn more** | [Azure Data Lake Storage Gen2 hierarchical namespace](../blobs/data-lake-storage-namespace.md) |
297297
298-
## Azure Blob storage attributes
298+
## Azure Blob Storage attributes
299299

300-
This section lists the Azure Blob storage attributes you can use in your condition expressions depending on the action you target. If you select multiple actions for a single condition, there might be fewer attributes to choose from for your condition because the attributes must be available across the selected actions.
300+
This section lists the Azure Blob Storage attributes you can use in your condition expressions depending on the action you target. If you select multiple actions for a single condition, there might be fewer attributes to choose from for your condition because the attributes must be available across the selected actions.
301301

302302
> [!NOTE]
303303
> Attributes and values listed are considered case-insensitive, unless stated otherwise.

0 commit comments

Comments
 (0)