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

Data Management:DataAgent 用のカスタム OSS バケットの設定

最終更新日:Jul 10, 2026

DataAgent では、カスタム Alibaba Cloud Object Storage Service (OSS) バケットを設定して、ローカルアップロード、セッション履歴、結果レポートを保存できます。これにより、データの保存、アクセス、保持を完全に制御できます。

ユースケース

  • データ分析ファイルの管理:アップロードしたファイル (CSV、Excel など) を指定した OSS バケットに保存し、追跡や再利用に活用します。

  • セッション履歴の永続化:セッションリプレイを保存し、過去の分析を確認したり、チームメンバーと共有したりします。

  • 結果レポートのアーカイブ:DataAgent のアーティファクト (分析レポート、可視化など) を長期保存します。OSS のダウンロードリンクを通じて共有できます。

  • ワークスペース別のデータ分離:ワークスペースごとに個別の OSS バケットを割り当て、プロジェクトレベルでデータを分離します。

設定の優先順位

DataAgent は、次の優先順位で OSS 設定を適用します:

ワークスペース OSS 設定 > グローバル OSS 設定 > 組み込み OSS 設定

  • ワークスペースレベルの設定が最優先で適用されます。

  • ワークスペース設定が存在しない場合は、グローバル設定が適用されます。

  • グローバル設定が設定されていない場合は、組み込みのデフォルトストレージが使用されます。

前提条件

  • OSS 設定のトグルが、グローバルレベルまたはワークスペースレベルで有効になっていること。

  • 保存するコンテンツタイプ (ローカルアップロード、セッション履歴、または結果レポート) を選択していること。

  • 業務サービスと同じリージョンに、標準ストレージクラスの OSS バケットがあること。

  • 必要な Resource Access Management (RAM) 権限を設定していること。

RAM 権限

OSS ストレージを設定するには、次の RAM 権限が必要です:

設定レベル

必要な RAM 権限

グローバル OSS 設定

dms:UpsertDataAgentGlobalCustomUserConfig

ワークスペース OSS 設定

dms:UpsertDataAgentCustomUserConfig

説明

AliyunDMSDataAgentFullAccess システムポリシーには、デフォルトで dms:UpsertDataAgentCustomUserConfig 権限が含まれます。dms:UpsertDataAgentGlobalCustomUserConfig 権限については、メインアカウントの所有者または管理者がカスタムポリシーを作成する必要があります。

カスタムロールの設定

DataAgent が OSS バケットにアクセスできるようにするには、カスタム RAM ロールを作成し、最小権限のポリシーを付与します。

ステップ 1:カスタムポリシーの作成

  1. RAM Policy Console にログインします。

  2. [ポリシーの作成] をクリックします。

  3. [JSON エディター] モードを選択します。

  4. 以下の「最小 OSS バケット権限」セクションから、ストレージタイプに対応するポリシー例をコピーします。

  5. ポリシー名に CustomPolicyForAliyunDataAgentAccessOss を入力します。

  6. [OK] をクリックしてポリシーを作成します。

ステップ 2:カスタムロールの作成

  1. RAM Role Console にログインします。

  2. [ロールの作成] をクリックし、信頼されたエンティティタイプとして [クラウドサービス] を選択します。

  3. [プリンシパル名] ドロップダウンリストから [Data Management/DMSEnterprise] を選択し、[OK] をクリックします。

  4. 表示されたダイアログボックスで、ロール名に CustomRoleForAliyunDataAgentAccessOss を入力し、[OK] をクリックします。

    説明

    CustomRoleForAliyunDataAgentAccessOss はロール名であり、前のステップで作成したポリシー名とは異なります。

  5. ロール一覧に戻り、ロール名をクリックして、詳細ページで[権限を付与]をクリックします。

  6. 検索して、前のステップで作成した CustomPolicyForAliyunDataAgentAccessOss ポリシーを選択します。

  7. [OK] をクリックして承認を確定します。

最小 OSS バケット権限

