Skip to main content

​
PUT (/sessions//scids//data/,)

ファイルをアップロードします。データは、データとメタデータを 1 つのメッセージで送信する完全アップロード、または一連の小さいブロックで送信するマルチブロック アップロードでアップロードできます。1 つのメッセージとして送信できるのは、4 メガバイト未満のファイルのみです。json タイプのデータではマルチブロック アップロードはサポートされません。 これらの URI のドメインは titlestorage.xboxlive.com です。

​
URI パラメーター

​
認可

リクエストには、有効な XBOX LIVE 認可ヘッダーを含める必要があります。呼び出し元がこのリソースへのアクセスを許可されていない場合、サービスは 403 Forbidden レスポンスを返します。ヘッダーが無効または欠落している場合、サービスは 401 Unauthorized レスポンスを返します。

​
オプションのクエリ文字列パラメーター

1 つのメッセージのアップロードの場合、クエリ文字列パラメーターは次のとおりです。 | パラメーター | 型 | 説明 | | --- | --- | --- | --- | --- | --- | | clientFileTime| DateTime| 最後にファイルをアップロードしたクライアント上のファイルの日付/時刻。| | displayName| string| ユーザーに表示するファイルの名前。| マルチブロック アップロードの場合、クエリ文字列パラメーターは次のとおりです。 | パラメーター | 型 | 説明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | | clientFileTime| DateTime| 最後にファイルをアップロードしたクライアント上のファイルの日付/時刻。| | displayName| string| ユーザーに表示するファイルの名前。| | continuationToken| string| 前回のアップロード リクエストのレスポンスから返された継続トークン。これが最初のブロックの場合、これは指定しないでください。 | | finalBlock| bool| ファイルの最後のブロックの場合は true に設定します。それ以外のすべてのブロックには false に設定します。|

​
必須リクエスト ヘッダー

| ヘッダー | 値 | 説明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| 1| API コントラクト バージョン。| | Authorization| XBL3.0 x=[hash];[token]| STS 認証トークン。STSTokenString は、認証リクエストによって返されるトークンに置き換えられます。STS トークンの取得および認可ヘッダーの作成についての詳細は、Authenticating and Authorizing XBOX LIVE Services Requests を参照してください。|

​
オプションのリクエスト ヘッダー

| ヘッダー | 説明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | If-Match| 操作を完了するために、既存の項目と一致する必要のある ETag を指定します。| | If-None-Match| 操作を完了するために、既存のどの項目とも一致してはならない ETag を指定します。|

​
リクエスト本文

リクエスト本文には、アップロードするファイルの内容が含まれます。1 つのメッセージのアップロードの場合、本文はファイルの完全な内容です。マルチブロック アップロードの場合、本文はクエリ文字列パラメーターで指定されたファイルの部分です。

​
HTTP ステータス コード

サービスは、このリソースに対してこのメソッドで行われたリクエストへの応答として、このセクション内のいずれかのステータス コードを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、標準 HTTP ステータス コード を参照してください。 | コード | 理由 | 説明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK | リクエストは成功しました。| | 201| Created | エンティティが作成されました。| | 400| Bad Request | サービスが不正な形式のリクエストを認識できませんでした。通常は無効なパラメーターです。| | 401| Unauthorized | リクエストにはユーザー認証が必要です。| | 403| Forbidden | このリクエストは、ユーザーまたはサービスに対して許可されていません。| | 404| Not Found | 指定されたリソースが見つかりませんでした。| | 406| Not Acceptable | リソース バージョンがサポートされていません。| | 408| Request Timeout | リクエストの完了に時間がかかりすぎました。| | 500| Internal Server Error | サーバーで予期しない状況が発生し、リクエストを実行できませんでした。| | 503| Service Unavailable | リクエストがスロットリングされました。client-retry の値 (秒数) を経過してからリクエストを再試行してください (例: 5 秒後)。|

​
レスポンス本文

呼び出しがマルチブロック リクエストで成功した場合、サービスは次のブロックとともに渡す継続トークンを返します。

​
サンプル レスポンス

​
関連項目

親
/sessions//scids//data/,
Last modified on October 19, 2026