Event Hubs - Create Or Update

Служба:

Event Hubs

Версия API:

2024-01-01

Создает или обновляет новый концентратор событий в качестве вложенного ресурса в пространстве имен.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/eventhubs/{eventHubName}?api-version=2024-01-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
eventHubName	path	True	string	Имя концентратора событий
namespaceName	path	True	string	Имя пространства имен Шаблон регулярного выражения: ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$
resourceGroupName	path	True	string	Имя группы ресурсов в подписке Azure.
subscriptionId	path	True	string	Учетные данные подписки, которые однозначно идентифицируют подписку Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы.
api-version	query	True	string	Версия API клиента.

Текст запроса

Имя	Тип	Описание
properties.captureDescription	CaptureDescription	Свойства описания записи
properties.messageRetentionInDays	integer	Количество дней для хранения событий для этого концентратора событий, значение должно быть от 1 до 7 дней
properties.partitionCount	integer	Число секций, созданных для концентратора событий. Допустимые значения — от 1 до 32 секций.
properties.retentionDescription	RetentionDescription	Параметры хранения концентратора событий
properties.status	EntityStatus	Перечисляет возможные значения состояния концентратора событий.
properties.userMetadata	string	Возвращает и задает метаданные пользователя.

Ответы

Имя	Тип	Описание
200 OK	Eventhub	Концентратор событий успешно создан.
Other Status Codes	ErrorResponse	Ответ об ошибке концентратора событий, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

EventHubCreate

Образец запроса

HTTP

PUT https://management.azure.com/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/Default-NotificationHubs-AustraliaEast/providers/Microsoft.EventHub/namespaces/sdk-Namespace-5357/eventhubs/sdk-EventHub-6547?api-version=2024-01-01

{
  "properties": {
    "messageRetentionInDays": 4,
    "partitionCount": 4,
    "status": "Active",
    "userMetadata": "key",
    "captureDescription": {
      "enabled": true,
      "encoding": "Avro",
      "destination": {
        "name": "EventHubArchive.AzureBlockBlob",
        "properties": {
          "storageAccountResourceId": "/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-Storage-SouthCentralUS/providers/Microsoft.ClassicStorage/storageAccounts/arjunteststorage",
          "blobContainer": "container",
          "archiveNameFormat": "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}"
        },
        "identity": {
          "type": "UserAssigned",
          "userAssignedIdentity": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2"
        }
      },
      "intervalInSeconds": 120,
      "sizeLimitInBytes": 10485763
    },
    "retentionDescription": {
      "cleanupPolicy": "Compact",
      "retentionTimeInHours": 96,
      "tombstoneRetentionTimeInHours": 1
    }
  }
}

Java

import com.azure.resourcemanager.eventhubs.fluent.models.EventhubInner;
import com.azure.resourcemanager.eventhubs.models.CaptureDescription;
import com.azure.resourcemanager.eventhubs.models.CaptureIdentity;
import com.azure.resourcemanager.eventhubs.models.CaptureIdentityType;
import com.azure.resourcemanager.eventhubs.models.CleanupPolicyRetentionDescription;
import com.azure.resourcemanager.eventhubs.models.Destination;
import com.azure.resourcemanager.eventhubs.models.EncodingCaptureDescription;
import com.azure.resourcemanager.eventhubs.models.EntityStatus;
import com.azure.resourcemanager.eventhubs.models.RetentionDescription;