DataAgent は 3 種類のファイルを保存し、それぞれで必要となる OSS 権限が異なります。必要な権限のみを付与してください。

ローカルアップロード

グローバル設定とワークスペースレベル設定の両方でサポートされています。

RAM 権限

説明

oss:GetObject

アップロードしたファイルのデータを読み取ります。

oss:PutObject

ファイルをアップロードします。

oss:DeleteObject

アップロードしたファイルを削除します (オプション)。

セッション履歴ファイル

グローバル設定とワークスペースレベル設定の両方でサポートされています。

RAM 権限

説明

oss:GetObject

セッションリプレイ履歴を読み取ります。

oss:PutObject

セッション履歴ファイルをアップロードします。

oss:ListObjects

セッション履歴ファイルを一覧表示します。この権限では、リソースをバケットレベルで設定する必要があります。

結果レポートファイル

グローバル設定とワークスペースレベル設定の両方でサポートされています。

RAM 権限

説明

oss:GetObject

結果アーティファクトを読み取ります。

oss:PutObject

結果アーティファクトをアップロードします。

完全な設定例

次のポリシーは 3 つのストレージタイプすべてに対応しています。この例では、中国 (杭州) リージョンを使用します。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "oss:ListObjects"
      ],
      "Resource": "acs:oss:oss-cn-hangzhou:${your-aliyun-parent-uid}:${your-oss-bucket-name}"
    },
    {
      "Effect": "Allow",
      "Action": [
        "oss:GetObject",
        "oss:PutObject",
        "oss:DeleteObject"
      ],
      "Resource": "acs:oss:oss-cn-hangzhou:${your-aliyun-parent-uid}:${your-oss-bucket-name}/*"
    }
  ]
}
重要
  • ${your-aliyun-parent-uid} を、Alibaba Cloud メインアカウントの UID に置き換えます。

  • ${your-oss-bucket-name} を、OSS バケット名に置き換えます。

  • oss:ListObjects 権限のリソースはバケットレベル (/* サフィックスなし) に設定する必要があります。一方、その他の権限のリソースはオブジェクトレベル (/* サフィックスあり) に設定する必要があります。

CORS の設定

DataAgent の Web インターフェイスで ファイルを直接アップロードしたり、セッション履歴をリプレイしたりする必要がある場合は、オリジン間リソース共有 (CORS) ルールを設定します。OSS コンソールで、バケットに次の許可されたオリジンを追加します:

http://*.console.aliyun.com
https://*.console.aliyun.com
http://*.dms.aliyun.com
https://*.dms.aliyun.com
http://*.dms.alibabacloud.com
https://*.dms.alibabacloud.com
説明

DataAgent OpenAPI を独自の Web アプリケーションに統合する場合は、許可されたオリジンに独自ドメインも追加してください。

よくある質問

Q:OSS バケットのリージョンはどのように選べばよいですか?

A:パフォーマンスを最適化し、ネットワークコストを最小化するために、DataAgent サービスと同じリージョンを選択してください。

Q:ワークスペースごとに異なる OSS バケットを設定できますか?

A:はい。各ワークスペースには独立した OSS 設定があります。個別の設定がないワークスペースは、グローバル設定にフォールバックします。

Q:CORS を設定すると OSS バケットのセキュリティに影響しますか?

A:いいえ。CORS は、ブラウザー経由でバケットにアクセスできるドメインを指定するだけです。RAM 権限やバケットポリシーには影響しません。追加のセキュリティ対策として、Referer ホワイトリストを設定し、署名付き URL を使用してください。

Q:oss:ListObjects のリソースは、なぜバケットレベルにする必要があるのですか?

A:oss:ListObjects アクションは、バケット内のオブジェクトを一覧表示します。権限スコープは本質的にバケットレベルであるため、リソース ARN に /* サフィックスを含める必要はありません。これは OSS の RAM 権限における標準構文です。

Q:ストレージタイプを 1 つだけ設定できますか?

A:はい。必要なストレージタイプのみを有効化し、対応する権限のみを付与してください。