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 參數

名稱	位於	必要	類型	Description
eventHubName	path	True	string	事件中樞名稱
namespaceName	path	True	string	命名空間名稱 Regex 模式: `^[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 版本。

要求本文

名稱	類型	Description
properties.captureDescription	CaptureDescription	擷取描述的屬性
properties.messageRetentionInDays	integer	保留此事件中樞事件的天數，值應為 1 到 7 天
properties.partitionCount	integer	為事件中樞建立的數據分割數目，允許的值是從 1 到 32 個數據分割。
properties.retentionDescription	RetentionDescription	事件中樞保留設定
properties.status	EntityStatus	列舉事件中樞狀態的可能值。
properties.userMetadata	string	取得和設定使用者的元數據。

回應

名稱	類型	Description
200 OK	Eventhub	已成功建立事件中樞。
Other Status Codes	ErrorResponse	Eventhub 錯誤回應，描述作業失敗的原因。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

EventHubCreate

範例要求

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
    }
  }
}


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

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

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

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

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
    }
  }
}

定義

名稱	Description
CaptureDescription	設定 eventhub 擷取描述的屬性
CaptureIdentity	值，指出是否啟用擷取描述。
CaptureIdentityType	Azure Active Directory 受控識別的類型。
CleanupPolicyRetentionDescription	列舉清除原則的可能值
createdByType	建立資源的身分識別類型。
Destination	擷取描述的擷取記憶體詳細
EncodingCaptureDescription	列舉擷取描述編碼格式的可能值。注意：新的 API 版本中將會淘汰 'AvroDflate'
EntityStatus	列舉事件中樞狀態的可能值。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應表示事件中樞服務無法處理傳入要求。錯誤訊息中會提供原因。
Eventhub	清單或取得事件中樞作業中的單一專案
RetentionDescription	設定 eventhub 保留設定的屬性
systemData	與建立和上次修改資源相關的元數據。

CaptureDescription

設定 eventhub 擷取描述的屬性

名稱	類型	Description
destination	Destination	將儲存擷取之目的地的屬性。 (記憶體帳戶、Blob 名稱)
enabled	boolean	值，指出是否啟用擷取描述。
encoding	EncodingCaptureDescription	列舉擷取描述編碼格式的可能值。注意：新的 API 版本中將會淘汰 'AvroDflate'
intervalInSeconds	integer	時間範圍可讓您設定擷取至 Azure Blob 的頻率，值應該介於 60 到 900 秒之間
sizeLimitInBytes	integer	大小視窗會在擷取作業之前定義事件中樞內建的數據量，值應該介於10485760到524288000個字節之間
skipEmptyArchives	boolean	值，指出是否略過空白封存

CaptureIdentity

值，指出是否啟用擷取描述。

名稱	類型	Description
type	CaptureIdentityType	Azure Active Directory 受控識別的類型。
userAssignedIdentity	string	受控用戶識別的 ARM 識別碼。這是必要屬性，類型為UserAssignedIdentity。如果類型為 SystemAssigned，則會使用與命名空間相關聯的系統指派身分識別。

CaptureIdentityType

Azure Active Directory 受控識別的類型。

名稱	類型	Description
SystemAssigned	string
UserAssigned	string

CleanupPolicyRetentionDescription

列舉清除原則的可能值

名稱	類型	Description
Compact	string
Delete	string

createdByType

建立資源的身分識別類型。

名稱	類型	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Destination

擷取描述的擷取記憶體詳細

名稱	類型	Description
identity	CaptureIdentity	值，指出是否啟用擷取描述。
name	string	擷取目的地的名稱
properties.archiveNameFormat	string	封存的 Blob 命名慣例，例如 {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}。在這裡，所有參數 (Namespace，EventHub ..etc) 不論順序為何，都是強制的
properties.blobContainer	string	Blob 容器名稱
properties.dataLakeAccountName	string	所擷取事件的 Azure Data Lake Store 名稱
properties.dataLakeFolderPath	string	所擷取事件的目的地資料夾路徑
properties.dataLakeSubscriptionId	string	Azure Data Lake Store 的訂用帳戶標識碼
properties.storageAccountResourceId	string	要用來建立 Blob 的記憶體帳戶資源識別碼

EncodingCaptureDescription

列舉擷取描述編碼格式的可能值。注意：新的 API 版本中將會淘汰 'AvroDflate'

名稱	類型	Description
Avro	string
AvroDeflate	string

EntityStatus

列舉事件中樞狀態的可能值。

名稱	類型	Description
Active	string
Creating	string
Deleting	string
Disabled	string
ReceiveDisabled	string
Renaming	string
Restoring	string
SendDisabled	string
Unknown	string

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細資料。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

錯誤回應表示事件中樞服務無法處理傳入要求。錯誤訊息中會提供原因。

名稱	類型	Description
error	ErrorDetail	錯誤物件。

Eventhub

清單或取得事件中樞作業中的單一專案

名稱	類型	Description
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

設定 eventhub 保留設定的屬性

名稱	類型	Description
cleanupPolicy	CleanupPolicyRetentionDescription	列舉清除原則的可能值
retentionTimeInHours	integer	保留此事件中樞事件的時數。只有在 cleanupPolicy 為 Delete 時，才會使用此值。如果 cleanupPolicy 為 Compact，則此屬性的傳回值為 Long.MaxValue
tombstoneRetentionTimeInHours	integer	保留壓縮事件中樞之標記的時數。只有在 cleanupPolicy 為 Compact 時，才會使用此值。如果取用者從起始位移開始，取用者必須在指定的時間範圍內完成讀取標記標記，以確保他們取得壓縮事件中樞內標記標記所描述之特定索引鍵的有效快照集

systemData

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string	資源建立的時間戳 (UTC) 。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string	上次修改資源的身分識別類型。
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。