/**
 * Samples for EventHubs CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/eventhub/resource-manager/Microsoft.EventHub/stable/2024-01-01/examples/EventHubs/EHEventHubCreate.
     * json
     */
    /**
     * Sample code: EventHubCreate.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void eventHubCreate(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.eventHubs().manager().serviceClient().getEventHubs().createOrUpdateWithResponse(
            "Default-NotificationHubs-AustraliaEast", "sdk-Namespace-5357", "sdk-EventHub-6547",
            new EventhubInner().withMessageRetentionInDays(4L).withPartitionCount(4L).withStatus(EntityStatus.ACTIVE)
                .withUserMetadata("key")
                .withCaptureDescription(new CaptureDescription().withEnabled(true)
                    .withEncoding(EncodingCaptureDescription.AVRO).withIntervalInSeconds(120)
                    .withSizeLimitInBytes(10485763)
                    .withDestination(new Destination().withName("EventHubArchive.AzureBlockBlob").withIdentity(
                        new CaptureIdentity().withType(CaptureIdentityType.USER_ASSIGNED).withUserAssignedIdentity(
                            "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2"))
                        .withStorageAccountResourceId(
                            "/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-Storage-SouthCentralUS/providers/Microsoft.ClassicStorage/storageAccounts/arjunteststorage")
                        .withBlobContainer("container").withArchiveNameFormat(
                            "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}")))
                .withRetentionDescription(
                    new RetentionDescription().withCleanupPolicy(CleanupPolicyRetentionDescription.COMPACT)
                        .withRetentionTimeInHours(96L).withTombstoneRetentionTimeInHours(1)),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.eventhub import EventHubManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-eventhub
# USAGE
    python eh_event_hub_create.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = EventHubManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="5f750a97-50d9-4e36-8081-c9ee4c0210d4",
    )

    response = client.event_hubs.create_or_update(
        resource_group_name="Default-NotificationHubs-AustraliaEast",
        namespace_name="sdk-Namespace-5357",
        event_hub_name="sdk-EventHub-6547",
        parameters={
            "properties": {
                "captureDescription": {
                    "destination": {
                        "identity": {
                            "type": "UserAssigned",
                            "userAssignedIdentity": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2",
                        },
                        "name": "EventHubArchive.AzureBlockBlob",
                        "properties": {
                            "archiveNameFormat": "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}",
                            "blobContainer": "container",
                            "storageAccountResourceId": "/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-Storage-SouthCentralUS/providers/Microsoft.ClassicStorage/storageAccounts/arjunteststorage",
                        },
                    },
                    "enabled": True,
                    "encoding": "Avro",
                    "intervalInSeconds": 120,
                    "sizeLimitInBytes": 10485763,
                },
                "messageRetentionInDays": 4,
                "partitionCount": 4,
                "retentionDescription": {
                    "cleanupPolicy": "Compact",
                    "retentionTimeInHours": 96,
                    "tombstoneRetentionTimeInHours": 1,
                },
                "status": "Active",
                "userMetadata": "key",
            }
        },
    )
    print(response)


# x-ms-original-file: specification/eventhub/resource-manager/Microsoft.EventHub/stable/2024-01-01/examples/EventHubs/EHEventHubCreate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armeventhub_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/eventhub/armeventhub"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/b574e2a41acda14a90ef237006e8bbdda2b63c63/specification/eventhub/resource-manager/Microsoft.EventHub/stable/2024-01-01/examples/EventHubs/EHEventHubCreate.json
func ExampleEventHubsClient_CreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armeventhub.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewEventHubsClient().CreateOrUpdate(ctx, "Default-NotificationHubs-AustraliaEast", "sdk-Namespace-5357", "sdk-EventHub-6547", armeventhub.Eventhub{
		Properties: &armeventhub.Properties{
			CaptureDescription: &armeventhub.CaptureDescription{
				Destination: &armeventhub.Destination{
					Name: to.Ptr("EventHubArchive.AzureBlockBlob"),
					Identity: &armeventhub.CaptureIdentity{
						Type:                 to.Ptr(armeventhub.CaptureIdentityTypeUserAssigned),
						UserAssignedIdentity: to.Ptr("/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2"),
					},
					Properties: &armeventhub.DestinationProperties{
						ArchiveNameFormat:        to.Ptr("{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}"),
						BlobContainer:            to.Ptr("container"),
						StorageAccountResourceID: to.Ptr("/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-Storage-SouthCentralUS/providers/Microsoft.ClassicStorage/storageAccounts/arjunteststorage"),
					},
				},
				Enabled:           to.Ptr(true),
				Encoding:          to.Ptr(armeventhub.EncodingCaptureDescriptionAvro),
				IntervalInSeconds: to.Ptr[int32](120),
				SizeLimitInBytes:  to.Ptr[int32](10485763),
			},
			MessageRetentionInDays: to.Ptr[int64](4),
			PartitionCount:         to.Ptr[int64](4),
			RetentionDescription: &armeventhub.RetentionDescription{
				CleanupPolicy:                 to.Ptr(armeventhub.CleanupPolicyRetentionDescriptionCompact),
				RetentionTimeInHours:          to.Ptr[int64](96),
				TombstoneRetentionTimeInHours: to.Ptr[int32](1),
			},
			Status:       to.Ptr(armeventhub.EntityStatusActive),
			UserMetadata: to.Ptr("key"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Eventhub = armeventhub.Eventhub{
	// 	Name: to.Ptr("sdk-EventHub-10"),
	// 	Type: to.Ptr("Microsoft.EventHub/Namespaces/EventHubs"),
	// 	ID: to.Ptr("/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-NotificationHubs-AustraliaEast/providers/Microsoft.EventHub/namespaces/sdk-Namespace-716/eventhubs/sdk-EventHub-10"),
	// 	Properties: &armeventhub.Properties{
	// 		CaptureDescription: &armeventhub.CaptureDescription{
	// 			Destination: &armeventhub.Destination{
	// 				Name: to.Ptr("EventHubArchive.AzureBlockBlob"),
	// 				Identity: &armeventhub.CaptureIdentity{
	// 					Type: to.Ptr(armeventhub.CaptureIdentityTypeUserAssigned),
	// 					UserAssignedIdentity: to.Ptr("/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2"),
	// 				},
	// 				Properties: &armeventhub.DestinationProperties{
	// 					ArchiveNameFormat: to.Ptr("{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}"),
	// 					BlobContainer: to.Ptr("container"),
	// 					StorageAccountResourceID: to.Ptr("/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-Storage-SouthCentralUS/providers/Microsoft.ClassicStorage/storageAccounts/arjunteststorage"),
	// 				},
	// 			},
	// 			Enabled: to.Ptr(true),
	// 			Encoding: to.Ptr(armeventhub.EncodingCaptureDescriptionAvro),
	// 			IntervalInSeconds: to.Ptr[int32](120),
	// 			SizeLimitInBytes: to.Ptr[int32](10485763),
	// 		},
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-06-28T02:45:55.877Z"); return t}()),
	// 		MessageRetentionInDays: to.Ptr[int64](4),
	// 		PartitionCount: to.Ptr[int64](4),
	// 		PartitionIDs: []*string{
	// 			to.Ptr("0"),
	// 			to.Ptr("1"),
	// 			to.Ptr("2"),
	// 			to.Ptr("3")},
	// 			RetentionDescription: &armeventhub.RetentionDescription{
	// 				CleanupPolicy: to.Ptr(armeventhub.CleanupPolicyRetentionDescriptionCompact),
	// 				RetentionTimeInHours: to.Ptr[int64](96),
	// 				TombstoneRetentionTimeInHours: to.Ptr[int32](1),
	// 			},
	// 			Status: to.Ptr(armeventhub.EntityStatusActive),
	// 			UpdatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-06-28T02:46:05.877Z"); return t}()),
	// 			UserMetadata: to.Ptr("key"),
	// 		},
	// 	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { EventHubManagementClient } = require("@azure/arm-eventhub");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Creates or updates a new Event Hub as a nested resource within a Namespace.
 *
 * @summary Creates or updates a new Event Hub as a nested resource within a Namespace.
 * x-ms-original-file: specification/eventhub/resource-manager/Microsoft.EventHub/stable/2024-01-01/examples/EventHubs/EHEventHubCreate.json
 */
