次の方法で共有

GET (/sessions/{sessionId}/scids/{scid}/data/{path})

  • [アーティクル]

指定したパスにあるファイル情報の一覧を示します。 これらの URI のドメインは titlestorage.xboxlive.com です。

URI パラメーター

パラメーター 型 説明
sessionId 文字列 検索するセッションの ID。
scid GUID 検索するサービス構成の ID。
path 文字列 返されるデータ項目へのパス。 一致するすべてのディレクトリおよびサブディレクトリが返されます。 有効な文字には、大文字 (A ～ Z)、小文字 (a ～ z)、数字 (0 ～ 9)、アンダースコア (_)、およびスラッシュ (/) が含まれます。 空でもかまいません。 最大長は 256 文字です。

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

パラメーター 型 説明
skipItems int  コレクション内の N+1 の位置から項目を返します (つまり、N 個の項目をスキップします)。
continuationToken 文字列 指定された継続トークンの位置から項目を返します。 continuationToken パラメーターは、skipItems より優先されます (両方が指定された場合)。 つまり、continuationToken パラメーターが指定されている場合、skipItems パラメーターは無視されます。
maxItems int  コレクションから返される項目の最大数。これを skipItems および continuationToken と組み合わせて、特定の範囲の項目を返すことができます。 maxItems が指定されていない場合、サービスによって既定値が提供され、最後のページの結果がまだ返されていない場合でも、返される項目の数が maxItems 未満となる場合があります。

Authorization

要求には有効な Xbox LIVE 認証ヘッダーが含まれている必要があります。 呼び出し元がこのリソースへのアクセスを許可されていない場合、サービスは 403 Forbidden 応答を返します。 ヘッダーが無効または見つからない場合、サービスは 401 Unauthorized 応答を返します。

必須の要求ヘッダー

ヘッダー 値 説明
x-xbl-contract-version 1 API コントラクトのバージョン。
承認 XBL3.0 x=[hash];[token] STS 認証トークン。 STSTokenString は、認証要求から返されたトークンに置き換えられます。 STS トークンの取得および承認ヘッダーの作成の詳細については、「Xbox LIVE サービス要求の認証と承認」を参照してください。

リクエストの本文

この要求の本体で送信されるオブジェクトはありません。

HTTP ステータス コード

サービスは、このリソースに対してこのメソッドで実行された要求に応答して、このセクションのステータス コードのいずれかを返します。 Xbox Live サービスで使用される標準 HTTP ステータス コードの一覧については、「標準 HTTP ステータス コード」を参照してください。

コード 理由 説明
200 OK 要求は成功しました。
201 作成 エンティティが作成されました。
400 Bad Request サービスは無効な形式の要求を解釈できませんでした。 通常は、無効なパラメーターです。
401 未承認 要求にはユーザー認証が必要です。
403 Forbidden ユーザーまたはサービスに対して要求が許可されていません。
404 Not Found 指定されたリソースが見つかりませんでした。
406 Not Acceptable リソースのバージョンがサポートされていません。
408 Request Timeout 所定の時間内に要求を完了できませんでした。
500 サーバー内部エラー サーバーで予期しない状態が発生したため、要求は完了しませんでした。
503 サービス利用不可 要求は待機状態になりました。client-retry 値の秒数が経過してから要求を再試行してください (例: 5 秒後)。

応答の本文

呼び出しが成功した場合、サービスは TitleBlob オブジェクトの配列を返します。

サンプル応答

{
"blobs":
[
    {
        "fileName":"foo\bar\blob.txt,binary",
        "clientFileTime":"2012-01-01T01:02:03.1234567Z",
        "displayName":"Friendly Name",
        "size":12,
        "etag":"0x8CEB3E4F8F3A5BF"
    },
    {
        "fileName":"foo\bar\blob2.txt,binary",
        "displayName":"Blob 2",
        "size":4,
        "etag":"0x8CEB3FE57F1A142"
    },
    {
        "fileName":"foo\jsonblob.txt,json",
        "size":15,
        "etag":"0x8CEB40152B4A6F8"
    }
],
"pagingInfo":
    {
        "continuationToken":"54",
    }
}

関連項目

親

/sessions/{sessionId}/scids/{scid}/data/{path}

リファレンス TitleBlob (JSON)

PagingInfo (JSON)