Partager via

UserProxy Classe

  • Référence

Interface permettant d’interagir avec un utilisateur spécifique.

Cette classe ne doit pas être instanciée directement. Utilisez plutôt la get_user_client méthode .

Héritage
builtins.object
UserProxy

Constructeur

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

Paramètres

client_connection
id
database_link
properties
valeur par défaut: None

Méthodes

create_permission

Créez une autorisation pour l’utilisateur.

Pour mettre à jour ou remplacer une autorisation existante, utilisez la upsert_permission méthode .
delete_permission

Supprimez l’autorisation spécifiée de l’utilisateur.

Si l’autorisation n’existe pas déjà, une exception est levée.
get_permission

Obtenez l’autorisation identifiée par l’ID.
list_permissions

Répertorier toutes les autorisations pour l’utilisateur.
query_permissions

Retourne toutes les autorisations correspondant à la requête donnée.
read

Lire les propriétés de l’utilisateur.
replace_permission

Remplace l’autorisation spécifiée si elle existe pour l’utilisateur.

Si l’autorisation n’existe pas déjà, une exception est levée.
upsert_permission

Insérez ou mettez à jour l’autorisation spécifiée.

Si l’autorisation existe déjà dans le conteneur, elle est remplacée. Si l’autorisation n’existe pas, elle est insérée.

create_permission

Créez une autorisation pour l’utilisateur.

Pour mettre à jour ou remplacer une autorisation existante, utilisez la upsert_permission méthode .

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

Paramètres

body
Dict[str, Any]
Obligatoire

Objet de type dict qui représente l’autorisation de création.

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

Appelable avec les métadonnées de réponse.

Retours

Objet d’autorisation représentant la nouvelle autorisation.

Type de retour

Permission

Exceptions

CosmosHttpResponseError

Si l’autorisation donnée n’a pas pu être créée.

delete_permission

Supprimez l’autorisation spécifiée de l’utilisateur.

Si l’autorisation n’existe pas déjà, une exception est levée.

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

Paramètres

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

ID (nom), dict représentant les propriétés ou <xref:azure.cosmos.aio.Permission> l’instance de l’autorisation à supprimer.

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

Appelable avec les métadonnées de réponse.

Type de retour

None

Exceptions

CosmosHttpResponseError

L’autorisation n’a pas été supprimée avec succès.

CosmosResourceNotFoundError

L’autorisation n’existe pas pour l’utilisateur.

get_permission

Obtenez l’autorisation identifiée par l’ID.

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

Paramètres

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

ID (nom), dict représentant les propriétés ou <xref:azure.cosmos.aio.Permission> l’instance de l’autorisation à récupérer.

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

Appelable avec les métadonnées de réponse.

Retours

Objet d’autorisation récupéré.

Type de retour

Permission

Exceptions

CosmosHttpResponseError

Si l’autorisation donnée n’a pas pu être récupérée.

list_permissions

Répertorier toutes les autorisations pour l’utilisateur.

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

Paramètres

max_item_count
int

Nombre maximal d’autorisations à retourner dans l’opération d’énumération.

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

Appelable avec les métadonnées de réponse.

Retours

AsyncItemPaged d’autorisations (dicts).

Type de retour

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

Exceptions

CosmosHttpResponseError

Si l’autorisation donnée n’a pas pu être créée.

query_permissions

Retourne toutes les autorisations correspondant à la requête donnée.

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

Paramètres

query
Union[str, Dict[str, Any]]
Obligatoire

Requête SQL Azure Cosmos DB à exécuter.

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

Tableau facultatif de paramètres de la requête. Ignoré si aucune requête n’est fournie.

max_item_count
int

Nombre maximal d’autorisations à retourner dans l’opération d’énumération.

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

Appelable avec les métadonnées de réponse.

Retours

AsyncItemPaged d’autorisations (dicts).

Type de retour

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

Exceptions

CosmosHttpResponseError

Si l’autorisation donnée n’a pas pu être créée.

read

Lire les propriétés de l’utilisateur.

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

Paramètres

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

Appelable avec les métadonnées de réponse.

Retours

Dictionnaire des propriétés utilisateur récupérées.

Type de retour

Dict[str, Any]

Exceptions

CosmosHttpResponseError

Si l’utilisateur donné n’a pas pu être récupéré.

replace_permission

Remplace l’autorisation spécifiée si elle existe pour l’utilisateur.

Si l’autorisation n’existe pas déjà, une exception est levée.

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

Paramètres

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

ID (nom), dict représentant les propriétés ou <xref:azure.cosmos.aio.Permission> l’instance de l’autorisation à remplacer.

body
Dict[str, Any]
Obligatoire

Objet de type dict qui représente l’autorisation de remplacement.

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

Appelable avec les métadonnées de réponse.

Retours

Objet d’autorisation représentant l’autorisation après le remplacement.

Type de retour

Permission

Exceptions

CosmosHttpResponseError

Si le remplacement a échoué ou si l’autorisation avec l’ID donné n’existe pas.

upsert_permission

Insérez ou mettez à jour l’autorisation spécifiée.

Si l’autorisation existe déjà dans le conteneur, elle est remplacée. Si l’autorisation n’existe pas, elle est insérée.

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

Paramètres

body
Dict[str, Any]
Obligatoire

Objet de type dict qui représente l’autorisation de mise à jour ou d’insertion.

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

Appelable avec les métadonnées de réponse.

Retours

Dict représentant l’autorisation upserted.

Type de retour

Permission

Exceptions

CosmosHttpResponseError

Si l’autorisation donnée n’a pas pu être upserted.