ユーザーの一覧表示

  • [アーティクル]

特定のデータベースのユーザー リソース (つまり users URI パス) に GET を実行すると、データベースのユーザーの一覧が返されます。

Request

Method 要求 URI 説明
GET https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users {databaseaccount} は、サブスクリプションの下に作成された Azure Cosmos DB アカウントの名前です。 {db-id} 値は、システムによって生成された ID (rid) ではなく、データベースのユーザーによって生成された名前/ID です。

ヘッダー

すべての Cosmos DB 要求 で使用されるヘッダーについては、「共通の Azure Cosmos DB REST 要求ヘッダー」を参照してください。

本文

なし。

[応答]

ヘッダー

すべての Cosmos DB 応答によって返されるヘッダーについては、「 共通の Azure Cosmos DB REST 応答ヘッダー 」を参照してください。

状態コード

次の表に、この操作で返される一般的なステータス コードを示します。 状態コードの完全な一覧については、「 HTTP 状態コード」を参照してください。

HTTP 状態コード 説明
200 Ok 操作に成功しました。

Body

プロパティ Description
_解消 これは、ユーザーが作成されたデータベースのリソース ID です。
_カウント このプロパティは、一覧表示操作の一部として返されるユーザーの数を示します。
ユーザー これは、リスト操作の一部として返されるユーザーを含む配列です。

ユーザー リソースのプロパティ
id ユーザーによって生成されるユーザーの一意の名前。
_解消 これは、システムによって生成されるプロパティです。 リソース ID (_rid) は、リソース モデル上のリソース スタックごとに階層化された一意識別子です。 ユーザー リソースの配置およびナビゲーションのために内部的に使用されます。
_Ts これは、システムによって生成されるプロパティです。 リソースの最終更新タイムスタンプを示します。 値は、タイムスタンプです。
_自己 これは、システムによって生成されるプロパティです。 リソースの一意のアドレス指定が可能な URI です。
_Etag これは、オプティミスティック コンカレンシー制御に必要なリソース etag を表すシステム生成プロパティです。
_アクセス 許可 これは、アクセス許可リソースのアドレス指定可能パスを指定するシステム生成プロパティです。 
{  
    "_rid": "Sl8fAA==",  
    "Users": [{  
        "id": "a_user",  
        "_rid": "Sl8fAFEKCQA=",  
        "_ts": 1449603893,  
        "_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",  
        "_etag": "\"00000b00-0000-0000-0000-566733350000\"",  
        "_permissions": "permissions\/"  
    }],  
    "_count": 1  
}

例

GET https://contosomarketing.documents.azure.com/dbs/volcanodb/users HTTP/1.1  
x-ms-date: Tue, 08 Dec 2015 19:47:28 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3due2e%2fHxTsLU%2fEftrjRd176ku%2bKC5efuw8CHzy7B4%2bTc%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
Host: contosomarketing.documents.azure.com  
Connection: Keep-Alive  
  

HTTP/1.1 200 Ok  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Content-Type: application/json  
Content-Location: https://contosomarketing.documents.azure.com/dbs/volcanodb/users  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Sun, 29 Nov 2015 02:25:34.442 GMT  
x-ms-resource-quota: users=500000;  
x-ms-resource-usage: users=2;  
x-ms-item-count: 1  
x-ms-schemaversion: 1.1  
x-ms-alt-content-path: dbs/volcanodb  
x-ms-content-path: Sl8fAA==  
x-ms-session-token: 862  
x-ms-request-charge: 2  
x-ms-serviceversion: version=1.5.57.3  
x-ms-activity-id: ed9bf479-65fe-48f6-923f-572920b57c21  
x-ms-gatewayversion: version=1.5.57.3  
Date: Tue, 08 Dec 2015 19:47:28 GMT  
Content-Length: 224  
  
{  
    "_rid": "Sl8fAA==",  
    "Users": [{  
        "id": "a_user",  
        "_rid": "Sl8fAFEKCQA=",  
        "_ts": 1449603893,  
        "_self": "dbs\/Sl8fAA==\/users\/Sl8fAFEKCQA=\/",  
        "_etag": "\"00000b00-0000-0000-0000-566733350000\"",  
        "_permissions": "permissions\/"  
    }],  
    "_count": 1  
}

参照