:CreateFileCompressionTask

• この API を使用する前に、Intelligent Media Management (IMM) の課金方法と料金を必ずご確認ください。

  重要 非同期タスクの完了時間は保証されません。

• ファイル数の上限：最大 80,000 個のファイルをパッケージングできます。

• ファイルサイズの上限：パッケージング前のすべてのファイルの合計サイズは 200 GB を超えることはできません。

• この機能は、OSS の標準ストレージクラスのファイルをサポートしています。他のストレージクラスのファイルをパッケージングするには、まずストレージクラスを変換してください。

• これは非同期 API です。タスクが開始されると、その情報は 7 日間保存されます。7 日が経過すると、情報は取得できなくなります。タスク情報を表示するには、返された TaskId を使用して GetTask または ListTasks 操作を呼び出します。Notification パラメーターを設定して、非同期通知メッセージでタスク情報を受信することもできます。

典型的なシナリオにおけるパッケージングルールの例

以下の例は、サンプルファイル構造に基づいて、典型的なシナリオでパッケージングルールを構成する方法を示しています：

(bucket)
├── test-dir1
│   ├── file1.txt
│   ├── file2.doc
│   ├── file3.png
│   └── my-file.json
└── test-dir2
    ├── AAA
    │   └── file.txt
    ├── AAA
    ├── file6.doc
    ├── file7.doc
    └── file8.doc

指定されたディレクトリのパッケージング

test-dir1 ディレクトリ内のすべてのファイルを test-dir という名前の指定されたディレクトリにパッケージングするには、次のパッケージングルールを使用します：

[
    {
        "URI"   : "oss://bucket/test-dir1/",
        "Alias" : "/test-dir/"
    }
]

生成された圧縮ファイルの構造は次のとおりです：

.
└── test-dir
    ├── file1.txt
    ├── file2.doc
    ├── file3.png
    └── my-file.json

指定されたプレフィックスを持つファイルのパッケージング

プレフィックスが test-dir1/file のすべてのファイルを test-dir という名前の指定されたディレクトリにパッケージングするには、次のパッケージングルールを使用します：

[
    {
        "URI"   : "oss://bucket/test-dir1/file",
        "Alias" : "/test-dir/"
    }
]

生成された圧縮ファイルの構造は次のとおりです：

.
└── test-dir
    ├── file1.txt
    ├── file2.doc
    └── file3.png

プレフィックスモードを使用してパッケージングする場合、プレフィックスがファイルとフォルダの両方に一致すると、ファイルとフォルダの両方が圧縮ファイルにパッケージングされることに注意してください。例：

[
    {
        "URI"   : "oss://bucket/test-dir2/AAA",
        "Alias" : "/AAA/"
    }
]

生成された圧縮ファイルの構造は次のとおりです：

.
└── AAA
    ├── AAA
    └── file.txt

指定されたファイルのパッケージング

プレフィックスモードを使用したくない場合は、`mode` パラメーターを設定して、指定されたファイルのみをパッケージングします：

[
    {
        "URI"   : "oss://bucket/test-dir2/AAA",
        "Alias" : "AAA",
        "mode"  : "fullname",
    },
    {
        "URI"   : "oss://bucket/test-dir1/",
        "Alias" : "/test-dir1/",
        "mode"  : "fullname",
    }
]

生成された圧縮ファイルの構造は次のとおりです：

.
├── AAA
└── test-dir1