Biblioteca cliente de Azure Purview Share para .NET: versión 1.0.0-beta.3
Uso compartido de datos de Microsoft Purview permite compartir datos en contexto desde Azure Data Lake Storage Gen2 y cuentas de Azure Storage, tanto dentro como entre organizaciones.
Los proveedores de datos pueden usar Uso compartido de datos de Microsoft Purview para compartir sus datos directamente con otros usuarios y asociados (conocidos como consumidores de datos) sin duplicación de datos, al tiempo que administran de forma centralizada sus actividades de uso compartido desde Microsoft Purview.
Para los consumidores de datos, Uso compartido de datos de Microsoft Purview proporciona acceso casi en tiempo real a los datos compartidos con ellos por un proveedor.
Entre las funcionalidades clave proporcionadas por Uso compartido de datos de Microsoft Purview se incluyen:
- Compartir datos dentro de la organización o con asociados y clientes fuera de la organización (dentro del mismo inquilino de Azure o entre distintos inquilinos de Azure).
- Compartir datos locales de ADLS Gen2 o Blob Storage sin duplicación de datos.
- Compartir datos con varios destinatarios.
- Acceder a los datos compartidos casi en tiempo real.
- Administre las relaciones de uso compartido y realice un seguimiento de quiénes se comparten los datos con/desde para cada cuenta de ADLSGen2 o Blob Storage.
- Finalice el acceso al recurso compartido en cualquier momento.
- Experiencia flexible a través del portal de gobernanza de Microsoft Purview o a través de las API de REST.
Visite los siguientes recursos para obtener más información sobre este producto.
Código | fuentePaquete (NuGet) | Documentación del producto
Introducción
Instalar el paquete
Instale la biblioteca cliente de Microsoft Purview Share para .NET con NuGet:
dotnet add package Azure.Analytics.Purview.Sharing --prerelease
Requisitos previos
- Debe tener una suscripción de Azure y un recurso de Purview para usar este paquete.
Autenticar el cliente
Uso de Azure Active Directory
En este ejemplo se muestra el uso de DefaultAzureCredential para autenticarse mediante Azure Active Directory. Sin embargo, se aceptará cualquiera de las credenciales que ofrece Azure.Identity . Consulte la documentación de Azure.Identity para más información sobre otras credenciales.
Una vez que haya elegido y configurado la credencial, puede crear instancias de .SentSharesClient
Conceptos clave
Proveedor de datos: Un proveedor de datos es la persona que crea un recurso compartido seleccionando un origen de datos, eligiendo los archivos y carpetas con los que compartir y con quién compartirlos. Después, Microsoft Purview envía una invitación a cada consumidor de datos.
Consumidor de datos: Un consumidor de datos es la persona que acepta la invitación especificando una cuenta de almacenamiento de destino en su propia suscripción de Azure que usará para acceder a los datos compartidos.
Métodos de protocolo
Las operaciones expuestas por la biblioteca cliente de Purview Share para .NET usan métodos de protocolo para exponer las operaciones REST subyacentes. Puede obtener más información sobre cómo usar clientes de Azure SDK que usan métodos de protocolo en nuestra documentación.
Seguridad para subprocesos
Garantizamos que todos los métodos de instancia de cliente sean seguros para subprocesos e independientes entre sí (guía). Esto garantiza que la recomendación de reutilizar instancias de cliente siempre es segura, incluso entre subprocesos.
Conceptos adicionales
Opciones | de clienteAcceso a la respuesta | Operaciones | de larga duraciónControl de errores | Diagnóstico | Burla | Duración del cliente
##Examples
Ejemplos del proveedor de datos
En los ejemplos de código siguientes se muestra cómo los proveedores de datos pueden usar el SDK de Java de Microsoft Azure para Purview Sharing para administrar su actividad de uso compartido.
Crear un cliente de recurso compartido enviado
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);
Crear un recurso compartido enviado
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);
var data = new
{
shareKind = "InPlace",
properties = new
{
artifact = new
{
storeKind = "AdlsGen2Account",
storeReference = new
{
referenceName = "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Storage/storageAccounts/sharerStorageAccount",
type = "ArmResourceReference"
},
properties = new
{
paths = new[]
{
new
{
containerName = "containerName",
senderPath = "senderPath",
receiverPath = "receiverPath"
}
}
}
},
displayName = "displayName",
description = "description",
}
};
Operation<BinaryData> createResponse = await sentShareClient.CreateOrReplaceSentShareAsync(WaitUntil.Completed, "sentShareId", RequestContent.Create(data));
Obtener un recurso compartido enviado
Después de crear un recurso compartido enviado, los proveedores de datos pueden recuperarlo.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);
Response response = await sentShareClient.GetSentShareAsync("sentShareId");
Enumerar recursos compartidos enviados
Los proveedores de datos también pueden recuperar una lista de los recursos compartidos enviados que han creado.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);
List<BinaryData> response = await sentShareClient.GetAllSentSharesAsync("referenceName").ToEnumerableAsync();
Crear una invitación para compartir a un usuario
Después de crear un recurso compartido enviado, el proveedor de datos puede extender invitaciones a los consumidores que puedan ver los datos compartidos. En este ejemplo, una invitación se extiende a un individuo especificando su dirección de correo electrónico.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);
var data = new
{
invitationKind = "User",
properties = new
{
TargetEmail = "receiver@microsoft.com",
Notify = true,
}
};
Response response = await sentShareClient.CreateSentShareInvitationAsync("sentShareId", "sentShareInvitationId", RequestContent.Create(data));
Crear una invitación de recurso compartido a un servicio
Los proveedores de datos también pueden extender invitaciones a servicios o aplicaciones especificando el identificador de inquilino y el identificador de objeto del servicio. El identificador de objeto que se usa para enviar una invitación a un servicio debe ser el identificador de objeto asociado a la aplicación empresarial (no al registro de la aplicación).
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);
var data = new
{
invitationKind = "Service",
properties = new
{
TargetActiveDirectoryId = "targetActiveDirectoryId",
TargetObjectId = "targetObjectId",
}
};
Response response = await sentShareClient.CreateSentShareInvitationAsync("sentShareId", "sentShareInvitationId", RequestContent.Create(data));
Obtener una invitación de recurso compartido enviada
Después de crear una invitación de recurso compartido enviada, los proveedores de datos pueden recuperarla.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);
Response response = await sentShareClient.GetSentShareInvitationAsync("sentShareId", "sentShareInvitationId");
Enumerar invitaciones de recurso compartido enviadas
Los proveedores de datos también pueden recuperar una lista de las invitaciones de recurso compartido enviadas que han creado.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);
List<BinaryData> sentShareInvitations = await sentShareClient.GetAllSentShareInvitationsAsync("sentShareId").ToEnumerableAsync();
Eliminación de una invitación de recurso compartido enviado
Los proveedores de datos también pueden recuperar una lista de las invitaciones de recurso compartido enviadas que han creado.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);
Operation operation = await sentShareClient.DeleteSentShareInvitationAsync(WaitUntil.Completed, "sentShareId", "sentShareInvitationId");
Eliminación de un recurso compartido enviado
El proveedor de datos puede eliminar un recurso compartido enviado para dejar de compartir sus datos con todos los consumidores de datos.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var sentShareClient = new SentSharesClient(endPoint, credential);
Operation operation = await sentShareClient.DeleteSentShareAsync(WaitUntil.Completed, "sentShareId");
Ejemplos de consumidor de datos
En los ejemplos de código siguientes se muestra cómo los consumidores de datos pueden usar el SDK de Java de Microsoft Azure para Purview Sharing para administrar su actividad de uso compartido.
Creación de un cliente de recurso compartido de recepción
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);
Enumerar recursos compartidos recibidos desasociados
Para empezar a ver los datos compartidos con ellos, un consumidor de datos primero debe recuperar una lista de recursos compartidos recibidos desasociados. Dentro de esta lista, pueden identificar un recurso compartido recibido desasociado que se va a adjuntar.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);
List<BinaryData> createResponse = await receivedSharesClient.GetAllDetachedReceivedSharesAsync().ToEnumerableAsync();
Adjuntar un recurso compartido recibido
Una vez que el consumidor de datos ha identificado un recurso compartido recibido, puede adjuntar el recurso compartido recibido a una ubicación donde pueda acceder a los datos compartidos. Si el recurso compartido recibido ya está asociado, los datos compartidos serán accesibles en la nueva ubicación especificada.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);
var data = new
{
shareKind = "InPlace",
properties = new
{
sink = new
{
storeKind = "AdlsGen2Account",
storeReference = new
{
referenceName = "/subscriptions/suscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Storage/storageAccounts/receiverStorageAccount",
type = "ArmResourceReference"
},
properties = new
{
containerName = "containerName",
folder = "folder",
mountPath = "mountPath",
}
},
displayName = "displayName",
}
};
Operation<BinaryData> createResponse = await receivedSharesClient.CreateOrReplaceReceivedShareAsync(WaitUntil.Completed, "receivedShareId", RequestContent.Create(data));
Obtener un recurso compartido recibido
Un consumidor de datos puede recuperar un recurso compartido recibido individual.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);
Response operation = await receivedSharesClient.GetReceivedShareAsync("receivedShareId");
Enumerar recursos compartidos recibidos adjuntos
Los consumidores de datos también pueden recuperar una lista de sus recursos compartidos recibidos adjuntos.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);
List<BinaryData> createResponse = await receivedSharesClient.GetAllAttachedReceivedSharesAsync("referenceName").ToEnumerableAsync();
Eliminación de un recurso compartido recibido
Los consumidores de datos también pueden recuperar una lista de sus recursos compartidos recibidos adjuntos.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var receivedSharesClient = new ReceivedSharesClient(endPoint, credential);
Operation operation = await receivedSharesClient.DeleteReceivedShareAsync(WaitUntil.Completed, "receivedShareId");
Compartir ejemplos de resouce
En los ejemplos de código siguientes se muestra cómo usar el SDK de Java de Microsoft Azure para el uso compartido de Purview para ver los recursos compartidos. Un recurso compartido es el recurso subyacente desde el que un proveedor comparte datos o el destino donde un consumidor adjunta los datos compartidos con ellos.
Enumeración de recursos compartidos
Se puede recuperar una lista de recursos compartidos para ver todos los recursos de una cuenta en la que se han realizado actividades de uso compartido.
var credential = new DefaultAzureCredential();
var endPoint = new Uri("https://my-account-name.purview.azure.com/share");
var shareResourcesClient = new ShareResourcesClient(endPoint, credential);
List<BinaryData> createResponse = await shareResourcesClient.GetAllShareResourcesAsync().ToEnumerableAsync();
Solución de problemas
Configuración del registro de la consola
La manera más sencilla de ver los registros es habilitar el registro de la consola. Para crear un agente de escucha de registro del SDK de Azure que genere mensajes en la consola, use el método AzureEventSourceListener.CreateConsoleLogger.
// Setup a listener to monitor logged events.
using AzureEventSourceListener listener = AzureEventSourceListener.CreateConsoleLogger();
Para más información sobre otros mecanismos de registro, consulte aquí.
Pasos siguientes
Este SDK de cliente expone operaciones mediante métodos de protocolo, puede obtener más información sobre cómo usar clientes del SDK que usan métodos de protocolo en nuestra documentación.
Contribuir
Consulte la CONTRIBUTING.md para obtener más información sobre la compilación, las pruebas y la contribución a esta biblioteca.
Este proyecto agradece las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Contrato de licencia para el colaborador (CLA) que declara que tiene el derecho a concedernos y nos concede los derechos para usar su contribución. Para más información, visite cla.microsoft.com.
Cuando se envía una solicitud de incorporación de cambios, un bot de CLA determinará de forma automática si tiene que aportar un CLA y completar la PR adecuadamente (por ejemplo, la etiqueta, el comentario). Solo siga las instrucciones que le dará el bot. Solo será necesario que lo haga una vez en todos los repositorios con nuestro CLA.
Este proyecto ha adoptado el Código de conducta de Microsoft Open Source. Para más información, consulte las preguntas más frecuentes del código de conducta o póngase en contacto con opencode@microsoft.com si tiene cualquier otra pregunta o comentario.
Azure SDK for .NET