すべてのプロダクト
Search
ドキュメントセンター

:CreateEventStreaming

最終更新日:Nov 10, 2025

イベントストリームを作成します。

URL

/eventstreaming/createEventStreaming

使用上の注意

  • イベントストリームでは、SourceMNSParametersSourceRocketMQParametersSourceRabbitMQParametersSourceSLSParameters パラメーターのいずれか 1 つのみが返されます。
  • イベントストリームでは、SinkMNSParametersSinkRocketMQParametersSinkRabbitMQParametersSinkSLSParameters パラメーターのいずれか 1 つのみを指定できます。

使用上の注意

パラメータータイプ必須説明
EventStreamingNameStringはいmyeventstreamingイベントストリームの名前。
DescriptionStringはいrocketmq2mnsイベントストリームの説明。
SourceObjectはいSourceRocketMQParametersイベントプロバイダー。
SourceMNSParametersObjectいいえイベントプロバイダーがシンプルメッセージキュー(旧MNS)であることを指定します。詳細については、「リクエストパラメーター SourceMNSParameters」をご参照ください。
SourceRocketMQParametersObjectいいえイベントプロバイダーがRocketMQ for ApsaraMQであることを指定します。詳細については、「リクエストパラメーター SourceRocketMQParameters」をご参照ください。
SourceRabbitMQParametersObjectいいえイベントプロバイダーがRabbitMQ for ApsaraMQであることを指定します。詳細については、「リクエストパラメーター SourceRabbitMQParameters」をご参照ください。
SourceSLSParametersObjectいいえイベントプロバイダーがログサービスであることを指定します。詳細については、「リクエストパラメーター SinkSLSParameters」をご参照ください。
FilterPatternStringいいえNone.イベントをフィルタリングするために使用されるルール。このパラメーターを空のままにすると、すべてのイベントが一致となります。
SinkObjectはいSinkMNSParametersイベントターゲット。
SinkMNSParametersObjectいいえイベントターゲットがシンプルメッセージキュー(旧MNS)であることを指定します。詳細については、「リクエストパラメーター SinkMNSParameters」をご参照ください。
SinkRocketMQParametersObjectいいえイベントターゲットがRocketMQ for ApsaraMQであることを指定します。詳細については、「リクエストパラメーター SinkRocketMQParameters」をご参照ください。
SinkRabbitMQParametersObjectいいえイベントターゲットがRabbitMQ for ApsaraMQであることを指定します。詳細については、「リクエストパラメーター SinkRabbitMQParameters」をご参照ください。
SinkSLSParametersObjectいいえイベントターゲットがログサービスであることを指定します。詳細については、「リクエストパラメーター SinkSLSParameters」をご参照ください。
RunOptionsObjectいいえランタイム環境。
RetryStrategyStringはいBACKOFF_RETRYイベントのプッシュに失敗した場合に使用される再試行ポリシー。有効な値:
  • BACKOFF_RETRY: バックオフ再試行。リクエストは最大 3 回再試行できます。2 回の連続する再試行の間隔は、10 ~ 20 秒のランダムな値です。
  • EXPONENTIAL_DECAY_RETRY: 指数関数的減衰再試行。リクエストは最大 176 回再試行できます。2 回の連続する再試行の間隔は指数関数的に増加して 512 秒になり、合計再試行時間は 1 日です。具体的な再試行間隔は、1、2、4、8、16、32、64、128、256、512、512、...、512 秒で、合計で最大 167 個の 512 秒が含まれます。

デフォルト値:BACKOFF_RETRY。

ErrorsToleranceStringはいALLフォールトトレランスポリシー。このポリシーは、エラーが発生した場合にエラーを無視するかどうかを指定します。有効な値:
  • ALL: エラーを無視します。
  • NONE: エラーを無視しません。

デフォルト値:ALL。

DeadLetterQueueObjectはいデッドレターキューを有効にするかどうかを指定します。デフォルトでは、デッドレターキューは無効になっています。再試行ポリシーで指定された許容回数後にプッシュに失敗したメッセージは破棄されます。
ArnStringいいえacs:mq:cn-chengdu:164901546557****:/instances/MQ_INST_164901546557****_BXxk0KXx/topic/MytopicRabbitMQ for ApsaraMQ インスタンストピックのAlibaba Cloud Resource Name(ARN)。

リクエストパラメーター SourceMNSParameters

SourceMNSParameters パラメーターを指定する場合、次の表に示すパラメーターを設定できます。

