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

Resource Orchestration Service:ALIYUN::SLS::コンシューマーグループ

最終更新日:Mar 17, 2025

ALIYUN::SLS::ConsumerGroup は、ログストアのコンシューマーグループを作成するために使用されます。

構文

{
  "Type": "ALIYUN::SLS::ConsumerGroup",
  "Properties": {
    "ConsumerGroup": String,
    "Logstore": String,
    "Order": Boolean,
    "Project": String,
    "Timeout": Integer
  }
}

プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

ConsumerGroup

String

はい

いいえ

コンシューマーグループの名前。

名前はプロジェクト内で一意である必要があります。

Logstore

String

はい

いいえ

ログストア名。

なし。

Order

Boolean

はい

はい

データを順番に処理するかどうかを指定します。

有効な値:

  • true:データを順番に処理します。

    • シャード内では、予約フィールド __tag__:__receive_time__ の値に基づいて昇順でデータが処理されます。

    • シャードが分割された場合、元のシャード内のデータが処理された後、新しいシャード内のデータが処理されます。

    • シャードがマージされた場合、元のシャード内のデータが処理された後、新しいシャード内のデータが処理されます。

  • false:データを順番に処理しません。すべてのシャード内のデータは同時に処理されます。シャードの分割後、またはシャードのマージ後に新しいシャードが生成された場合、新しいシャード内のデータはすぐに処理されます。

Project

String

はい

いいえ

プロジェクト名。

なし。

Timeout

Integer

はい

はい

タイムアウト期間。

Simple Log Service (SLS) がタイムアウト期間内にコンシューマーからハートビートを受信しない場合、SLS はコンシューマーを削除します。単位:秒。

戻り値

Fn::GetAtt

  • Project:プロジェクト名。

  • Logstore:ログストア名。

  • ConsumerGroup:コンシューマーグループの名前。

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  Order:
    Type: Boolean
    Description:
      ja: |-
        データを順番に処理するかどうかを指定します。有効な値:
        true
        シャード内では、**__tag__:__receive_time__** フィールドの値に基づいて昇順でデータが処理されます。
        シャードが分割された場合、元のシャード内のデータが最初に処理されます。その後、新しいシャード内のデータが同時に処理されます。
        シャードがマージされた場合、元のシャード内のデータが最初に処理されます。その後、新しいシャード内のデータが処理されます。
        false すべてのシャード内のデータは同時に処理されます。シャードの分割後、またはシャードのマージ後に新しいシャードが生成された場合、新しいシャード内のデータはすぐに処理されます。
    Required: true
  Project:
    Type: String
    Description:
      ja: プロジェクト名。
    Required: true
  Logstore:
    Type: String
    Description:
      ja: ログストアの名前。
    Required: true
  Timeout:
    Type: Number
    Description:
      ja: 'タイムアウト期間。サーバーがタイムアウト期間内にコンシューマーからハートビートを受信しない場合、サーバーはコンシューマーを削除します。単位:秒。'
    Required: true
    MinValue: 1
    MaxValue: 4294967295
  ConsumerGroup:
    Type: String
    Description:
      ja: コンシューマーグループの名前。名前はプロジェクト内で一意である必要があります。
    Required: true
Resources:
  SLSConsumerGroup:
    Type: ALIYUN::SLS::ConsumerGroup
    Properties:
      Order:
        Ref: Order
      Project:
        Ref: Project
      Logstore:
        Ref: Logstore
      Timeout:
        Ref: Timeout
      ConsumerGroup:
        Ref: ConsumerGroup
Outputs:
  Project:
    Description: ログストアが属するプロジェクトの名前。
    Value:
      Fn::GetAtt:
        - SLSConsumerGroup
        - Project
  Logstore:
    Description: このコンシューマーグループが属するログストアの名前。
    Value:
      Fn::GetAtt:
        - SLSConsumerGroup
        - Logstore
  ConsumerGroup:
    Description: コンシューマーグループの名前。
    Value:
      Fn::GetAtt:
        - SLSConsumerGroup
        - ConsumerGroup
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "Order": {
      "Type": "Boolean",
      "Description": {
        "ja": "データを順番に処理するかどうかを指定します。有効な値:\ntrue\nシャード内では、**__tag__:__receive_time__** フィールドの値に基づいて昇順でデータが処理されます。\nシャードが分割された場合、元のシャード内のデータが最初に処理されます。その後、新しいシャード内のデータが同時に処理されます。\nシャードがマージされた場合、元のシャード内のデータが最初に処理されます。その後、新しいシャード内のデータが処理されます。\nfalse すべてのシャード内のデータは同時に処理されます。シャードの分割後、またはシャードのマージ後に新しいシャードが生成された場合、新しいシャード内のデータはすぐに処理されます。"
      },
      "Required": true
    },
    "Project": {
      "Type": "String",
      "Description": {
        "ja": "プロジェクト名。"
      },
      "Required": true
    },
    "Logstore": {
      "Type": "String",
      "Description": {
        "ja": "ログストアの名前。"
      },
      "Required": true
    },
    "Timeout": {
      "Type": "Number",
      "Description": {
        "ja": "タイムアウト期間。サーバーがタイムアウト期間内にコンシューマーからハートビートを受信しない場合、サーバーはコンシューマーを削除します。単位:秒。"
      },
      "Required": true,
      "MinValue": 1,
      "MaxValue": 4294967295
    },
    "ConsumerGroup": {
      "Type": "String",
      "Description": {
        "ja": "コンシューマーグループの名前。名前はプロジェクト内で一意である必要があります。"
      },
      "Required": true
    }
  },
  "Resources": {
    "SLSConsumerGroup": {
      "Type": "ALIYUN::SLS::ConsumerGroup",
      "Properties": {
        "Order": {
          "Ref": "Order"
        },
        "Project": {
          "Ref": "Project"
        },
        "Logstore": {
          "Ref": "Logstore"
        },
        "Timeout": {
          "Ref": "Timeout"
        },
        "ConsumerGroup": {
          "Ref": "ConsumerGroup"
        }
      }
    }
  },
  "Outputs": {
    "Project": {
      "Description": "ログストアが属するプロジェクトの名前。",
      "Value": {
        "Fn::GetAtt": [
          "SLSConsumerGroup",
          "Project"
        ]
      }
    },
    "Logstore": {
      "Description": "このコンシューマーグループが属するログストアの名前。",
      "Value": {
        "Fn::GetAtt": [
          "SLSConsumerGroup",
          "Logstore"
        ]
      }
    },
    "ConsumerGroup": {
      "Description": "コンシューマーグループの名前。",
      "Value": {
        "Fn::GetAtt": [
          "SLSConsumerGroup",
          "ConsumerGroup"
        ]
      }
    }
  }
}