Aracılığıyla paylaş

Permissions class

Paket:
@azure/cosmos

Tüm İzinleri oluşturmak, değiştirmek, sorgulamak ve okumak için kullanın.

Belirli bir izni kimliğe göre okumak, değiştirmek veya silmek için bkz. İzin.

Özellikler

user

Yöntemler

create(PermissionDefinition, RequestOptions)

bir izin oluşturun.

İzin, belirli bir kaynağa erişmek için Kullanıcı Başına İzni temsil eder; örneğin, Öğe veya Kapsayıcı.

Örnek

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)

Tüm izinleri sorgula.

Örnek

Kimlik ile sorgulama izni.

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)

Tüm izinleri sorgula.
readAll(FeedOptions)

Tüm izinleri okuyun.

Örnek

Diziye yönelik tüm izinleri okuyun.

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)

Bir izin verin. İzin, belirli bir kaynağa erişmek için Kullanıcı Başına İzni temsil eder; örneğin, Öğe veya Kapsayıcı.

Örnek

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);

Özellik Ayrıntıları

user 

user: User

Özellik Değeri

User

Yöntem Ayrıntıları

create(PermissionDefinition, RequestOptions)

bir izin oluşturun.

İzin, belirli bir kaynağa erişmek için Kullanıcı Başına İzni temsil eder; örneğin, Öğe veya Kapsayıcı.

Örnek

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>

Parametreler

body
PermissionDefinition

İznin gövdesini temsil eder.

options
RequestOptions

Döndürülenler

Promise<PermissionResponse>

query(SqlQuerySpec, FeedOptions)

Tüm izinleri sorgula.

Örnek

Kimlik ile sorgulama izni.

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>

Parametreler

query
SqlQuerySpec

İşlem için sorgu yapılandırması. Sorgu yapılandırma hakkında daha fazla bilgi için bkz. SqlQuerySpec.

options
FeedOptions

Döndürülenler

QueryIterator<any>

query<T>(SqlQuerySpec, FeedOptions)

Tüm izinleri sorgula.

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

Parametreler

query
SqlQuerySpec

İşlem için sorgu yapılandırması. Sorgu yapılandırma hakkında daha fazla bilgi için bkz. SqlQuerySpec.

options
FeedOptions

Döndürülenler

QueryIterator<T>

readAll(FeedOptions)

Tüm izinleri okuyun.

Örnek

Diziye yönelik tüm izinleri okuyun.

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>

Parametreler

options
FeedOptions

Döndürülenler

QueryIterator<PermissionDefinition & Resource>

upsert(PermissionDefinition, RequestOptions)

Bir izin verin. İzin, belirli bir kaynağa erişmek için Kullanıcı Başına İzni temsil eder; örneğin, Öğe veya Kapsayıcı.

Örnek

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>

Parametreler

body
PermissionDefinition
options
RequestOptions

Döndürülenler

Promise<PermissionResponse>