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

:UpdateEventStreaming

最終更新日:Nov 10, 2025

イベントストリームに関する情報 (基本情報、イベントソース、イベントルール、イベントターゲットに関する情報など) を変更します。

URL

/eventstreaming/updateEventStreaming

使用上の注意

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

リクエストパラメーター

パラメータータイプ必須説明
EventStreamingNameStringはいmyeventstreamingイベントストリームの名前。
DescriptionStringはいrocketmq2mnsイベントストリームの説明。
SourceObjectはいSourceRocketMQParametersイベントプロバイダー。
SourceMNSParametersObjectいいえイベントプロバイダーが Simple Message Queue (旧称 MNS) であることを指定します。 詳細については、リクエストパラメーター SourceMNSParameters をご参照ください。
SourceRocketMQParametersObjectいいえイベントプロバイダーが RocketMQ for ApsaraMQ であることを指定します。 詳細については、リクエストパラメーター SourceRocketMQParameters をご参照ください。
SourceRabbitMQParametersObjectいいえイベントプロバイダーが RabbitMQ for ApsaraMQ であることを指定します。 詳細については、リクエストパラメーター SourceRabbitMQParameters をご参照ください。
SourceSLSParametersObjectいいえイベントプロバイダーがログサービスであることを指定します。 詳細については、リクエストパラメーター SinkSLSParameters をご参照ください。
FilterPatternStringいいえなしイベントをフィルタリングするために使用されるルール。 このパラメーターを空のままにすると、すべてのイベントが一致しま す。
SinkObjectはいSinkMNSParametersイベントターゲット。
SinkMNSParametersObjectいいえイベントターゲットが Simple Message Queue (旧称 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****RabbitMQ for ApsaraMQ インスタンスの ID。 詳細については、制限 をご参照ください。
VirtualHostNameStringはいeb-connectRabbitMQ for ApsaraMQ インスタンスの vhost の名前。 詳細については、制限 をご参照ください。
QueueNameStringはいdemoRabbitMQ for ApsaraMQ インスタンスのキューの名前。 詳細については、制限 をご参照ください。

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

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

パラメータータイプ必須説明
RoleNameStringはいtestRoleロールの名前。 EventBridge がこのロールを使用してログサービスのログを読み取ることを承認するには、RAM コンソールでロールを作成するときに、[選択された信頼できるエンティティ] パラメーターで [Alibaba Cloud サービス] を選択し、[信頼できるサービスの選択] パラメーターで [EventBridge] を選択する必要があります。

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

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

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

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

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

パラメータータイプ必須説明
InstanceIdTargetParameterはいイベントターゲットが RocketMQ for ApsaraMQ の場合に指定するインスタンスの ID。
ValueStringはいMQ_INST_164901546557****_BAAN****RocketMQ for ApsaraMQ インスタンスの ID。 詳細については、制限 をご参照ください。
FormStringいいえCONSTANT変換方法。 デフォルト値: CONSTANT
TopicTargetParameterはいRocketMQ for ApsaraMQ インスタンスのトピック。
ValueStringはいMytopicRocketMQ for ApsaraMQ インスタンスのトピックの名前。 詳細については、制限 をご参照ください。
FormStringいいえCONSTANT変換方法。 デフォルト値: CONSTANT
BodyTargetParameterはいメッセージの内容。
FormStringいいえNoTEMPLATE
ValueStringはい
{
  "key": "value"
}
変換前の値。
TemplateStringはいThe value of ${key} is ${value}!イベントを変換するためのテンプレート。
PropertiesTargetParameterはいメッセージのフィルタリングに使用されるプロパティ。
ValueStringはい
{
  "key": "value"
}
変換前の値。
FormStringいいえTEMPLATE変換方法。
TemplateStringはいThe value of ${key} is ${value}!イベントを変換するためのテンプレート。
KeysTargetParameterはいメッセージのフィルタリングに使用されるプロパティ。
ValueStringはい
{
  "key": "value"
}
変換前の値。
FormStringいいえTEMPLATE変換方法。
TemplateStringはいThe value of ${key} is ${value}!イベントを変換するためのテンプレート。
TagsTargetParameterはいメッセージのフィルタリングに使用されるプロパティ。
ValueStringはい
{
  "key": "value"
}
変換前の値。
FormStringいいえTEMPLATE変換方法。
TemplateStringはいThe value of ${key} is ${value}!イベントを変換するためのテンプレート。

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

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

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

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

ValueStringはいa_exchangeRabbitMQ for ApsaraMQ インスタンスの交換の名前。 詳細については、ApsaraMQ 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

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

パラメータータイプ必須説明
RoleNameStringはいtestRoleロールの名前。 EventBridge がこのロールを使用してログサービスのログを読み取ることを承認するには、RAM コンソールでロールを作成するときに、[選択された信頼できるエンティティ] パラメーターで [Alibaba Cloud サービス] を選択し、[信頼できるサービスの選択] パラメーターで [EventBridge] を選択する必要があります。

レスポンスパラメーター

イベントストリームの情報が変更された場合、HTTP ステータスコード 200 が返され、レスポンスボディは返されません。

以下のサンプルリクエストとレスポンスでは、イベントストリームのイベントターゲットが RabbitMQ for ApsaraMQ に変更されています。

サンプルリクエスト

POST /eventstreaming/updateEventStreaming 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":"rocketmq2rabbitmq", // 説明
    "FilterPattern":"{}", // フィルターパターン
    "Source":{ // イベントソース
        "SourceRocketMQParameters":{ // RocketMQ イベントソースパラメーター
            "InstanceId":"MQ_INST_164901546557****_BAAN****", // インスタンスID
            "GroupID":"GID_group1", // グループID
            "Topic":"mytopic", // トピック名
            "Offset":"CONSUME_FROM_LAST_OFFSET", // オフセット
            "Tag":"", // タグ
            "RegionId":"cn-hangzhou" // リージョンID
        }
    },
    "Sink":{ // イベントターゲット
        "SinkRabbitMQParameters":{ // RabbitMQ イベントターゲットパラメーター
            "InstanceId":{ // インスタンスID
                "Value":"amqp-cn-2r42e73o****", // 値
                "Form":"CONSTANT" // 形式
            },
            "VirtualHostName":{ // 仮想ホスト名
                "Value":"dlq", // 値
                "Form":"CONSTANT" // 形式
            },
            "TargetType":{ // ターゲットタイプ
                "Value":"Exchange", // 値
                "Form":"CONSTANT" // 形式
            },
            "Exchange":{ // 交換
                "Value":"a_exchange", // 値
                "Form":"CONSTANT" // 形式
            },
            "RoutingKey":{ // ルーティングキー
                "Value":"housekeeping", // 値
                "Form":"JSONPATH" // 形式
            },
            "Body":{ // メッセージ本文
                "Value":"{\n  \"key\": \"value\"\n}", // 値
                "Form":"TEMPLATE", // 形式
                "Template":"The value of ${key} is ${value}." // テンプレート
            },
            "MessageId":{ // メッセージID
                "Value":"message_001", // 値
                "Form":"JSONPATH" // 形式
            },
            "Properties":{ // プロパティ
                "Value":"systemProperties", // 値
                "Form":"JSONPATH" // 形式
            }
        }
    },
    "RunOptions":{ // 実行オプション
        "ErrorsTolerance":"ALL", // エラー許容範囲
        "RetryStrategy":{ // 再試行戦略
            "PushRetryStrategy":"BACKOFF_RETRY" // プッシュ再試行戦略
        }
    }
}

サンプルレスポンス

HTTP/1.1 200 OK
Server: AliyunEventBridge
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 79
x-eventbridge-request-id: D232C031-7CDC-1FEF-BB88-5F4522A8****
Date: Sat, 18 Apr 2020 05:30:41 GMT

{
    "code":"200", // コード
    "data":{ // データ
        "RequestId":"D232C031-7CDC-1FEF-BB88-5F4522A8****", // リクエストID
        "Data":true, // データ
        "Code":"Success", // コード
        "Success":true // 成功
    },
    "httpStatusCode":"200", // HTTPステータスコード
    "requestId":"D232C031-7CDC-1FEF-BB88-5F4522A8****", // リクエストID
    "successResponse":true // 成功レスポンス
}