Compartilhar via


ShareServiceClient Classe

Definição

O ShareServiceClient permite manipular recursos e compartilhamentos do serviço de Armazenamento do Azure. A conta de armazenamento fornece o namespace de nível superior para o serviço Arquivo.

public class ShareServiceClient
type ShareServiceClient = class
Public Class ShareServiceClient
Herança
ShareServiceClient

Construtores

ShareServiceClient()

Inicializa uma nova instância da ShareServiceClient classe para zombar.

ShareServiceClient(String)

Inicializa uma nova instância da classe ShareServiceClient.

ShareServiceClient(String, ShareClientOptions)

Inicializa uma nova instância da classe ShareServiceClient.

ShareServiceClient(Uri, AzureSasCredential, ShareClientOptions)

Inicializa uma nova instância da classe ShareServiceClient.

ShareServiceClient(Uri, ShareClientOptions)

Inicializa uma nova instância da classe ShareServiceClient.

ShareServiceClient(Uri, StorageSharedKeyCredential, ShareClientOptions)

Inicializa uma nova instância da classe ShareServiceClient.

ShareServiceClient(Uri, TokenCredential, ShareClientOptions)

Inicializa uma nova instância da classe ShareServiceClient.

Observe que as operações de nível de serviço não dão suporte à autenticação de credencial de token. Esse construtor existe para permitir a construção de um ShareServiceClient que pode ser usado para derivar um ShareClient que tenha autenticação de credencial de token.

Observe também que ShareTokenIntent atualmente é necessário para autenticação de token.

Propriedades

AccountName

Obtém o nome da conta de armazenamento correspondente ao cliente do serviço de arquivo.

CanGenerateAccountSasUri

Determina se o cliente é capaz de gerar uma SAS. Se o cliente for autenticado com um StorageSharedKeyCredential.

Uri

Obtém o ponto de extremidade primário Uri do serviço de arquivo.

Métodos

CreateShare(String, ShareCreateOptions, CancellationToken)

A operação CreateShare(String, ShareCreateOptions, CancellationToken) cria um compartilhamento sob a conta especificada. Se já existir um compartilhamento com o mesmo nome, a operação falhará.

Para obter mais informações, consulte Criar Compartilhamento.

CreateShareAsync(String, ShareCreateOptions, CancellationToken)

A operação CreateShare(String, ShareCreateOptions, CancellationToken) cria um compartilhamento sob a conta especificada. Se já existir um compartilhamento com o mesmo nome, a operação falhará.

Para obter mais informações, consulte Criar Compartilhamento.

DeleteShare(String, ShareDeleteOptions, CancellationToken)

Marca o instantâneo de compartilhamento ou compartilhamento especificado para exclusão. O compartilhamento ou o compartilhamento instantâneo e todos os arquivos contidos nele são posteriormente excluídos durante a coleta de lixo, o que pode levar vários minutos.

Atualmente, esse método sempre excluirá instantâneos. Não há como especificar um valor separado para x-ms-delete-snapshots.

Para obter mais informações, consulte Excluir Compartilhamento.

DeleteShareAsync(String, ShareDeleteOptions, CancellationToken)

Marca o instantâneo de compartilhamento ou compartilhamento especificado para exclusão. O compartilhamento ou o compartilhamento instantâneo e todos os arquivos contidos nele são posteriormente excluídos durante a coleta de lixo, o que pode levar vários minutos.

Atualmente, esse método sempre excluirá instantâneos. Não há como especificar um valor separado para x-ms-delete-snapshots.

Para obter mais informações, consulte Excluir Compartilhamento.

GenerateAccountSasUri(AccountSasBuilder)

O GenerateAccountSasUri(AccountSasBuilder) retorna um Uri que gera uma SAS (Assinatura de Acesso Compartilhado) da Conta de Compartilhamento com base nas propriedades do cliente e no construtor passados. A SAS é assinada pela credencial de chave compartilhada do cliente.

Para marcar se o cliente puder assinar uma Sas de Serviço, consulte CanGenerateAccountSasUri.

