すべてのプロダクト
Search

このプロダクト

    EventBridge:CreateEventSource

    ドキュメントセンター

    EventBridge:CreateEventSource

    最終更新日:Apr 23, 2026

    外部イベントソースを作成します。

    操作説明

    外部イベントソースを作成します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    eventbridge:CreateEventSource

    create

    *EventSource

    acs:eventbridge:{#regionId}:{#accountId}:eventbus/{#EventBusName}/eventsource/*

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    EventSourceName

    string

    必須

    イベントソースの名前。

    myrabbitmq.sourc
    Description

    string

    任意

    イベントソースの説明。

    Event source of the RabbitMQ type
    LinkedExternalSource

    boolean

    任意

    外部データソースに接続するかどうかを指定します。

    true
    ExternalSourceType

    string

    任意

    外部データソースのタイプ。

    RabbitMQ
    ExternalSourceConfig

    object

    任意

    外部データソースの構成。

    {\"Schedule\":\"0 */10 * * * *\",\"TimeZone\":\"GMT+0:00\"}
    EventBusName

    string

    必須

    イベントソースに関連付けられているイベントバスの名前。

    my-event-bus
    SourceMNSParameters

    object

    任意

    Message Service (MNS) イベントソースのパラメーター。このタイプでは、`RegionId`、`IsBase64Decode`、および `QueueName` パラメーターが必須です。

    RegionId

    string

    任意

    Message Service (MNS) キューが配置されているリージョン。 次のリージョンを指定できます：`cn-qingdao`、`cn-beijing`、`cn-zhangjiakou`、`cn-huhehaote`、`cn-wulanchabu`、`cn-hangzhou`、`cn-shanghai`、`cn-shenzhen`、`cn-guangzhou`、`cn-chengdu`、`cn-hongkong`、`ap-southeast-1`、`ap-southeast-2`、`ap-southeast-3`、`ap-southeast-5`、`ap-northeast-1`、`eu-central-1`、`us-west-1`、`us-east-1`、`ap-south-1`、`me-east-1`、および `cn-north-2-gov-1`。

    cn-hangzhou
    QueueName

    string

    任意

    Message Service (MNS) のキューの名前。

    MyQueue
    IsBase64Decode

    boolean

    任意

    Base64 デコードを有効にするかどうかを指定します。有効な値：`true` および `false`。

    true
    SourceRocketMQParameters

    object

    任意

    Message Queue for Apache RocketMQ イベントソースのパラメーター。

    RegionId

    string

    任意

    Message Queue for Apache RocketMQ インスタンスが存在するリージョン。

    cn-hangzhou
    InstanceId

    string

    任意

    Message Queue for Apache RocketMQ インスタンスの ID。詳細については、「使用制限」をご参照ください。

    MQ_INST_164901546557****_BAAN****

    Topic

    string

    任意

    Message Queue for Apache RocketMQ インスタンスのトピック名。詳細については、「使用制限」をご参照ください。

    mytopic
    Tag

    string

    任意

    メッセージのフィルタリングに使用されるタグ。

    test
    Offset

    string

    任意

    メッセージ消費を開始するコンシューマオフセット。有効な値：

    CONSUME_FROM_LAST_OFFSET
    Timestamp

    integer

    任意

    消費を開始する時点をタイムスタンプで指定します。このパラメーターは、`Offset` パラメーターを `CONSUME_FROM_TIMESTAMP` に設定した場合にのみ有効です。

    1636597951964
    GroupID

    string

    任意

    Message Queue for Apache RocketMQ インスタンスのコンシューマーグループ ID。

    GID-test
    InstanceType

    string

    任意

    インスタンスタイプ。有効な値：

    • Cloud_4：v4.0 インスタンス用。

    • Cloud_5：v5.0 インスタンス用。

    Cloud_4
    InstanceNetwork

    string

    任意

    このパラメーターは使用されていません。

    InstanceVpcId

    string

    任意

    VPC の ID。インスタンスが VPC にデプロイされている場合、このパラメーターは必須です。

    vpc-bp1a4gmlk31hyg6pt****
    InstanceVSwitchIds

    string

    任意

    vSwitch ID。インスタンスが VPC にデプロイされている場合、このパラメーターは必須です。

    vsw-bp10rbrt6rb6vrd89****
    InstanceSecurityGroupId

    string

    任意

    セキュリティグループ ID。インスタンスが VPC にデプロイされている場合、このパラメーターは必須です。

    sg-catalog-eventlist****
    AuthType

    string

    任意

    認証タイプ。このパラメーターを `ACL` に設定するか、空のままにすることができます。

    ACL
    InstanceEndpoint

    string

    任意

    インスタンスのエンドポイント。

    registry-vpc****.aliyuncs.com

    InstanceUsername

    string

    任意

    インスタンスのユーザー名。

    root
    InstancePassword

    string

    任意

    インスタンスのパスワード。

    ******
    SourceRabbitMQParameters

    object

    任意

    Message Queue for RabbitMQ イベントソースのパラメーター。

    RegionId

    string

    任意

    Message Queue for RabbitMQ インスタンスが存在するリージョン。

    cn-hangzhou
    InstanceId

    string

    任意

    Message Queue for RabbitMQ インスタンスの ID。詳細については、「使用制限」をご参照ください。

    amqp-cn-nif22u74****

    VirtualHostName

    string

    任意

    Message Queue for RabbitMQ インスタンスのバーチャルホスト (vhost) の名前。詳細については、「使用制限」をご参照ください。

    eb-connect

    QueueName

    string

    任意

    Message Queue for RabbitMQ インスタンスのキューの名前。詳細については、「使用制限」をご参照ください。

    demo
    SourceSLSParameters

    object

    任意

    Simple Log Service (SLS) イベントソースのパラメーター。

    Project

    string

    任意

    Simple Log Service の Log Project。

    test-project

    LogStore

    string

    任意

    Simple Log Service の Logstore。

    test-logstore

    ConsumePosition

    string

    任意

    コンシューマオフセット。消費を開始する場所を指定します。有効な値は `begin` (最小オフセット)、`end` (最大オフセット)、または特定の UNIX タイムスタンプです。

    end
    RoleName

    string

    任意

    EventBridge が Simple Log Service からログを読み取るために引き受ける RAM ロール。RAM コンソールでこのロールを作成する際、信頼できるエンティティとして Alibaba Cloud サービスを選択し、信頼できるサービスとして EventBridge を選択します。このロールの権限の詳細については、「Simple Log Service (SLS) のカスタムイベントソース」をご参照ください。

    testRole
    SourceHttpEventParameters

    object

    任意

    HTTP エンドポイントイベントソースのパラメーター。

    Type

    string

    任意

    Webhook でサポートされるプロトコル。有効な値：

    • HTTP

    • HTTPS

    • HTTP&HTTPS

    HTTPS
    Method

    array

    任意

    Webhook でサポートされる HTTP リクエストメソッド。複数のメソッドを指定できます。有効な値：

    • GET

    • POST

    • PUT

    • PATCH

    • DELETE

    • HEAD

    • OPTIONS

    • TRACE

    • CONNECT

    string

    任意

    HTTP リクエストメソッド。

    • GET

    • POST

    • PUT

    • PATCH

    • DELETE

    • HEAD

    • OPTIONS

    • TRACE

    • CONNECT

    GET
    SecurityConfig

    string

    任意

    セキュリティ設定のタイプ。有効な値：

    • none：設定は不要です。

    • ip：IP アドレス範囲。

    • referer：セキュリティドメイン名。

    none
    Ip

    array

    任意

    セキュリティ設定の IP アドレス範囲。このパラメーターは、`SecurityConfig` を `ip` に設定した場合にのみ必須です。単一の IP アドレスまたは CIDR ブロックを指定できます。

    string

    任意

    IP アドレスまたは CIDR ブロック。

    10.0.0.0/8

    Referer

    array

    任意

    セキュリティドメイン名。このパラメーターは、`SecurityConfig` を `referer` に設定した場合にのみ必須です。1 つ以上のドメイン名を指定できます。

    string

    任意

    セキュリティドメイン名。

    aliyundoc.com

    SourceScheduledEventParameters

    object

    任意

    スケジュールイベントソースのパラメーター。

    Schedule

    string

    任意

    cron 式。

    10 * * * * *
    TimeZone

    string

    任意

    cron 式が実行されるタイムゾーン。

    GMT+0:00
    UserData

    string

    任意

    ユーザー定義の JSON 文字列。

    {"a": "b"}

    SourceKafkaParameters

    object

    任意

    Message Queue for Apache Kafka イベントソースのパラメーター。

    InstanceId

    string

    任意

    インスタンス ID。

    pc-2zehmg67txzuyuuwl****
    ConsumerGroup

    string

    任意

    コンシューマーグループ ID。

    wechat_peer_****
    Topic

    string

    任意

    トピック名。

    prod_ma_dispatch_center_call_re****
    OffsetReset

    string

    任意

    コンシューマオフセットのリセットポリシー。

    latest
    RegionId

    string

    任意

    リージョン ID。

    cn-hangzhou
    MaximumTasks

    integer

    任意

    同時消費クォータ (コンシューマー数)。

    1
    Network

    string

    任意

    ネットワークタイプ。有効な値は `Default` と `PublicNetwork` です。インスタンスが VPC にある場合は、`PublicNetwork` を指定します。

    Default
    SecurityGroupId

    string

    任意

    セキュリティグループ ID。このパラメーターは、`Network` が `PublicNetwork` に設定されている場合に必須です。

    sg-8vbf66aoyp0wfzrz****
    VSwitchIds

    string

    任意

    vSwitch ID。このパラメーターは、`Network` が `PublicNetwork` に設定されている場合に必須です。

    vsw-bp127azpeirmwu4q9****
    VpcId

    string

    任意

    VPC ID。このパラメーターは、`Network` が `PublicNetwork` に設定されている場合に必須です。

    vpc-2ze5ejm986a73qq3v****
    SourceOSSEventParameters

    object

    任意

    Object Storage Service (OSS) イベントソースのパラメーター。

    EventTypes

    array

    任意

    イベントタイプのリスト。

    string

    任意

    イベントタイプ。

    StsRoleArn

    string

    任意

    セキュリティトークンサービス (STS) ロールの Alibaba Cloud リソース名 (ARN)。

    MatchRules

    array<object>

    任意

    一致ルール。

    array<object>

    任意

    イベント一致ルール。

    object

    任意

    Prefix

    string

    任意

    プレフィックス。

    Suffix

    string

    任意

    サフィックス。

    Name

    string

    任意

    名前。

    MatchState

    boolean

    任意

    一致状態。

    リクエストの例 POST /openapi/createEventSource 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

    { "EventSourceName":"myRabbitMQ.source", "Description":"RabbitMQ event source", "SourceRabbitMQParameters":{ "RegionId":"cn-hangzhou", "InstanceId":"amqp-cn-nif22u74****", "VirtualHostName":"eb-connect", "QueueName":"demo" }, "EventBusName":"my-event-bus" }

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスボディ。

    Message

    string

    リクエストが失敗した場合に返されるエラーメッセージ。

    Remote error. requestId: [A8EFABD2-95B9-1C46-9E01-xxxx], error code: [CreateRelatedResourceFailed], message: [Create related resource failed, EntityNotExist.Role : The role not exists: xxxx. \r\nRequestId : xxxx-168C-54ED-8FEB-BF11CB70AEB7]

    RequestId

    string

    リクエスト ID。

    2922208e-e1c6-43ee-bfd1-aca50263bc8a
    Data

    object

    リクエストによって返されるデータ。

    EventSourceARN

    string

    イベントソースの Alibaba Cloud リソース名 (ARN)。

    acs:eventbridge:cn-hangzhou:164901546557****:eventbus/my-event-bus/eventsource/mymns.source
    Code

    string

    レスポンスコード。

    • Success：リクエストは成功しました。

    • その他の値はエラーを示します。詳細については、「エラーコード」セクションをご参照ください。

    Success
    Success

    boolean

    リクエストが成功したかどうかを示します。`true` の値は、リクエストが成功したことを示します。

    true

    例

    成功レスポンス

    JSONJSON

    {
  "Message": " Remote error. requestId: [A8EFABD2-95B9-1C46-9E01-xxxx], error code: [CreateRelatedResourceFailed], message: [Create related resource failed, EntityNotExist.Role : The role not exists: xxxx. \\r\\nRequestId : xxxx-168C-54ED-8FEB-BF11CB70AEB7]   ",
  "RequestId": "2922208e-e1c6-43ee-bfd1-aca50263bc8a",
  "Data": {
    "EventSourceARN": "acs:eventbridge:cn-hangzhou:164901546557****:eventbus/my-event-bus/eventsource/mymns.source"
  },
  "Code": "Success",
  "Success": true
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    403 ServiceNotEnable Service not enable

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。