Skip to content

Commit c1c971e

Browse files
committed
updated
1 parent 7823296 commit c1c971e

5 files changed

+10
-13
lines changed

articles/event-hubs/get-started-dotnet-standard-send-v2.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@ This section shows how to write a .NET Core console application that receives me
116116
117117
118118
> [!NOTE]
119-
> The following code/sample can be used if the environment you are targeting supports a different version of Storage Blob SDK than those typically available on Azure. For example, if you are running Event Hubs on an Azure Stack Hub version 2002](https://docs.microsoft.com/azure-stack/user/event-hubs-overview), the highest available version for the Storage service is version 2017-11-09. In this case, you will need to use the following code to change the Storage service API version to 2017-11-09. For an example on how to target a specific Storage API version, see [this sample on GitHub](https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/eventhub/Azure.Messaging.EventHubs.Processor/samples/Sample10_RunningWithDifferentStorageVersion.cs). For more information on the Azure Storage service versions supported on Azure Stack Hub, please refer to docs.microsoft.com/en-us/azure-stack/user/azure-stack-acs-differences.
119+
> The following sample code can be used if the environment you are targeting supports a different version of Storage Blob SDK than those typically available on Azure. For example, if you are running [Event Hubs on an Azure Stack Hub version 2002](https://docs.microsoft.com/azure-stack/user/event-hubs-overview), the highest available version for the Storage service is version 2017-11-09. In this case, you will need to add code to target the Storage service API version 2017-11-09. For an example on how to target a specific Storage API version, see [this sample on GitHub](https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/eventhub/Azure.Messaging.EventHubs.Processor/samples/Sample10_RunningWithDifferentStorageVersion.cs). For more information on the Azure Storage service versions supported on Azure Stack Hub, please refer to [Azure Stack Hub storage: Differences and considerations](docs.microsoft.com/en-us/azure-stack/user/azure-stack-acs-differences).
120120
121121
### Create an Azure Storage and a blob container
122122
In this quickstart, you use Azure Storage as the checkpoint store. Follow these steps to create an Azure Storage account.

articles/event-hubs/get-started-java-send-v2.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -138,8 +138,7 @@ Build the program, and ensure that there are no errors. You will run this progra
138138
The code in this tutorial is based on the [EventProcessorClient sample on GitHub](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/eventhubs/azure-messaging-eventhubs/src/samples/java/com/azure/messaging/eventhubs/EventProcessorClientSample.java), which you can examine to see the full working application.
139139

140140
> [!NOTE]
141-
> The following code/sample can be used if the environment you are targeting supports a different version of Storage Blob SDK than those typically available on Azure. For example, if you are running [Event Hubs on an Azure Stack Hub version 2002](https://docs.microsoft.com/azure-stack/user/event-hubs-overview), the highest available version for the Storage service is version 2017-11-09. In this case, you will need to use the following code to change the Storage service API version to 2017-11-09. For an example on how to target a specific Storage API version, see [this sample on GitHub](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/eventhubs/azure-messaging-eventhubs-checkpointstore-blob/src/samples/java/com/azure/messaging/eventhubs/checkpointstore/blob/EventProcessorWithOlderStorageVersion.java). For more information on the Azure Storage service versions supported on Azure Stack Hub, see [Azure Stack Hub storage: Differences and considerations](https://docs.microsoft.com/azure-stack/user/azure-stack-acs-differences).
142-
141+
> The following sample code can be used if the environment you are targeting supports a different version of Storage Blob SDK than those typically available on Azure. For example, if you are running [Event Hubs on an Azure Stack Hub version 2002](https://docs.microsoft.com/azure-stack/user/event-hubs-overview), the highest available version for the Storage service is version 2017-11-09. In this case, you will need to add code to target the Storage service API version 2017-11-09. For an example on how to target a specific Storage API version, see [this sample on GitHub](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/eventhubs/azure-messaging-eventhubs-checkpointstore-blob/src/samples/java/com/azure/messaging/eventhubs/checkpointstore/blob/EventProcessorWithOlderStorageVersion.java). For more information on the Azure Storage service versions supported on Azure Stack Hub, please refer to [Azure Stack Hub storage: Differences and considerations](docs.microsoft.com/en-us/azure-stack/user/azure-stack-acs-differences).
143142
144143
### Create a Java project
145144

articles/event-hubs/get-started-node-send-v2.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,8 @@ Congratulations! You have now sent events to an event hub.
109109
In this section, you receive events from an event hub by using an Azure Blob storage checkpoint store in a JavaScript application. It performs metadata checkpoints on received messages at regular intervals in an Azure Storage blob. This approach makes it easy to continue receiving messages later from where you left off.
110110

111111
> [!NOTE]
112-
> The following code/sample can be used if the environment you are targeting supports a different version of Storage Blob SDK than those typically available on Azure. For example, if you are running [Event Hubs on an Azure Stack Hub version 2002](https://docs.microsoft.com/azure-stack/user/event-hubs-overview), the highest available version for the Storage service is version 2017-11-09. In this case, you will need to use the following code to change the Storage service API version to 2017-11-09. For an example on how to target a specific Storage API version, see the [JavaScript](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/eventhub/eventhubs-checkpointstore-blob/samples/receiveEventsWithDownleveledStorage.js) or [TypeScript](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/eventhub/eventhubs-checkpointstore-blob/samples/receiveEventsWithDownleveledStorage.ts) sample on GitHub. For more information on the Azure Storage service versions supported on Azure Stack Hub, see [Azure Stack Hub storage: Differences and considerations](https://docs.microsoft.com/azure-stack/user/azure-stack-acs-differences).
112+
> The following sample code can be used if the environment you are targeting supports a different version of Storage Blob SDK than those typically available on Azure. For example, if you are running [Event Hubs on an Azure Stack Hub version 2002](https://docs.microsoft.com/azure-stack/user/event-hubs-overview), the highest available version for the Storage service is version 2017-11-09. In this case, you will need to add code to target the Storage service API version 2017-11-09. For an example on how to target a specific Storage API version, see [JavaScript](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/eventhub/eventhubs-checkpointstore-blob/samples/receiveEventsWithDownleveledStorage.js) and [TypeScript](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/eventhub/eventhubs-checkpointstore-blob/samples/receiveEventsWithDownleveledStorage.ts) samples on GitHub. For more information on the Azure Storage service versions supported on Azure Stack Hub, please refer to [Azure Stack Hub storage: Differences and considerations](docs.microsoft.com/en-us/azure-stack/user/azure-stack-acs-differences).
113+
113114

114115
### Create an Azure storage account and a blob container
115116
To create an Azure storage account and a blob container in it, do the following actions:

articles/event-hubs/get-started-python-send-v2.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,8 @@ In this section, you create a Python script to send events to the event hub that
8282
This quickstart uses Azure Blob storage as a checkpoint store. The checkpoint store is used to persist checkpoints (that is, the last read positions).
8383
8484
> [!NOTE]
85-
> The following code/sample can be used if the environment you are targeting supports a different version of Storage Blob SDK than those typically available on Azure. For example, if you are running [Event Hubs on an Azure Stack Hub version 2002](https://docs.microsoft.com/azure-stack/user/event-hubs-overview), the highest available version for the Storage service is version 2017-11-09. In this case, you will need to use the following code to change the Storage service API version to 2017-11-09. For an example on how to target a specific Storage API version, see the [synchronous](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/eventhub/azure-eventhub-checkpointstoreblob/samples/event_processor_blob_storage_example_with_storage_api_version.py) or [asynchronous](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/eventhub/azure-eventhub-checkpointstoreblob-aio/samples/event_processor_blob_storage_example_with_storage_api_version.py) sample on GitHub. For more information on the Azure Storage service versions supported on Azure Stack Hub, see [Azure Stack Hub storage: Differences and considerations](https://docs.microsoft.com/azure-stack/user/azure-stack-acs-differences).
85+
> The following sample code can be used if the environment you are targeting supports a different version of Storage Blob SDK than those typically available on Azure. For example, if you are running [Event Hubs on an Azure Stack Hub version 2002](https://docs.microsoft.com/azure-stack/user/event-hubs-overview), the highest available version for the Storage service is version 2017-11-09. In this case, you will need to add code to target the Storage service API version 2017-11-09. For an example on how to target a specific Storage API version, see the [synchronous](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/eventhub/azure-eventhub-checkpointstoreblob/samples/event_processor_blob_storage_example_with_storage_api_version.py) and [asynchronous](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/eventhub/azure-eventhub-checkpointstoreblob-aio/samples/event_processor_blob_storage_example_with_storage_api_version.py) samples on GitHub.. For more information on the Azure Storage service versions supported on Azure Stack Hub, please refer to [Azure Stack Hub storage: Differences and considerations](docs.microsoft.com/en-us/azure-stack/user/azure-stack-acs-differences).
86+
8687
8788
### Create an Azure storage account and a blob container
8889
Create an Azure storage account and a blob container in it by doing the following steps:

articles/event-hubs/use-blob-storage-checkpoint-store-azure-stack-hub.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Use Blob Storage as checkpoint store on Azure Stack Hub
3-
description: This article describes the differences between using Blob Storage as a checkpoint store in Event Hubs on Azure vs. Event Hubs on Azure Stack Hub.
3+
description: This article describes how to use Blob Storage as a checkpoint store in Event Hubs on Azure Stack Hub.
44
services: event-hubs
55
documentationcenter: na
66
author: spelluru
@@ -20,14 +20,14 @@ If you're using Azure Blob Storage as the checkpoint store in an environment tha
2020
- [JavaScript](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/eventhub/eventhubs-checkpointstore-blob/samples/receiveEventsWithDownleveledStorage.js) or [TypeScript](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/eventhub/eventhubs-checkpointstore-blob/samples/receiveEventsWithDownleveledStorage.ts),
2121
- Python - [Synchronous](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/eventhub/azure-eventhub-checkpointstoreblob/samples/event_processor_blob_storage_example_with_storage_api_version.py), [Asynchronous](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/eventhub/azure-eventhub-checkpointstoreblob-aio/samples/event_processor_blob_storage_example_with_storage_api_version.py)
2222

23-
If you run Event Hubs receiver that uses Blob Storage without targeting the version that Azure Stack Hub supports, you'll receive the following error message:
23+
If you run Event Hubs receiver that uses Blob Storage as the checkpoint store without targeting the version that Azure Stack Hub supports, you'll receive the following error message:
2424

2525
```bash
2626
The value for one of the HTTP headers is not in the correct format
2727
```
2828
2929
## Sample error message in Python
30-
For Python, an error of `azure.core.exceptions.HttpResponseError` is passed to the error handler `on_error(partition_context, error)` of `EventHubConsumerClient.receive()`. But, method `receive()` doesn't raise an exception. print(error) will print the following exception information:
30+
For Python, an error of `azure.core.exceptions.HttpResponseError` is passed to the error handler `on_error(partition_context, error)` of `EventHubConsumerClient.receive()`. But, the method `receive()` doesn't raise an exception. `print(error)` will print the following exception information:
3131
3232
```bash
3333
The value for one of the HTTP headers is not in the correct format.
@@ -40,18 +40,14 @@ HeaderName:x-ms-version
4040
HeaderValue:2019-07-07
4141
```
4242
43-
The logger that uses synchronous pattern will log two warnings like the following ones:
43+
The logger will log two warnings like the following ones:
4444
4545
```bash
4646
WARNING:azure.eventhub.extensions.checkpointstoreblobaio._blobstoragecsaio:
4747
An exception occurred during list_ownership for namespace '<namespace-name>.eventhub.<region>.azurestack.corp.microsoft.com' eventhub 'python-eh-test' consumer group '$Default'.
4848
4949
Exception is HttpResponseError('The value for one of the HTTP headers is not in the correct format.\nRequestId:f048aee8-a90c-08ba-4ce1-e69dba759297\nTime:2020-03-17T22:04:13.3559296Z\nErrorCode:InvalidHeaderValue\nError:None\nHeaderName:x-ms-version\nHeaderValue:2019-07-07')
50-
```
51-
52-
The logger that uses asynchronous pattern will log two warnings like the following ones:
5350
54-
```bash
5551
WARNING:azure.eventhub.aio._eventprocessor.event_processor:EventProcessor instance '26d84102-45b2-48a9-b7f4-da8916f68214' of eventhub 'python-eh-test' consumer group '$Default'. An error occurred while load-balancing and claiming ownership.
5652
5753
The exception is HttpResponseError('The value for one of the HTTP headers is not in the correct format.\nRequestId:f048aee8-a90c-08ba-4ce1-e69dba759297\nTime:2020-03-17T22:04:13.3559296Z\nErrorCode:InvalidHeaderValue\nError:None\nHeaderName:x-ms-version\nHeaderValue:2019-07-07'). Retrying after 71.45254944090853 seconds

0 commit comments

Comments
 (0)