パラメータータイプ必須説明
QueueNameStringはいdemoSimple Message Queue(旧称 MNS) インスタンス内のキューの名前。
IsBase64DecodeStringはいtrueBase64 エンコーディングを有効にするかどうかを指定します。デフォルト値:true

リクエストパラメータ SourceRocketMQParameters

SourceRocketMQParameters パラメータを指定する場合、次の表に示すパラメータを設定できます。

パラメータタイプ必須説明
RegionIdStringはいcn-hangzhouRocketMQ for ApsaraMQ インスタンスが存在するリージョンの ID です。
InstanceIdStringはいMQ_INST_164901546557****_BAAN****RocketMQ for ApsaraMQ インスタンスの ID です。詳細については、「制限」をご参照ください。
TopicStringはいmytopicRocketMQ for ApsaraMQ インスタンスのトピック名です。詳細については、「制限」をご参照ください。
TagStringいいえtestメッセージをフィルタリングするために使用されるタグです。
OffsetStringいいえCONSUME_FROM_TIMESTAMPメッセージのコンシューマオフセットです。有効な値:
  • CONSUME_FROM_LAST_OFFSET: 最新のオフセットから消費を開始します。
  • CONSUME_FROM_FIRST_OFFSET: 最も古いオフセットから消費を開始します。
  • CONSUME_FROM_TIMESTAMP: 指定された時点のオフセットから消費を開始します。

デフォルト値: CONSUME_FROM_LAST_OFFSET です。

TimestampLongいいえ1636597951964消費を開始するオフセットのタイムスタンプです。このパラメータは、Offset パラメータを CONSUME_FROM_TIMESTAMP に設定した場合にのみ有効です。
GroupIDStringはいGID_group1RocketMQ for ApsaraMQ インスタンスのグループ ID です。

リクエストパラメータ SourceRabbitMQParameters

SourceRabbitMQParameters パラメータを指定する場合、次の表に示すパラメータを設定できます。

パラメータタイプ必須説明
InstanceIdStringはいamqp-cn-nif22u74****ApsaraMQ for RabbitMQ インスタンスの ID です。詳細については、「制限」をご参照ください。
VirtualHostNameStringはいeb-connectApsaraMQ for RabbitMQ インスタンスの vhost の名前です。詳細については、「制限」をご参照ください。
QueueNameStringはいdemoApsaraMQ for RabbitMQ インスタンスのキューの名前です。詳細については、「制限」をご参照ください。

リクエストパラメーター SourceSLSParameters

SourceMNSParameters パラメーターを指定する場合、次の表に示すパラメーターを設定できます。

パラメータータイプ必須説明
ProjectStringはいtest-projectログサービス プロジェクト。
LogStoreStringはいtest-logstoreログサービス ログストア。
ConsumePositionStringいいえend開始コンシューマー オフセット。値 begin は最も古いオフセットを示し、値 end は最新のオフセットを示します。消費を開始する時間を秒単位で指定することもできます。
RoleNameStringはいtestRoleロールの名前。EventBridge がこのロールを使用してログサービスのログを読み取ることを承認するには、RAMコンソールでロールを作成するときに、[選択された信頼できるエンティティ] パラメーターで [Alibaba Cloud サービス] を選択し、[信頼できるサービスの選択] パラメーターで [EventBridge] を選択する必要があります。このロールの権限ポリシーについては、シンプルなログサービス タイプのカスタムイベントソースを作成する を参照してください。

リクエストパラメーター SinkMNSParameters

SinkMNSParameters パラメーターを指定すると、次の表に示すパラメーターを設定できます。

パラメータータイプ必須説明
QueueNameTargetParameterはいイベントターゲットが シンプルメッセージキュー(旧称 MNS) の場合に指定するキューの名前。
ValueStringはいMyQueueシンプルメッセージキュー(旧称 MNS) インスタンス内のキューの名前。
FormStringいいえCONSTANT変換方法。デフォルト値:CONSTANT
BodyTargetParameterいいえメッセージの内容。
FormStringいいえTEMPLATE変換方法。
ValueStringはい
{
  "key": "value"
}
変換前の値。
TemplateStringいいえThe value of ${key} is ${value}!イベントを変換するためのテンプレート。
IsBase64EncodeTargetParameterはいBase64 エンコードを有効にするかどうかを指定します。
ValueStringはいtrueBase64 エンコードを有効にします。
FormStringいいえCONSTANT変換方法。デフォルト値:CONSTANT

リクエストパラメーターSinkRocketMQ パラメーター

