移動先

• リクエスト
• レスポンス
• 例

マルチパート・ファイル・アップロードのコミット

post

/essbase/rest/v1/files/upload-commit/{path}

マルチパート・ファイル・アップロードからの1つ以上のパートのアップロードをコミットします。各パートのパート番号および対応するETag (エンティティ・タグ)値を含めます。

リクエスト

サポートされているメディア・タイプ

• application/json
• application/xml

パス・パラメータ

• path(required): string
  パターン: .+

  ファイルのアップロード先にするフォルダのカタログ・パス。

問合せパラメータ

• uploadId: string

  ファイルの部分アップロード開始のアップロードID。

本体()

ファイルの部分アップロードのコミットのリクエスト本体。すべてのパート番号および対応するEtag (エンティティ・タグ)の配列を含める必要があります。例: {"1":"9ac601f6-cc23-437a-9a55-93d581a150e1","2":"9ac601f6-cc23-437a-9a55-93d581a151e1"}

ルート・スキーマ : schema

型: object

使用可能なその他のプロパティ

ソースの表示

• string

{
    "type":"object",
    "additionalProperties":{
        "type":"string"
    }
}

先頭に戻る

レスポンス

サポートされているメディア・タイプ

• application/json
• application/xml

200 レスポンス

OK

ファイルのETagを返します。

本体()

ルート・スキーマ : CommitFilePartUploadResponse

型: object

ソースの表示

• etag: string
• lastModified: string(date-time)
• opcMultipartMd5: string
• opcRequestId: string
• versionId: string

{
    "type":"object",
    "properties":{
        "opcRequestId":{
            "type":"string"
        },
        "opcMultipartMd5":{
            "type":"string"
        },
        "versionId":{
            "type":"string"
        },
        "etag":{
            "type":"string"
        },
        "lastModified":{
            "type":"string",
            "format":"date-time"
        }
    }
}

400 レスポンス

不正なリクエスト

すべてのパートのマージ中にエラーが発生しました。

500 レスポンス

サーバーの内部エラーです。

先頭に戻る

例

次の例では、マルチパート・ファイル・アップロードからEssbaseカタログへのパートのアップロードをコミットする方法を示します。入力として、パス・パラメータに宛先のカタログ・パスが必要です。問合せパラメータには、アップロードIDと、パート番号/etagのペアの配列が必要です。

この操作は、マルチパート・ファイル・アップロード・プロセスの3番目のステップです。操作のフローは、次のとおりです。

1. マルチパート・ファイル・アップロードの作成

2. ファイル・パートのアップロード

3. マルチパート・ファイル・アップロードのコミット(この例のとおり)

初期化ステップ後の任意の時点で、「マルチパート・ファイル・アップロードの中止」を使用してプロセスを終了できます。

この例では、cURLを使用して、Windowsシェル・スクリプトからREST APIにアクセスします。呼出し元ユーザーのIDおよびパスワードは変数であり、properties.bat内でその変数値が設定されています。

cURLコマンドを含むスクリプト

call properties.bat
curl -X POST "https://myserver.example.com:9001/essbase/rest/v1/files/upload-commit/users/admin/datafile.txt?uploadId=8399f4a4-6e8f-42d7-b454-b7c0ef8f56f6" -H "Accept:application/json" -H "Content-Type:application/json" -d '{"1":"c7bb3d4f4589824cea53d27fabfc044","2":"fa5873784f4df9e5e623e8b716bf2ac7"}' -u %User%:%Password%

レスポンス本体の例

{
  "etag" : "e9b5315b4a9fcc99fa6023e0a7bb2f64"
}

先頭に戻る