liste izinleri
Belirli bir veritabanının izin kaynağını listelemek için, izinler URI yolunda kullanıcı için izin listesini döndüren bir GET işlemi gerçekleştirin. Yanıt kapsamında döndürülen ilgili izinler için tüm kaynak belirteçleri yeniden oluşturulur. Yeni belirteçler geçersiz kılınmadığı sürece varsayılan geçerlilik süresine (bir saat) sahiptir.
İstek
Yöntem | İstek URI'si | Açıklama |
---|---|---|
GET | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/users/{user-name}/permissions | {databaseaccount}, aboneliğiniz altında oluşturulan Azure Cosmos DB hesabının adıdır. {db-id} değeri, sistem tarafından oluşturulan kimlik (rid) değil, veritabanının kullanıcı tarafından oluşturulan adı/kimliğidir. {user-name} değeri kullanıcının adıdır. |
Üst Bilgiler
Tüm Azure Cosmos DB istekleri tarafından kullanılan üst bilgiler için bkz. Yaygın Azure Cosmos DBREST istek üst bilgileri.
Gövde
Yok.
Yanıt
Üst Bilgiler
Tüm Azure Cosmos DB yanıtları tarafından döndürülen üst bilgiler için bkz. Genel Azure Cosmos DB yanıt üst bilgileri.
Durum kodları
Aşağıdaki tabloda bu işlem tarafından döndürülen genel durum kodları listelenmektedir. Durum kodlarının tam listesi için bkz. HTTP Durum Kodları.
Kod | Description |
---|---|
200 Tamam | İşlem başarılı oldu. |
Gövde
Özellik | Açıklama |
---|---|
_Kurtulmak | Bu, izinlere sahip olan kullanıcının kaynak kimliğidir. |
_Sayısı | Bu özellik, liste işleminin bir parçası olarak döndürülen kullanıcı sayısını gösterir. |
İzinler | Bu, liste işleminin bir parçası olarak döndürülen izinleri içeren dizidir. |
id | Kullanıcı, izin için benzersiz bir ad oluşturdu. |
permissionMode | Kullanıcının kaynağındaki erişim modu: Tümü veya Okuma. Tümü bir kaynağa okuma, yazma ve silme erişimi sağlar. Okuma , kullanıcının kaynak üzerinde okuma erişimini kısıtlar. |
Kaynak | İzinle ilişkili kaynağın tam adreslenebilir yolu. Örneğin, dbs/volkandb/colls/volkan1. |
_Kurtulmak | Bu, sistem tarafından oluşturulan bir özelliktir. Kaynak kimliği (_rid), kaynak modelinde kaynak yığını başına da hiyerarşik olan benzersiz bir tanımlayıcıdır. Kullanıcı kaynağının yerleşimi ve gezintisi için dahili olarak kullanılır. |
_Ts | Bu, sistem tarafından oluşturulan bir özelliktir. Kaynağın son güncelleştirilmiş zaman damgasını belirtir. Değer bir zaman damgasıdır. |
_Kendini | Bu, sistem tarafından oluşturulan bir özelliktir. Kaynak için benzersiz adreslenebilir URI'dir. |
_Etag | Bu, iyimser eşzamanlılık denetimi için gereken kaynak etag'ini temsil eden sistem tarafından oluşturulan bir özelliktir. |
_Belirte -ci | Bu, belirli bir kaynak ve kullanıcı için sistem tarafından oluşturulan bir kaynak belirtecidir. |
{
"_rid": "Sl8fAG8cXgA=",
"Permissions": [{
"id": "a_permission",
"permissionMode": "Read",
"resource": "dbs/volcanodb/colls/volcano1",
"_rid": "Sl8fAG8cXgBn6Ju2GqNsAA==",
"_ts": 1449604760,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAG8cXgA=\/permissions\/Sl8fAG8cXgBn6Ju2GqNsAA==\/",
"_etag": "\"00000e00-0000-0000-0000-566736980000\"",
"_token": "type=resource&ver=1&sig=lxKlPHeqlIx2\/J02rFs3jw==;20MwFhNUO9xNOuglK9gyL18Mt5xIhbN48pzSq6FaR\/7sKFtGd6GaxCooIoPP6rYxRHUeCabHOFkbIeT4ercXk\/F1FG70QkQTD9CxDqNJx3NImgZJWErK1NlEjxkpFDV5uslhpJ4Y3JBnc72\/vlmR95TibFS0rC\/cdND0uRvoOOWXZYvVAJFKEUKyy3GTlYOxY1nKT313ZCOSUQF7kldjo9DE3XEBf8cct1uNKMILImo=;"
}],
"_count": 1
}
Örnek
GET https://contosomarketing.documents.azure.com/dbs/volcanodb/users/a_user/permissions HTTP/1.1
x-ms-date: Tue, 08 Dec 2015 20:01:24 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dIBouMlVA5x5WqHIydZ0OSYHRPAkwoliqqkAJCCeNhjw%3d
Cache-Control: no-cache
User-Agent: contoso/1.0
x-ms-version: 2015-08-06
x-ms-max-item-count: 3
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/a_user/permissions
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-last-state-change-utc: Thu, 26 Nov 2015 06:37:26.906 GMT
x-ms-resource-quota: permissions=2000000;
x-ms-resource-usage: permissions=1;
x-ms-item-count: 1
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/volcanodb/users/a_user
x-ms-content-path: Sl8fAG8cXgA=
x-ms-session-token: 866
x-ms-request-charge: 2
x-ms-serviceversion: version=1.5.57.3
x-ms-activity-id: fb0095e8-ab6b-4423-bd6f-7af9f6f6ff68
Set-Cookie: x-ms-session-token=866; Domain=contosomarketing.documents.azure.com; Path=/dbs/volcanodb/users/a_user
x-ms-gatewayversion: version=1.5.57.3
Date: Tue, 08 Dec 2015 20:01:58 GMT
Content-Length: 629
{
"_rid": "Sl8fAG8cXgA=",
"Permissions": [{
"id": "a_permission",
"permissionMode": "Read",
"resource": "dbs/volcanodb/colls/volcano1",
"_rid": "Sl8fAG8cXgBn6Ju2GqNsAA==",
"_ts": 1449604760,
"_self": "dbs\/Sl8fAA==\/users\/Sl8fAG8cXgA=\/permissions\/Sl8fAG8cXgBn6Ju2GqNsAA==\/",
"_etag": "\"00000e00-0000-0000-0000-566736980000\"",
"_token": "type=resource&ver=1&sig=lxKlPHeqlIx2\/J02rFs3jw==;20MwFhNUO9xNOuglK9gyL18Mt5xIhbN48pzSq6FaR\/7sKFtGd6GaxCooIoPP6rYxRHUeCabHOFkbIeT4ercXk\/F1FG70QkQTD9CxDqNJx3NImgZJWErK1NlEjxkpFDV5uslhpJ4Y3JBnc72\/vlmR95TibFS0rC\/cdND0uRvoOOWXZYvVAJFKEUKyy3GTlYOxY1nKT313ZCOSUQF7kldjo9DE3XEBf8cct1uNKMILImo=;"
}],
"_count": 1
}