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

Resource Orchestration Service:ALIYUN::NAS::DataFlow

最終更新日:Jan 16, 2025

ALIYUN::NAS::DataFlow は、クラウド並列ファイルストレージ(CPFS)ファイルシステムとオブジェクトストレージサービス(OSS)バケット間のデータフローを作成するために使用されます。

構文

{
  "Type": "ALIYUN::NAS::DataFlow",
  "Properties": {
    "FsetId": String,
    "SourceStorage": String,
    "Description": String,
    "SourceSecurityType": String,
    "FileSystemId": String,
    "Throughput": Integer,
    "AutoRefreshs": List,
    "AutoRefreshPolicy": String,
    "AutoRefreshInterval": Integer
  }
}

プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

FsetId

String

はい

いいえ

ファイルセットID。

なし。

SourceStorage

String

はい

いいえ

OSSバケットのアクセスパス。

値の形式: <storage type>://<path>

値の形式の説明:

  • ストレージタイプ: OSSのみがサポートされています。

  • パス: OSSバケットの名前。次の制限が適用されます。

    • 名前には、小文字、数字、およびハイフン(-)のみを含めることができます。小文字または数字で開始および終了する必要があります。

    • 8~128文字の長さでなければなりません。

    • UTF-8でエンコードする必要があります。

    • http://またはhttps://で始めることはできません。

説明

OSSバケットは、指定されたリージョンに存在するバケットである必要があります。

Description

String

いいえ

はい

データフローの説明。

次の制限が適用されます。

  • 説明は2~128文字の長さでなければなりません。

  • 文字で開始する必要があり、http://またはhttps://で始めることはできません。

  • 文字、数字、コロン(:)、アンダースコア(_)、およびハイフン(-)を含めることができます。

SourceSecurityType

String

いいえ

いいえ

OSSバケットのセキュリティメカニズムタイプ。

セキュリティメカニズムを使用してOSSバケットにアクセスする場合は、このプロパティを指定する必要があります。

有効な値:

  • Null(デフォルト): OSSバケットには、セキュリティメカニズムなしでアクセスできます。

  • SSL: OSSバケットには、SSL証明書を使用してアクセスします。

FileSystemId

String

はい

いいえ

ファイルシステムのID。

なし。

Throughput

Integer

はい

はい

データフローの最大伝送帯域幅。

単位: MB/s。有効な値:

  • 600

  • 1200

  • 1500

説明

データフローの伝送帯域幅は、ファイルシステムのI/O帯域幅よりも小さくなければなりません。

AutoRefreshs

List

いいえ

いいえ

自動更新構成。

詳細については、「AutoRefreshs プロパティ」をご参照ください。

AutoRefreshPolicy

String

いいえ

いいえ

自動更新ポリシー。

CPFSは、ポリシーに基づいて、OSSバケット内の更新されたデータをCPFSファイルシステムにインポートします。

有効な値:

  • None(デフォルト): CPFSは、OSSバケット内の更新されたデータをCPFSファイルシステムに自動的にインポートしません。データフロータスクを実行することで、更新されたデータをインポートできます。

  • ImportChanged: CPFSは、OSSバケット内の更新されたデータをCPFSファイルシステムに自動的にインポートします。

AutoRefreshInterval

Integer

いいえ

いいえ

自動更新操作が実行される間隔。

CPFSは、指定された間隔でディレクトリに更新されたデータが存在するかどうかを確認します。更新されたデータが存在する場合、CPFSは更新されたデータを自動的にインポートします。

単位: 分。

有効な値: 5~525600。デフォルト値: 10。

AutoRefreshs 構文

"AutoRefreshs": [
  {
    "RefreshPath": String
  }
]

AutoRefreshs プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

RefreshPath

String

はい

いいえ

自動更新ディレクトリ。

CPFSは、OSSバケットのデータ変更イベントを登録し、ディレクトリに更新されたデータが存在するかどうかを確認します。更新されたデータが存在する場合、CPFSは更新されたデータを自動的にインポートします。

このプロパティはデフォルトでは空です。このプロパティを空のままにすると、CPFSはOSSバケット内の更新されたデータをCPFSファイルシステムに自動的にインポートしません。手動タスクを実行して、更新されたデータをインポートする必要があります。

次の制限が適用されます。

  • ディレクトリは2~1,024文字の長さでなければなりません。

  • UTF-8でエンコードする必要があります。

  • スラッシュ(/)で開始および終了する必要があります。

  • ディレクトリは、CPFSに存在するディレクトリであり、データフローのファイルセットディレクトリに属している必要があります。

戻り値

Fn::GetAtt

  • FileSystemId: ファイルシステムのID。

  • DataFlowId: データフローのID。

  • YAML 形式

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      FileSystemId:
        Default: cpfs-03c125afccb****
        Type: String
      FsetId:
        Default: fset-1902718ea0ae****
        Type: String
      FileSystemPath:
        Default: "/rostestfilesystempath/"
        Type: String
      SourceStorage:
        Default: oss://cpfs-data-flow-source-test-****
        Type: String
    Resources:
      DataFlow:
        Type: ALIYUN::NAS::DataFlow
        Properties:
          SourceSecurityType: SSL
          Description: ros_test_data_flow
          AutoRefreshPolicy: ImportChanged
          FileSystemId:
            Ref: FileSystemId
          FsetId:
            Ref: FsetId
          Throughput: 600
          AutoRefreshs:
          - RefreshPath:
              Ref: FileSystemPath
          AutoRefreshInterval: 10
          SourceStorage:
            Ref: SourceStorage
    Outputs:
      DataFlowId:
        Value:
          Fn::GetAtt:
          - DataFlow
          - DataFlowId
      FileSystemId:
        Value:
          Fn::GetAtt:
          - DataFlow
          - FileSystemId
  • JSON 形式

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "FileSystemId": {
          "Default": "cpfs-03c125afccb****",
          "Type": "String"
        },
        "FsetId": {
          "Default": "fset-1902718ea0ae****",
          "Type": "String"
        },
        "FileSystemPath": {
          "Default": "/rostestfilesystempath/",
          "Type": "String"
        },
        "SourceStorage": {
          "Default": "oss://cpfs-data-flow-source-test-****",
          "Type": "String"
        }
      },
      "Resources": {
        "DataFlow": {
          "Type": "ALIYUN::NAS::DataFlow",
          "Properties": {
            "SourceSecurityType": "SSL",
            "Description": "ros_test_data_flow",
            "AutoRefreshPolicy": "ImportChanged",
            "FileSystemId": {
              "Ref": "FileSystemId"
            },
            "FsetId": {
              "Ref": "FsetId"
            },
            "Throughput": 600,
            "AutoRefreshs": [
              {
                "RefreshPath": {
                  "Ref": "FileSystemPath"
                }
              }
            ],
            "AutoRefreshInterval": 10,
            "SourceStorage": {
              "Ref": "SourceStorage"
            }
          }
        }
      },
      "Outputs": {
        "DataFlowId": {
          "Value": {
            "Fn::GetAtt": [
              "DataFlow",
              "DataFlowId"
            ]
          }
        },
        "FileSystemId": {
          "Value": {
            "Fn::GetAtt": [
              "DataFlow",
              "FileSystemId"
            ]
          }
        }
      }
    }