SinkRocketMQParameters パラメーターを指定する場合、次の表に示すパラメーターを構成できます。

パラメータータイプ必須説明
インスタンス IDTargetParameterはいイベントターゲットが ApsaraMQ for RocketMQ の場合に指定するインスタンスの ID です。
StringはいMQ_INST_164901546557****_BAAN****ApsaraMQ for RocketMQ インスタンスの ID です。詳細については、「制限」をご参照ください。
形式StringいいえCONSTANT変換方法。既定値: CONSTANT です。
トピックTargetParameterはいApsaraMQ for RocketMQ インスタンスのトピックです。
StringはいMytopicApsaraMQ for RocketMQ インスタンスのトピック名です。詳細については、「制限」をご参照ください。
形式StringいいえCONSTANT変換方法。デフォルト値: CONSTANT です。
本文TargetParameterはいメッセージの内容。
フォーム文字列いいえいいえTEMPLATE
文字列はい
{
  "key": "value"
}
変換前の値。
テンプレートStringはい${key} の値は ${value} です!イベントの変換に使用するテンプレート。
プロパティTargetParameterはいメッセージのフィルタリングに使用されるプロパティです。
文字列はい
{
  "key": "value"
}
変換前の値。
形式StringいいえTEMPLATE変換方法です。
テンプレートStringはい${key} の値は ${value} です!イベントの変換に使用されるテンプレート。
キーTargetParameterはいメッセージのフィルタリングに使用されるプロパティです。
文字列はい
{
  "key": "value"
}
変換前の値。
形式StringいいえTEMPLATE変換方法。
テンプレートStringはい${key} の値は ${value} です!イベントの変換に使用されるテンプレート。
タグTargetParameterはいメッセージのフィルタリングに使用するプロパティです。
Stringはい
{
  "key": "value"
}
変換前の値。
フォームStringはいmyeventstreamingイベントストリームの名前。
テンプレート文字列はい${key} の値は ${value} です!

リクエストパラメータ SinkRabbitMQParameters

SinkRabbitMQParameters パラメータを指定する場合、次の表に示すパラメータを設定できます。

パラメータタイプ必須説明
InstanceIdTargetParameterはいイベントターゲットが ApsaraMQ for RabbitMQ の場合に指定するインスタンスの ID です。
ValueStringはいamqp-cn-2r42e73o****ApsaraMQ for RabbitMQ インスタンスの ID です。詳細については、「制限」をご参照ください。
FormStringいいえCONSTANT変換方法。デフォルト値:CONSTANT
VirtualHostNameTargetParameterはいApsaraMQ for RabbitMQ インスタンスの vhost の名前です。
ValueStringはいrabbit-hostApsaraMQ for RabbitMQ インスタンスの vhost の名前です。詳細については、「制限」をご参照ください。
FormStringいいえCONSTANT変換方法。デフォルト値:CONSTANT
TargetTypeTargetParameterはいイベントのプッシュ先リソースのタイプです。
ValueStringはいExchange/Queueイベントのプッシュ先リソースのタイプです。有効な値:
  • Exchange
  • Queue
FormStringいいえCONSTANT変換方法。デフォルト値:CONSTANT
ExchangeTargetParameterはい宛先インスタンスでイベントのプッシュ先となる交換の名前です。

TargetType パラメータを Exchange に設定した場合にのみ、このパラメータは有効です。

ValueStringはいa_exchangeApsaraMQ for RabbitMQ インスタンスの交換の名前です。詳細については、「制限」をご参照ください。
FormStringいいえCONSTANT変換方法。デフォルト値:CONSTANT
RoutingKeyTargetParameterはいメッセージのルーティングルールです。

TargetType パラメータを Exchange に設定した場合にのみ、このパラメータは有効です。

ValueStringはいhousekeepingメッセージのルーティングルールです。
FormStringいいえCONSTANT変換方法。デフォルト値:CONSTANT
QueueNameTargetParameterはい宛先インスタンスでイベントのプッシュ先となるキューの名前です。

TargetType パラメータを Queue に設定した場合にのみ、このパラメータは有効です。

