مشاركة عبر

Permissions class

الحزمة:
@azure/cosmos

استخدم لإنشاء كافة الأذونات واستبدالها والاستعلام عنها وقراءتها.

راجع إذن لقراءة إذن معين أو استبداله أو حذفه حسب المعرف.

الخصائص

user

الأساليب

create(PermissionDefinition, RequestOptions)

إنشاء إذن.

يمثل الإذن إذنا لكل مستخدم للوصول إلى مورد معين مثل العنصر أو الحاوية.

المثال

import { CosmosClient, PermissionDefinition, PermissionMode } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const { user } = await database.users.create({ id: "<user-id>" });

const permissionDefinition: PermissionDefinition = {
  id: "<permission-id>",
  permissionMode: PermissionMode.Read,
  resource: "<resource-url>",
};
await user.permissions.create(permissionDefinition);
query(SqlQuerySpec, FeedOptions)

الاستعلام عن كافة الأذونات.

المثال

الاستعلام عن إذن مع المعرف.

import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });

const querySpec: SqlQuerySpec = {
  query: `SELECT * FROM root r WHERE r.id = @permission`,
  parameters: [{ name: "@permission", value: "<permission-id>" }],
};
const { resources: permisssion } = await database
  .user("<user-id>")
  .permissions.query(querySpec)
  .fetchAll();
query<T>(SqlQuerySpec, FeedOptions)

الاستعلام عن كافة الأذونات.
readAll(FeedOptions)

اقرأ جميع الأذونات.

المثال

قراءة كافة الأذونات إلى صفيف.

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { database } = await client.databases.createIfNotExists({ id: "Test Database" });

const { resources: permissionList } = await database.user("user1").permissions.readAll().fetchAll();
upsert(PermissionDefinition, RequestOptions)

إدراج إذن. يمثل الإذن إذنا لكل مستخدم للوصول إلى مورد معين مثل العنصر أو الحاوية.

المثال

import { CosmosClient, PermissionDefinition, PermissionMode } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const user = database.user("<user-id>");
const permissionDefinitionToUpsert: PermissionDefinition = {
  id: "<permission-id>",
  permissionMode: PermissionMode.Read,
  resource: "<resource-url>",
};

await user.permissions.upsert(permissionDefinitionToUpsert);

تفاصيل الخاصية

user 

user: User

قيمة الخاصية

User

تفاصيل الأسلوب

create(PermissionDefinition, RequestOptions)

إنشاء إذن.

يمثل الإذن إذنا لكل مستخدم للوصول إلى مورد معين مثل العنصر أو الحاوية.

المثال

import { CosmosClient, PermissionDefinition, PermissionMode } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const { user } = await database.users.create({ id: "<user-id>" });

const permissionDefinition: PermissionDefinition = {
  id: "<permission-id>",
  permissionMode: PermissionMode.Read,
  resource: "<resource-url>",
};
await user.permissions.create(permissionDefinition);

function create(body: PermissionDefinition, options?: RequestOptions): Promise<PermissionResponse>

المعلمات

body
PermissionDefinition

يمثل نص الإذن.

options
RequestOptions

المرتجعات

Promise<PermissionResponse>

query(SqlQuerySpec, FeedOptions)

الاستعلام عن كافة الأذونات.

المثال

الاستعلام عن إذن مع المعرف.

import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });

const querySpec: SqlQuerySpec = {
  query: `SELECT * FROM root r WHERE r.id = @permission`,
  parameters: [{ name: "@permission", value: "<permission-id>" }],
};
const { resources: permisssion } = await database
  .user("<user-id>")
  .permissions.query(querySpec)
  .fetchAll();

function query(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<any>

المعلمات

query
SqlQuerySpec

تكوين الاستعلام للعملية. راجع SqlQuerySpec لمزيد من المعلومات حول كيفية تكوين استعلام.

options
FeedOptions

المرتجعات

QueryIterator<any>

query<T>(SqlQuerySpec, FeedOptions)

الاستعلام عن كافة الأذونات.

function query<T>(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<T>

المعلمات

query
SqlQuerySpec

تكوين الاستعلام للعملية. راجع SqlQuerySpec لمزيد من المعلومات حول كيفية تكوين استعلام.

options
FeedOptions

المرتجعات

QueryIterator<T>

readAll(FeedOptions)

اقرأ جميع الأذونات.

المثال

قراءة كافة الأذونات إلى صفيف.

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { database } = await client.databases.createIfNotExists({ id: "Test Database" });

const { resources: permissionList } = await database.user("user1").permissions.readAll().fetchAll();

function readAll(options?: FeedOptions): QueryIterator<PermissionDefinition & Resource>

المعلمات

options
FeedOptions

المرتجعات

QueryIterator<PermissionDefinition & Resource>

upsert(PermissionDefinition, RequestOptions)

إدراج إذن. يمثل الإذن إذنا لكل مستخدم للوصول إلى مورد معين مثل العنصر أو الحاوية.

المثال

import { CosmosClient, PermissionDefinition, PermissionMode } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const user = database.user("<user-id>");
const permissionDefinitionToUpsert: PermissionDefinition = {
  id: "<permission-id>",
  permissionMode: PermissionMode.Read,
  resource: "<resource-url>",
};

await user.permissions.upsert(permissionDefinitionToUpsert);

function upsert(body: PermissionDefinition, options?: RequestOptions): Promise<PermissionResponse>

المعلمات

body
PermissionDefinition
options
RequestOptions

المرتجعات

Promise<PermissionResponse>