Para obter mais informações, consulte Construindo uma SAS de conta.

GenerateAccountSasUri(AccountSasPermissions, DateTimeOffset, AccountSasResourceTypes)

O GenerateAccountSasUri(AccountSasPermissions, DateTimeOffset, AccountSasResourceTypes) retorna um Uri que gera uma SAS (Assinatura de Acesso Compartilhado) da Conta de Compartilhamento com base nas propriedades e parâmetros do cliente passados. A SAS é assinada pela credencial de chave compartilhada do cliente.

Para marcar se o cliente puder assinar uma Sas de Serviço, consulte CanGenerateAccountSasUri.

Para obter mais informações, consulte Construindo uma SAS de conta.

GetProperties(CancellationToken)

A GetProperties(CancellationToken) operação obtém as propriedades do serviço de arquivo de uma conta de armazenamento, incluindo propriedades para regras de Análise de Armazenamento e CORS (Compartilhamento de Recursos entre Origens).

Para obter mais informações, consulte Obter propriedades do serviço de arquivo.

GetPropertiesAsync(CancellationToken)

A GetPropertiesAsync(CancellationToken) operação obtém as propriedades do serviço de arquivo de uma conta de armazenamento, incluindo propriedades para regras de Análise de Armazenamento e CORS (Compartilhamento de Recursos entre Origens).

Para obter mais informações, consulte Obter propriedades do serviço de arquivo.

GetShareClient(String)

Crie um novo ShareClient objeto acrescentando shareName ao final de Uri. O novo ShareClient usa o mesmo pipeline de política de solicitação que o ShareServiceClient.

GetShares(ShareTraits, ShareStates, String, CancellationToken)

A GetShares(ShareTraits, ShareStates, String, CancellationToken) operação retorna uma sequência assíncrona dos compartilhamentos na conta de armazenamento. Enumerar os compartilhamentos pode fazer várias solicitações para o serviço ao buscar todos os valores.

Para obter mais informações, consulte Listar Compartilhamentos.

GetSharesAsync(ShareTraits, ShareStates, String, CancellationToken)

A GetSharesAsync(ShareTraits, ShareStates, String, CancellationToken) operação retorna uma coleção assíncrona dos compartilhamentos na conta de armazenamento. Enumerar os compartilhamentos pode fazer várias solicitações para o serviço ao buscar todos os valores.

Para obter mais informações, consulte Listar Compartilhamentos.

SetProperties(ShareServiceProperties, CancellationToken)

A SetProperties(ShareServiceProperties, CancellationToken) operação define propriedades para o ponto de extremidade de serviço arquivo de uma conta de armazenamento, incluindo propriedades para Análise de Armazenamento, regras CORS (Compartilhamento de Recursos entre Origens) e configurações de exclusão reversível. Você também pode usar essa operação para definir a versão de solicitação padrão para todas as solicitações de entrada para o serviço arquivo que não tem uma versão especificada.

Para obter mais informações, consulte Definir propriedades do serviço de arquivo.

SetPropertiesAsync(ShareServiceProperties, CancellationToken)

A SetPropertiesAsync(ShareServiceProperties, CancellationToken) operação define propriedades para o ponto de extremidade de serviço arquivo de uma conta de armazenamento, incluindo propriedades para Análise de Armazenamento, regras CORS (Compartilhamento de Recursos entre Origens) e configurações de exclusão reversível. Você também pode usar essa operação para definir a versão de solicitação padrão para todas as solicitações de entrada para o serviço arquivo que não tem uma versão especificada.

Para obter mais informações, consulte Definir propriedades do serviço de arquivo.

UndeleteShare(String, String, CancellationToken)

Restaura um Compartilhamento excluído anteriormente. Essa API só está funcional se o Share Soft Delete estiver habilitado para a conta de armazenamento associada ao compartilhamento.

UndeleteShareAsync(String, String, CancellationToken)

Restaura um Compartilhamento excluído anteriormente. Essa API só está funcional se o Share Soft Delete estiver habilitado para a conta de armazenamento associada ao compartilhamento.

Aplica-se a