ValueStringはいMyQueueMessage Queue for RabbitMQ インスタンスのキューの名前です。詳細については、「制限」をご参照ください。
FormStringいいえCONSTANT変換方法。デフォルト値:CONSTANT
BodyTargetParameterはいメッセージの内容。
FormStringいいえTEMPLATE変換方法。
ValueStringはい
{
  "key": "value"
}
変換前の値。
TemplateStringいいえThe value of ${key} is ${value}!イベントの変換に使用されるテンプレート。
MessageIdTargetParameterはいメッセージの ID。
ValueStringはい
{
  "key": "value"
}
変換前の値。
FormStringいいえTEMPLATE変換方法。
TemplateStringはいThe value of ${key} is ${value}!イベントの変換に使用されるテンプレート。
PropertiesTargetParameterはいメッセージのフィルタリングに使用されるタグ。
ValueStringはい
{
  "key": "value"
}
変換前の値。
FormStringいいえTEMPLATE変換方法。
TemplateStringはいThe value of ${key} is ${value}!イベントの変換に使用されるテンプレート。

リクエストパラメータ SinkSLSParameters

SinkRabbitMQParameters パラメータを指定する場合、次の表に示すパラメータを設定できます。

パラメータタイプ必須説明
ProjectStringはいtest-projectLog Service プロジェクト。
LogStoreStringはいtest-logstoreLog Service Logstore。
TopicStringいいえtestTopicログが存在するトピック。このパラメータの値は、Log Service の予約フィールド "__topic__" の値と同じです。
RoleNameStringはいtestRoleロール名。EventBridge がこのロールを使用して Log Service のログを読み取ることを承認するには、RAM コンソールでロールを作成するときに、[選択された信頼できるエンティティ] パラメータで [Alibaba Cloud サービス] を選択し、[信頼できるサービスの選択] パラメータで [EventBridge] を選択する必要があります。

レスポンスパラメーター

パラメータータイプ説明
EventStreamingARNStringacs:eventbridge:cn-hangzhou:164901546557****:eventstreaming/myeventstreamingEventStreaming の ARN です。

以下のサンプルリクエストとレスポンスでは、ApsaraMQ for RocketMQ タイプのカスタムイベントソースから、イベントターゲット Simple Message Queue (旧称 MNS) にイベントがルーティングされます。

サンプルリクエスト

POST /eventstreaming/creatEventStreaming HTTP/1.1
Host: 164901546557****.eventbridge.cn-hangzhou.aliyuncs.com
Date: Sat, 18 Apr 2020 05:30:41 GMT
x-eventbridge-version: 2020-04-01
Authorization: acs vZ3VL0SuJdHi****:Jo2PbT******azYAYoYslKLvWzg=
Content-Type: application/json;charset=UTF-8
Content-Length: 26

{
    "EventStreamingName":"myeventstreaming",
    "Description":"rocketmq2mns",
    "FilterPattern":"{}",
    "Source":{
        "SourceRocketMQParameters":{
            "InstanceId":"MQ_INST_164901546557****_BAAN****",
            "GroupID":"GID_group1",
            "Topic":"mytopic",
            "Offset":"CONSUME_FROM_TIMESTAMP",
            "Tag":"",
            "RegionId":"cn-hangzhou",
            "Timestamp":1636597951964
        }
    },
    "Sink":{
        "SinkMNSParameters":{
            "QueueName":{
                "Value":"MyQueue",
                "Form":"CONSTANT"
            },
            "IsBase64Encode":{
                "Value":"true",
                "Form":"CONSTANT"
            },
            "Body":{
                "Value":{
                    "key":"value"
                },
                "Form":"TEMPLATE",
                "Template":"The value of ${key} is ${value}!"
            }
        }
    },
    "RunOptions":{
        "ErrorsTolerance":"ALL",
        "RetryStrategy":{
            "PushRetryStrategy":"BACKOFF_RETRY"
        },
        "DeadLetterQueue":{
            "Arn":"acs:mq:cn-chengdu:164901546557****:/instances/MQ_INST_164901546557****_BXxk0KXx/topic/Mytopic"
        }
    }
}

サンプルレスポンス

HTTP/1.1 200 OK
Server: AliyunEventBridge
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 79
x-eventbridge-request-id: 244BED53-719A-15D7-B7F9-1C404273****
Date: Sat, 18 Apr 2020 05:30:41 GMT

{
    "code":"200",
    "data":{
        "RequestId":"244BED53-719A-15D7-B7F9-1C404273****",
        "Data":{
            "EventStreamingARN":"acs:eventbridge:cn-hangzhou:164901546557****:eventstreaming/myeventstreaming"
        },
        "Code":"Success",
        "Success":true
    },
    "httpStatusCode":"200",
    "requestId":"244BED53-719A-15D7-B7F9-1C404273****",
    "successResponse":true
}