UserProxy الفصل

واجهة للتفاعل مع مستخدم معين.

يجب عدم إنشاء مثيل لهذه الفئة مباشرة. بدلا من ذلك، استخدم get_user_client الأسلوب .

توريث

builtins.object

UserProxy

الدالمنشئ

UserProxy(client_connection: CosmosClientConnection, id: str, database_link: str, properties: Dict[str, Any] = None)

المعلمات

client_connection

id

database_link

properties

القيمة الافتراضية: None

الأساليب

create_permission	إنشاء إذن للمستخدم. لتحديث إذن موجود أو استبداله upsert_permission ، استخدم الأسلوب .
delete_permission	احذف الإذن المحدد من المستخدم. إذا لم يكن الإذن موجودا بالفعل، يتم رفع استثناء.
get_permission	احصل على الإذن الذي تم تحديده بواسطة المعرف.
list_permissions	سرد كافة الأذونات للمستخدم.
query_permissions	إرجاع كافة الأذونات المطابقة للاستعلام المحدد.
read	قراءة خصائص المستخدم.
replace_permission	يستبدل الإذن المحدد إذا كان موجودا للمستخدم. إذا لم يكن الإذن موجودا بالفعل، يتم رفع استثناء.
upsert_permission	إدراج الإذن المحدد أو تحديثه. إذا كان الإذن موجودا بالفعل في الحاوية، يتم استبداله. إذا لم يكن الإذن موجودا، يتم إدراجه.

create_permission

إنشاء إذن للمستخدم.

لتحديث إذن موجود أو استبداله upsert_permission ، استخدم الأسلوب .

async create_permission(body: Dict[str, Any], **kwargs: Any) -> Permission

المعلمات

body

Dict[str, Any]

مطلوب

كائن يشبه الإملاء يمثل إذن الإنشاء.

response_hook

Callable[[Dict[str, str], Dict[str, Any]], None]

استدعاء مع بيانات تعريف الاستجابة.

المرتجعات

عنصر إذن يمثل الإذن الجديد.

نوع الإرجاع

Permission

استثناءات

CosmosHttpResponseError

إذا تعذر إنشاء الإذن المحدد.

delete_permission

احذف الإذن المحدد من المستخدم.

إذا لم يكن الإذن موجودا بالفعل، يتم رفع استثناء.

async delete_permission(permission: str | Dict[str, Any] | Permission, **kwargs: Any) -> None

المعلمات

permission

Union[str, Dict[str, Any], Permission]

مطلوب

المعرف (الاسم)، الإملاء الذي يمثل خصائص أو <xref:azure.cosmos.aio.Permission> مثيل الإذن المراد حذفه.

response_hook

Callable[[Dict[str, str], None], None]

استدعاء مع بيانات تعريف الاستجابة.

نوع الإرجاع

None

استثناءات

CosmosHttpResponseError

لم يتم حذف الإذن بنجاح.

CosmosResourceNotFoundError

الإذن غير موجود للمستخدم.

get_permission

احصل على الإذن الذي تم تحديده بواسطة المعرف.

async get_permission(permission: str | Dict[str, Any] | Permission, **kwargs: Any) -> Permission

المعلمات

permission

Union[str, Dict[str, Any], Permission]

مطلوب

المعرف (الاسم)، الإملاء الذي يمثل خصائص أو <xref:azure.cosmos.aio.Permission> مثيل الإذن المراد استرداده.

response_hook

Callable[[Dict[str, str], Dict[str, Any]], None]

استدعاء مع بيانات تعريف الاستجابة.

المرتجعات

كائن الإذن الذي تم استرداده.

نوع الإرجاع

Permission

استثناءات

CosmosHttpResponseError

إذا تعذر استرداد الإذن المحدد.

list_permissions

سرد كافة الأذونات للمستخدم.

list_permissions(**kwargs: Any) -> AsyncItemPaged[Dict[str, Any]]

المعلمات

max_item_count

int

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

response_hook

Callable[[Dict[str, str], <xref:AsyncItemPaged>[Dict[str, Any]], None]

استدعاء مع بيانات تعريف الاستجابة.

المرتجعات

AsyncItemPaged من الأذونات (الإملاءات).

نوع الإرجاع

<xref:AsyncItemPaged>[Dict[str, Any]]

استثناءات

CosmosHttpResponseError

إذا تعذر إنشاء الإذن المحدد.

query_permissions

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

query_permissions(query: str | Dict[str, Any], **kwargs: Any) -> AsyncItemPaged[Dict[str, Any]]

المعلمات

query

Union[str, Dict[str, Any]]

مطلوب

استعلام Azure Cosmos DB SQL المراد تنفيذه.

parameters

Optional[List[Dict[str, Any]]]

صفيف اختياري من المعلمات للاستعلام. يتم تجاهله إذا لم يتم توفير استعلام.

max_item_count

int

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

response_hook

Callable[[Dict[str, str], <xref:AsyncItemPaged>[Dict[str, Any]]], None]

استدعاء مع بيانات تعريف الاستجابة.

المرتجعات

AsyncItemPaged من الأذونات (الإملاءات).

نوع الإرجاع

<xref:AsyncItemPaged>[Dict[str, Any]]

استثناءات

CosmosHttpResponseError

إذا تعذر إنشاء الإذن المحدد.

read

قراءة خصائص المستخدم.

async read(**kwargs: Any) -> Dict[str, Any]

المعلمات

response_hook

Callable[[Dict[str, str], Dict[str, Any]], None]

استدعاء مع بيانات تعريف الاستجابة.

المرتجعات

قاموس لخصائص المستخدم المستردة.

نوع الإرجاع

Dict[str, Any]

استثناءات

CosmosHttpResponseError

إذا تعذر استرداد المستخدم المحدد.

replace_permission

يستبدل الإذن المحدد إذا كان موجودا للمستخدم.

إذا لم يكن الإذن موجودا بالفعل، يتم رفع استثناء.

async replace_permission(permission: str | Dict[str, Any] | Permission, body: Dict[str, Any], **kwargs: Any) -> Permission

المعلمات

permission

Union[str, Dict[str, Any], Permission]

مطلوب

المعرف (الاسم)، الإملاء الذي يمثل خصائص أو <xref:azure.cosmos.aio.Permission> مثيل الإذن المراد استبداله.

body

Dict[str, Any]

مطلوب

كائن يشبه الإملاء يمثل الإذن لاستبداله.

response_hook

Callable[[Dict[str, str], Dict[str, Any]], None]

استدعاء مع بيانات تعريف الاستجابة.

المرتجعات

عنصر إذن يمثل الإذن بعد أن تم استبداله.

نوع الإرجاع

Permission

استثناءات

CosmosHttpResponseError

إذا فشل استبدال أو لم يكن الإذن بمعرف معين موجودا.

upsert_permission

إدراج الإذن المحدد أو تحديثه.

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

async upsert_permission(body: Dict[str, Any], **kwargs: Any) -> Permission

المعلمات

body

Dict[str, Any]

مطلوب

كائن يشبه الإملاء يمثل الإذن للتحديث أو الإدراج.

response_hook

Callable[[Dict[str, str], Dict[str, Any]], None]

استدعاء مع بيانات تعريف الاستجابة.

المرتجعات

إملاء يمثل الإذن الذي تمت إعادة إدراجه.

نوع الإرجاع

Permission

استثناءات

CosmosHttpResponseError

إذا تعذر رفع الإذن المحدد.