async function eventHubCreate() {
  const subscriptionId =
    process.env["EVENTHUB_SUBSCRIPTION_ID"] || "5f750a97-50d9-4e36-8081-c9ee4c0210d4";
  const resourceGroupName =
    process.env["EVENTHUB_RESOURCE_GROUP"] || "Default-NotificationHubs-AustraliaEast";
  const namespaceName = "sdk-Namespace-5357";
  const eventHubName = "sdk-EventHub-6547";
  const parameters = {
    captureDescription: {
      destination: {
        name: "EventHubArchive.AzureBlockBlob",
        archiveNameFormat:
          "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}",
        blobContainer: "container",
        identity: {
          type: "UserAssigned",
          userAssignedIdentity:
            "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2",
        },
        storageAccountResourceId:
          "/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-Storage-SouthCentralUS/providers/Microsoft.ClassicStorage/storageAccounts/arjunteststorage",
      },
      enabled: true,
      encoding: "Avro",
      intervalInSeconds: 120,
      sizeLimitInBytes: 10485763,
    },
    messageRetentionInDays: 4,
    partitionCount: 4,
    retentionDescription: {
      cleanupPolicy: "Compact",
      retentionTimeInHours: 96,
      tombstoneRetentionTimeInHours: 1,
    },
    status: "Active",
    userMetadata: "key",
  };
  const credential = new DefaultAzureCredential();
  const client = new EventHubManagementClient(credential, subscriptionId);
  const result = await client.eventHubs.createOrUpdate(
    resourceGroupName,
    namespaceName,
    eventHubName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.EventHubs.Models;
using Azure.ResourceManager.EventHubs;

// Generated from example definition: specification/eventhub/resource-manager/Microsoft.EventHub/stable/2024-01-01/examples/EventHubs/EHEventHubCreate.json
// this example is just showing the usage of "EventHubs_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this EventHubResource created on azure
// for more information of creating EventHubResource, please refer to the document of EventHubResource
string subscriptionId = "5f750a97-50d9-4e36-8081-c9ee4c0210d4";
string resourceGroupName = "Default-NotificationHubs-AustraliaEast";
string namespaceName = "sdk-Namespace-5357";
string eventHubName = "sdk-EventHub-6547";
ResourceIdentifier eventHubResourceId = EventHubResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, namespaceName, eventHubName);
EventHubResource eventHub = client.GetEventHubResource(eventHubResourceId);

// invoke the operation
EventHubData data = new EventHubData()
{
    PartitionCount = 4L,
    Status = EventHubEntityStatus.Active,
    UserMetadata = "key",
    CaptureDescription = new CaptureDescription()
    {
        Enabled = true,
        Encoding = EncodingCaptureDescription.Avro,
        IntervalInSeconds = 120,
        SizeLimitInBytes = 10485763,
        Destination = new EventHubDestination()
        {
            Name = "EventHubArchive.AzureBlockBlob",
            Identity = new EventHubsCaptureIdentity()
            {
                IdentityType = EventHubsCaptureIdentityType.UserAssigned,
                UserAssignedIdentity = "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2",
            },
            StorageAccountResourceId = new ResourceIdentifier("/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-Storage-SouthCentralUS/providers/Microsoft.ClassicStorage/storageAccounts/arjunteststorage"),
            BlobContainer = "container",
            ArchiveNameFormat = "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}",
        },
    },
    RetentionDescription = new RetentionDescription()
    {
        CleanupPolicy = CleanupPolicyRetentionDescription.Compaction,
        RetentionTimeInHours = 96L,
        TombstoneRetentionTimeInHours = 1,
    },
};
ArmOperation<EventHubResource> lro = await eventHub.UpdateAsync(WaitUntil.Completed, data);
EventHubResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
EventHubData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Пример ответа

Код состояния:

200

{
  "id": "/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-NotificationHubs-AustraliaEast/providers/Microsoft.EventHub/namespaces/sdk-Namespace-716/eventhubs/sdk-EventHub-10",
  "name": "sdk-EventHub-10",
  "type": "Microsoft.EventHub/Namespaces/EventHubs",
  "properties": {
    "messageRetentionInDays": 4,
    "partitionCount": 4,
    "status": "Active",
    "userMetadata": "key",
    "createdAt": "2017-06-28T02:45:55.877Z",
    "updatedAt": "2017-06-28T02:46:05.877Z",
    "partitionIds": [
      "0",
      "1",
      "2",
      "3"
    ],
    "captureDescription": {
      "enabled": true,
      "encoding": "Avro",
      "destination": {
        "name": "EventHubArchive.AzureBlockBlob",
        "properties": {
          "storageAccountResourceId": "/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-Storage-SouthCentralUS/providers/Microsoft.ClassicStorage/storageAccounts/arjunteststorage",
          "blobContainer": "container",
          "archiveNameFormat": "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}"
        },
        "identity": {
          "type": "UserAssigned",
          "userAssignedIdentity": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2"
        }
      },
      "intervalInSeconds": 120,
      "sizeLimitInBytes": 10485763
    },
    "retentionDescription": {
      "cleanupPolicy": "Compact",
      "retentionTimeInHours": 96,
      "tombstoneRetentionTimeInHours": 1
    }
  }
}

Определения

Имя	Описание
CaptureDescription	Свойства для настройки описания записи для концентратора событий
CaptureIdentity	Значение типа , указывающее, включено ли описание записи.
CaptureIdentityType	Тип управляемого удостоверения Azure Active Directory.
CleanupPolicyRetentionDescription	Перечисляет возможные значения для политики очистки.
createdByType	Тип удостоверения, создавшего ресурс.
Destination	Запись сведений о хранилище для описания записи
EncodingCaptureDescription	Перечисляет возможные значения для формата кодирования описания записи. Примечание. AvroDeflate будет считаться нерекомендуемой в новой версии API
EntityStatus	Перечисляет возможные значения состояния концентратора событий.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ об ошибке указывает, что служба концентратора событий не может обработать входящий запрос. Причина указана в сообщении об ошибке.
Eventhub	Один элемент в операции List или Get Event Hub
RetentionDescription	Свойства для настройки параметров хранения для концентратора событий
systemData	Метаданные, относящиеся к созданию и последнему изменению ресурса.

CaptureDescription

Свойства для настройки описания записи для концентратора событий

Имя	Тип	Описание
destination	Destination	Свойства назначения, в котором будет храниться запись. (учетная запись хранения, имена BLOB-объектов)
enabled	boolean	Значение типа , указывающее, включено ли описание записи.
encoding	EncodingCaptureDescription	Перечисляет возможные значения для формата кодирования описания записи. Примечание. AvroDeflate будет считаться нерекомендуемой в новой версии API
intervalInSeconds	integer	Временное окно позволяет задать частоту записи в BLOB-объекты Azure. Значение должно составлять от 60 до 900 секунд.
sizeLimitInBytes	integer	Окно размера определяет объем данных, созданных в концентраторе событий перед операцией записи. Значение должно быть от 10485760 до 524288000 байтов.
skipEmptyArchives	boolean	Значение типа , указывающее, следует ли пропускать пустые архивы

CaptureIdentity

Значение типа , указывающее, включено ли описание записи.

Имя	Тип	Описание
type	CaptureIdentityType	Тип управляемого удостоверения Azure Active Directory.
userAssignedIdentity	string	Идентификатор ARM управляемого удостоверения пользователя. Это свойство является обязательным, если тип — UserAssignedIdentity. Если тип — SystemAssigned, будет использоваться назначенное системой удостоверение, связанное с пространством имен.

CaptureIdentityType

Тип управляемого удостоверения Azure Active Directory.

Имя	Тип	Описание
SystemAssigned	string
UserAssigned	string

CleanupPolicyRetentionDescription

Перечисляет возможные значения для политики очистки.

Имя	Тип	Описание
Compact	string
Delete	string

createdByType

Тип удостоверения, создавшего ресурс.

Имя	Тип	Описание
Application	string
Key	string
ManagedIdentity	string
User	string

Destination

Запись сведений о хранилище для описания записи

Имя	Тип	Описание
identity	CaptureIdentity	Значение типа , указывающее, включено ли описание записи.
name	string	Имя назначения записи
properties.archiveNameFormat	string	Соглашение об именовании BLOB-объектов для архива, например{Пространство имен}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Здесь все параметры (пространство имен, EventHub и т. д.) являются обязательными независимо от порядка.
properties.blobContainer	string	Имя контейнера BLOB-объектов
properties.dataLakeAccountName	string	Имя Azure Data Lake Store для захваченных событий
properties.dataLakeFolderPath	string	Путь к конечной папке для захваченных событий
properties.dataLakeSubscriptionId	string	Идентификатор подписки Azure Data Lake Store
properties.storageAccountResourceId	string	Идентификатор ресурса учетной записи хранения, используемой для создания больших двоичных объектов

EncodingCaptureDescription

Перечисляет возможные значения для формата кодирования описания записи. Примечание. AvroDeflate будет считаться нерекомендуемой в новой версии API

Имя	Тип	Описание
Avro	string
AvroDeflate	string

EntityStatus

Перечисляет возможные значения состояния концентратора событий.

Имя	Тип	Описание
Active	string
Creating	string
Deleting	string
Disabled	string
ReceiveDisabled	string
Renaming	string
Restoring	string
SendDisabled	string
Unknown	string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Ответ об ошибке указывает, что служба концентратора событий не может обработать входящий запрос. Причина указана в сообщении об ошибке.

Имя	Тип	Описание
error	ErrorDetail	Объект error.

Eventhub

Один элемент в операции List или Get Event Hub

Имя	Тип	Описание
id	string	Полный идентификатор ресурса. Например: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса.
properties.captureDescription	CaptureDescription	Свойства описания записи
properties.createdAt	string	Точное время создания концентратора событий.
properties.messageRetentionInDays	integer	Количество дней для хранения событий для этого концентратора событий, значение должно быть от 1 до 7 дней
properties.partitionCount	integer	Число секций, созданных для концентратора событий. Допустимые значения — от 1 до 32 секций.
properties.partitionIds	string[]	Текущее количество сегментов в концентраторе событий.
properties.retentionDescription	RetentionDescription	Параметры хранения концентратора событий
properties.status	EntityStatus	Перечисляет возможные значения состояния концентратора событий.
properties.updatedAt	string	Точное время обновления сообщения.
properties.userMetadata	string	Возвращает и задает метаданные пользователя.
systemData	systemData	Системные метаданные, относящиеся к этому ресурсу.
type	string	Тип ресурса. Например, "Microsoft.EventHub/Namespaces" или "Microsoft.EventHub/Namespaces/EventHubs"

RetentionDescription

Свойства для настройки параметров хранения для концентратора событий

Имя	Тип	Описание
cleanupPolicy	CleanupPolicyRetentionDescription	Перечисляет возможные значения для политики очистки.
retentionTimeInHours	integer	Количество часов на хранение событий для этого концентратора событий. Это значение используется, только если cleanupPolicy имеет значение Delete. Если cleanupPolicy имеет значение Compact, то возвращаемое значение этого свойства — Long.MaxValue.
tombstoneRetentionTimeInHours	integer	Количество часов на хранение маркеров надгробия в сжатом концентраторе событий. Это значение используется, только если cleanupPolicy имеет значение Compact. Потребитель должен завершить чтение маркера надгробия в течение указанного промежутка времени, если потребитель начинает с начала смещения, чтобы убедиться, что он получает допустимую snapshot для определенного ключа, описанного маркером tombstone в сжатом концентраторе событий.

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя	Тип	Описание
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Тип удостоверения, которое последним изменял ресурс.
lastModifiedBy	string	Удостоверение, которое последним изменял ресурс.
lastModifiedByType	createdByType	Тип удостоверения, которое последним изменял ресурс.