Guia de solução de problemas do Gerenciador de Armazenamento do AzureAzure Storage Explorer troubleshooting guide

Gerenciador de Armazenamento do Microsoft Azure é um aplicativo autônomo que facilita o trabalho com os dados do armazenamento do Azure no Windows, no macOS e no Linux.Microsoft Azure Storage Explorer is a standalone app that makes it easy to work with Azure Storage data on Windows, macOS, and Linux. O aplicativo pode se conectar a contas de armazenamento hospedadas no Azure, nuvens nacionais e Azure Stack.The app can connect to storage accounts hosted on Azure, national clouds, and Azure Stack.

Este guia resume soluções para problemas que normalmente são vistos em Gerenciador de Armazenamento.This guide summarizes solutions for issues that are commonly seen in Storage Explorer.

Problemas de permissões de RBACRBAC permissions issues

O RBAC de controle de acesso baseado em função permite o gerenciamento de acesso altamente granular dos recursos do Azure combinando conjuntos de permissões em funções.Role-based access control RBAC enables highly granular access management of Azure resources by combining sets of permissions into roles. Aqui estão algumas estratégias para fazer com que o RBAC funcione de forma ideal no Gerenciador de Armazenamento.Here are some strategies to get RBAC working optimally in Storage Explorer.

Como fazer acessar meus recursos no Gerenciador de Armazenamento?How do I access my resources in Storage Explorer?

Se você estiver tendo problemas para acessar os recursos de armazenamento por meio do RBAC, talvez você não tenha atribuído as funções apropriadas.If you're having problems accessing storage resources through RBAC, you might not have been assigned the appropriate roles. As seções a seguir descrevem as permissões Gerenciador de Armazenamento atualmente exige o acesso aos recursos de armazenamento.The following sections describe the permissions Storage Explorer currently requires for access to your storage resources. Entre em contato com o administrador da conta do Azure se você não tiver certeza de que tem as funções ou permissões apropriadas.Contact your Azure account administrator if you're not sure you have the appropriate roles or permissions.

Problema de permissões de "leitura: listar/obter conta de armazenamento""Read: List/Get Storage Account(s)" permissions issue

Você deve ter permissão para listar contas de armazenamento.You must have permission to list storage accounts. Para obter essa permissão, você deve receber a função leitor .To get this permission, you must be assigned the Reader role.

Listar chaves da conta de armazenamentoList storage account keys

Gerenciador de Armazenamento também pode usar chaves de conta para autenticar solicitações.Storage Explorer can also use account keys to authenticate requests. Você pode obter acesso a chaves de conta por meio de funções mais poderosas, como a função colaborador .You can get access to account keys through more powerful roles, such as the Contributor role.

Observação

Chaves de acesso concedem permissões irrestritas a qualquer pessoa que as mantenha.Access keys grant unrestricted permissions to anyone who holds them. Portanto, não recomendamos que você entregue essas chaves para os usuários da conta.Therefore, we don't recommend that you hand out these keys to account users. Se você precisar revogar chaves de acesso, poderá gerá-las novamente a partir do portal do Azure.If you need to revoke access keys, you can regenerate them from the Azure portal.

Funções de dadosData roles

Você deve receber pelo menos uma função que conceda acesso para ler dados de recursos.You must be assigned at least one role that grants access to read data from resources. Por exemplo, se você quiser listar ou baixar BLOBs, precisará de pelo menos a função de leitor de dados de blob de armazenamento .For example, if you want to list or download blobs, you'll need at least the Storage Blob Data Reader role.

Por que preciso de uma função de camada de gerenciamento para ver meus recursos no Gerenciador de Armazenamento?Why do I need a management layer role to see my resources in Storage Explorer?

O armazenamento do Azure tem duas camadas de acesso: Gerenciamento e dados.Azure Storage has two layers of access: management and data. As assinaturas e as contas de armazenamento são acessadas por meio da camada de gerenciamento.Subscriptions and storage accounts are accessed through the management layer. Contêineres, BLOBs e outros recursos de dados são acessados por meio da camada de dados.Containers, blobs, and other data resources are accessed through the data layer. Por exemplo, se você quiser obter uma lista de suas contas de armazenamento do Azure, envie uma solicitação para o ponto de extremidade de gerenciamento.For example, if you want to get a list of your storage accounts from Azure, you send a request to the management endpoint. Se você quiser uma lista de contêineres de BLOB em uma conta, envie uma solicitação para o ponto de extremidade de serviço apropriado.If you want a list of blob containers in an account, you send a request to the appropriate service endpoint.

As funções RBAC podem conter permissões para acesso à camada de dados ou gerenciamento.RBAC roles can contain permissions for management or data layer access. A função leitor, por exemplo, concede acesso somente leitura aos recursos da camada de gerenciamento.The Reader role, for example, grants read-only access to management layer resources.

Estritamente falando, a função leitor não fornece nenhuma permissão de camada de dados e não é necessária para acessar a camada de dados.Strictly speaking, the Reader role provides no data layer permissions and isn't necessary for accessing the data layer.

Gerenciador de Armazenamento facilita o acesso aos recursos coletando as informações necessárias para se conectar aos recursos do Azure.Storage Explorer makes it easy to access your resources by gathering the necessary information to connect to your Azure resources. Por exemplo, para exibir seus contêineres de BLOB, Gerenciador de Armazenamento envia uma solicitação de "listar contêineres" para o ponto de extremidade do serviço BLOB.For example, to display your blob containers, Storage Explorer sends a "list containers" request to the blob service endpoint. Para obter esse ponto de extremidade, Gerenciador de Armazenamento pesquisa a lista de assinaturas e contas de armazenamento às quais você tem acesso.To get that endpoint, Storage Explorer searches the list of subscriptions and storage accounts you have access to. Para localizar suas assinaturas e contas de armazenamento, Gerenciador de Armazenamento também precisa acessar a camada de gerenciamento.To find your subscriptions and storage accounts, Storage Explorer also needs access to the management layer.

Se você não tiver uma função que conceda permissões de camada de gerenciamento, Gerenciador de Armazenamento não poderá obter as informações necessárias para se conectar à camada de dados.If you don’t have a role that grants any management layer permissions, Storage Explorer can’t get the information it needs to connect to the data layer.

E se eu não conseguir obter as permissões da camada de gerenciamento que preciso do meu administrador?What if I can't get the management layer permissions I need from my administrator?

No momento, não temos uma solução relacionada a RBAC para esse problema.We don't currently have an RBAC-related solution for this issue. Como alternativa, você pode solicitar um URI de SAS para anexar ao recurso.As a workaround, you can request a SAS URI to attach to your resource.

Erro: certificado autoassinado na cadeia de certificados (e erros semelhantes)Error: Self-signed certificate in certificate chain (and similar errors)

Normalmente, os erros de certificado ocorrem em uma das seguintes situações:Certificate errors typically occur in one of the following situations:

  • O aplicativo é conectado por meio de um proxy transparente, o que significa que um servidor (como o servidor da empresa) está interceptando o tráfego HTTPS, descriptografando-o e, em seguida, criptografando-o usando um certificado autoassinado.The app is connected through a transparent proxy, which means a server (such as your company server) is intercepting HTTPS traffic, decrypting it, and then encrypting it by using a self-signed certificate.
  • Você está executando um aplicativo que está injetando um certificado SSL autoassinado nas mensagens HTTPS recebidas.You're running an application that's injecting a self-signed SSL certificate into the HTTPS messages that you receive. Exemplos de aplicativos que inserem certificados incluem software antivírus e de inspeção de tráfego de rede.Examples of applications that inject certificates include antivirus and network traffic inspection software.

Quando Gerenciador de Armazenamento vê um certificado autoassinado ou não confiável, ele não sabe mais se a mensagem HTTPS recebida foi alterada.When Storage Explorer sees a self-signed or untrusted certificate, it no longer knows whether the received HTTPS message has been altered. Se você tiver uma cópia do certificado autoassinado, poderá instruir Gerenciador de Armazenamento a confiar, seguindo estas etapas:If you have a copy of the self-signed certificate, you can instruct Storage Explorer to trust it by following these steps:

  1. Obtenha uma cópia X. 509 (. cer) codificada em base-64 do certificado.Obtain a Base-64 encoded X.509 (.cer) copy of the certificate.
  2. Vá para editar > certificados SSL > importar certificadose, em seguida, use o seletor de arquivos para localizar, selecionar e abrir o arquivo. cer.Go to Edit > SSL Certificates > Import Certificates, and then use the file picker to find, select, and open the .cer file.

Esse problema também pode ocorrer se houver vários certificados (raiz e intermediário).This issue may also occur if there are multiple certificates (root and intermediate). Para corrigir esse erro, ambos os certificados devem ser adicionados.To fix this error, both certificates must be added.

Se você não tiver certeza de onde o certificado provém, siga estas etapas para encontrá-lo:If you're unsure of where the certificate is coming from, follow these steps to find it:

  1. Instale o OpenSSL.Install OpenSSL.
    • Windows: qualquer uma das versões leves deve ser suficiente.Windows: Any of the light versions should be sufficient.
    • Mac e Linux: devem ser incluídos no seu sistema operacional.Mac and Linux: Should be included with your operating system.
  2. Execute o OpenSSL.Run OpenSSL.
    • Windows: Abra o diretório de instalação, selecione /bin/ e clique duas vezes em OpenSSL. exe.Windows: Open the installation directory, select /bin/, and then double-click openssl.exe.
    • Mac e Linux: execute openssl de um terminal.Mac and Linux: Run openssl from a terminal.
  3. Execute s_client -showcerts -connect microsoft.com:443.Run s_client -showcerts -connect microsoft.com:443.
  4. Procurar certificados autoassinados.Look for self-signed certificates. Se você não tiver certeza de quais certificados são autoassinados, anote em qualquer lugar que o assunto ("s:") e ("i:") do emissor sejam os mesmos.If you're unsure of which certificates are self-signed, make note of anywhere the subject ("s:") and issuer ("i:") are the same.
  5. Quando você encontrar certificados autoassinados, para cada um, copie e cole tudo de (e incluindo) -----BEGIN CERTIFICATE----- por meio de -----END CERTIFICATE----- em um novo arquivo. cer.When you find self-signed certificates, for each one, copy and paste everything from (and including) -----BEGIN CERTIFICATE----- through -----END CERTIFICATE----- into a new .cer file.
  6. Abra Gerenciador de Armazenamento e vá para editar > certificados SSL > importar certificados.Open Storage Explorer and go to Edit > SSL Certificates > Import Certificates. Em seguida, use o seletor de arquivos para localizar, selecionar e abrir os arquivos. cer que você criou.Then use the file picker to find, select, and open the .cer files that you created.

Se você não encontrar certificados autoassinados seguindo estas etapas, entre em contato conosco por meio da ferramenta de comentários.If you can't find any self-signed certificates by following these steps, contact us through the feedback tool. Você também pode abrir Gerenciador de Armazenamento na linha de comando usando o sinalizador --ignore-certificate-errors.You can also open Storage Explorer from the command line by using the --ignore-certificate-errors flag. Quando aberto com esse sinalizador, Gerenciador de Armazenamento ignora erros de certificado.When opened with this flag, Storage Explorer ignores certificate errors.

Problemas de entradaSign-in issues

Caixa de diálogo de entrada em brancoBlank sign-in dialog box

Caixas de diálogo de entrada em branco ocorrem com mais frequência quando Serviços de Federação do Active Directory (AD FS) (AD FS) solicita Gerenciador de Armazenamento para executar um redirecionamento, o que não é suportado pelo de todos os.Blank sign-in dialog boxes most often occur when Active Directory Federation Services (AD FS) prompts Storage Explorer to perform a redirect, which is unsupported by Electron. Para contornar esse problema, você pode tentar usar o fluxo de código do dispositivo para entrar.To work around this issue, you can try to use Device Code Flow for sign-in. Para fazer isso, siga estas etapas:To do so, follow these steps:

  1. Na barra de ferramentas vertical esquerda, abra configurações.On the left vertical tool bar, open Settings. No painel configurações, vá para aplicativo > entrar.In the Settings Panel, go to Application > Sign in. Habilitar usar entrada de fluxo de código de dispositivo.Enable Use device code flow sign-in.
  2. Abra a caixa de diálogo conectar (por meio do ícone de plugue na barra vertical do lado esquerdo ou selecionando adicionar conta no painel de conta).Open the Connect dialog box (either through the plug icon on the left-side vertical bar or by selecting Add Account on the account panel).
  3. Escolha o ambiente no qual você deseja entrar.Choose the environment you want to sign in to.
  4. Escolha Entrar.Select Sign In.
  5. Siga as instruções no painel seguinte.Follow the instructions on the next panel.

Se você não puder entrar na conta que deseja usar porque seu navegador padrão já está conectado a uma conta diferente, siga um destes procedimentos:If you can't sign in to the account you want to use because your default browser is already signed in to a different account, do one of the following:

  • Copiar manualmente o link e o código para uma sessão privada do seu navegador.Manually copy the link and code into a private session of your browser.
  • Copiar manualmente o link e o código para um navegador diferente.Manually copy the link and code into a different browser.

Loop de reautenticação ou alteração de UPNReauthentication loop or UPN change

Se você estiver em um loop de reautenticação ou tiver alterado o UPN de uma de suas contas, siga estas etapas:If you're in a reauthentication loop or have changed the UPN of one of your accounts, follow these steps:

  1. Remova todas as contas e, em seguida, feche Gerenciador de Armazenamento.Remove all accounts and then close Storage Explorer.
  2. Exclua a pasta .IdentityService do seu computador.Delete the .IdentityService folder from your machine. No Windows, a pasta está localizada em C:\users\<username>\AppData\Local.On Windows, the folder is located at C:\users\<username>\AppData\Local. Para Mac e Linux, você pode encontrar a pasta na raiz do seu diretório de usuário.For Mac and Linux, you can find the folder at the root of your user directory.
  3. Se você estiver executando o Mac ou o Linux, também precisará excluir a entrada Microsoft. Developer. IdentityService do repositório de chaves do seu sistema operacional.If you're running Mac or Linux, you'll also need to delete the Microsoft.Developer.IdentityService entry from your operating system's keystore. No Mac, o keystore é o aplicativo de conjunto de chaves GNOME .On the Mac, the keystore is the Gnome Keychain application. No Linux, o aplicativo é normalmente chamado de _token_de entrada, mas o nome pode ser diferente dependendo da sua distribuição.In Linux, the application is typically called Keyring, but the name might differ depending on your distribution.

Acesso condicionalConditional Access

Devido a uma limitação na biblioteca do Azure AD usada pelo Gerenciador de Armazenamento, o acesso condicional não tem suporte quando Gerenciador de Armazenamento está sendo usado no Windows 10, Linux ou macOS.Because of a limitation in the Azure AD Library used by Storage Explorer, Conditional Access isn't supported when Storage Explorer is being used on Windows 10, Linux, or macOS.

Erros de conjunto de chaves do MacMac Keychain errors

Às vezes, o conjunto de chaves macOS pode inserir um estado que causa problemas para a biblioteca de autenticação Gerenciador de Armazenamento.The macOS Keychain can sometimes enter a state that causes issues for the Storage Explorer authentication library. Para obter o conjunto de chaves desse Estado, siga estas etapas:To get the Keychain out of this state, follow these steps:

  1. Feche o Gerenciador de Armazenamento.Close Storage Explorer.

  2. Abra o conjunto de chaves (pressione Command + barra de espaços, digite keychaine pressione Enter).Open Keychain (press Command+Spacebar, type keychain, and press Enter).

  3. Selecione o conjunto de chaves "logon".Select the "login" Keychain.

  4. Selecione o ícone de cadeado para bloquear o conjunto de chaves.Select the padlock icon to lock the Keychain. (O cadeado aparecerá bloqueado quando o processo for concluído.(The padlock will appear locked when the process is complete. Pode levar alguns segundos, dependendo de quais aplicativos você abriu).It might take a few seconds, depending on what apps you have open).

    Ícone de cadeado

  5. Abra o Explorer do Armazenamento.Open Storage Explorer.

  6. Você receberá uma mensagem como "o Hub de serviço deseja acessar o conjunto de chaves".You're prompted with a message like "Service hub wants to access the Keychain." Insira sua senha da conta de administrador do Mac e selecione sempre permitir (ou permitir se sempre permitir não estiver disponível).Enter your Mac admin account password and select Always Allow (or Allow if Always Allow isn't available).

  7. Tente entrar.Try to sign in.

Etapas gerais de solução de problemas de entradaGeneral sign-in troubleshooting steps

  • Se você estiver no macOS e a janela de entrada nunca aparecer na caixa de diálogo aguardando autenticação , tente estas etapas.If you're on macOS, and the sign-in window never appears over the Waiting for authentication dialog box, try these steps.
  • Reinicie Gerenciador de Armazenamento.Restart Storage Explorer.
  • Se a janela de autenticação estiver em branco, aguarde pelo menos um minuto antes de fechar a caixa de diálogo de autenticação.If the authentication window is blank, wait at least one minute before closing the authentication dialog box.
  • Verifique se as configurações de proxy e certificado estão configuradas corretamente para seu computador e Gerenciador de Armazenamento.Make sure that your proxy and certificate settings are properly configured for both your machine and Storage Explorer.
  • Se você estiver executando o Windows e tiver acesso ao Visual Studio 2019 no mesmo computador e às credenciais de entrada, tente entrar no Visual Studio 2019.If you're running Windows and have access to Visual Studio 2019 on the same machine and to the sign-in credentials, try signing in to Visual Studio 2019. Após uma entrada bem-sucedida no Visual Studio 2019, você pode abrir Gerenciador de Armazenamento e ver sua conta no painel de conta.After a successful sign-in to Visual Studio 2019, you can open Storage Explorer and see your account in the account panel.

Se nenhum desses métodos funcionar, abra um problema no GitHub.If none of these methods work, open an issue in GitHub.

Assinaturas ausentes e locatários desfeitosMissing subscriptions and broken tenants

Se você não puder recuperar suas assinaturas depois de entrar com êxito, tente os seguintes métodos de solução de problemas:If you can't retrieve your subscriptions after you successfully sign in, try the following troubleshooting methods:

  • Verifique se sua conta tem acesso às assinaturas que você espera.Verify that your account has access to the subscriptions you expect. Você pode verificar seu acesso entrando no portal para o ambiente do Azure que você está tentando usar.You can verify your access by signing in to the portal for the Azure environment you're trying to use.
  • Verifique se você entrou por meio do ambiente correto do Azure (Azure, Azure China 21Vianet, Azure Alemanha, governo dos EUA do Azure ou ambiente personalizado).Make sure you've signed in through the correct Azure environment (Azure, Azure China 21Vianet, Azure Germany, Azure US Government, or Custom Environment).
  • Se você estiver protegido por um servidor proxy, verifique se você configurou o Gerenciador de Armazenamento proxy corretamente.If you're behind a proxy server, make sure you've configured the Storage Explorer proxy correctly.
  • Tente remover e adicionar novamente a conta.Try removing and re-adding the account.
  • Se houver um link "mais informações", verifique quais mensagens de erro estão sendo relatadas para os locatários que estão falhando.If there's a "More information" link, check which error messages are being reported for the tenants that are failing. Se você não tiver certeza de como responder às mensagens de erro, fique à vontade para abrir um problema no GitHub.If you aren't sure how to respond to the error messages, feel free to open an issue in GitHub.

Não é possível remover uma conta anexada ou um recurso de armazenamentoCan't remove an attached account or storage resource

Se não for possível remover uma conta anexada ou um recurso de armazenamento por meio da interface do usuário, você poderá excluir manualmente todos os recursos anexados excluindo as seguintes pastas:If you can't remove an attached account or storage resource through the UI, you can manually delete all attached resources by deleting the following folders:

  • Windows: %AppData%/StorageExplorerWindows: %AppData%/StorageExplorer
  • macOS - /Users/<your_name>/Library/Application Support/StorageExplorermacOS: /Users/<your_name>/Library/Application Support/StorageExplorer
  • Linux: ~/.config/StorageExplorerLinux: ~/.config/StorageExplorer

Observação

Feche Gerenciador de Armazenamento antes de excluir essas pastas.Close Storage Explorer before you delete these folders.

Observação

Se você já importou qualquer certificado SSL, faça backup do conteúdo do diretório certs.If you have ever imported any SSL certificates, back up the contents of the certs directory. Posteriormente, você pode usar o backup para reimportar os certificados SSL.Later, you can use the backup to reimport your SSL certificates.

Problemas de proxyProxy issues

Primeiro, certifique-se de que as seguintes informações inseridas estão corretas:First, make sure that the following information you entered is correct:

  • A URL do proxy e o número da portaThe proxy URL and port number
  • Nome de usuário e senha se o proxy os exigirUsername and password if the proxy requires them

Observação

Gerenciador de Armazenamento não dá suporte a arquivos de configuração automática de proxy para definir as configurações de proxy.Storage Explorer doesn't support proxy auto-config files for configuring proxy settings.

Soluções comunsCommon solutions

Se você ainda tiver problemas, tente os seguintes métodos de solução de problemas:If you're still experiencing issues, try the following troubleshooting methods:

  • Se você puder se conectar à Internet sem usar o proxy, verifique se Gerenciador de Armazenamento funciona sem as configurações de proxy habilitadas.If you can connect to the internet without using your proxy, verify that Storage Explorer works without proxy settings enabled. Se esse for o caso, talvez haja um problema com as configurações de proxy.If this is the case, there may be an issue with your proxy settings. Trabalhe com o administrador para identificar os problemas.Work with your administrator to identify the problems.
  • Verifique se outros aplicativos que usam o servidor proxy funcionam conforme o esperado.Verify that other applications that use the proxy server work as expected.
  • Verifique se você pode se conectar ao portal para o ambiente do Azure que você está tentando usar.Verify that you can connect to the portal for the Azure environment you're trying to use.
  • Verifique se que você pode receber respostas de seus pontos de extremidade de serviço.Verify that you can receive responses from your service endpoints. Insira uma das suas URLs de ponto de extremidade em seu navegador.Enter one of your endpoint URLs into your browser. Se você puder se conectar, deverá receber InvalidQueryParameterValue ou uma resposta XML semelhante.If you can connect, you should receive InvalidQueryParameterValue or a similar XML response.
  • Se outra pessoa também estiver usando o Gerenciador de Armazenamento com o servidor proxy, verifique se eles podem se conectar.If someone else is also using Storage Explorer with your proxy server, verify that they can connect. Se puderem, talvez você precise entrar em contato com o administrador do servidor proxy.If they can, you may have to contact your proxy server admin.

Ferramentas para diagnosticar problemasTools for diagnosing issues

Se você tiver ferramentas de rede, como o Fiddler para Windows, poderá diagnosticar os problemas da seguinte maneira:If you have networking tools, such as Fiddler for Windows, you can diagnose the problems as follows:

  • Se você tiver que trabalhar por meio do proxy, será necessário configurar a ferramenta de rede para se conectar por meio do proxy.If you have to work through your proxy, you may have to configure your networking tool to connect through the proxy.

  • Verifique o número da porta usado por sua ferramenta de rede.Check the port number used by your networking tool.

  • Insira a URL do host local e o número de porta da ferramenta de rede como configurações de proxy no Gerenciador de Armazenamento.Enter the local host URL and the networking tool's port number as proxy settings in Storage Explorer. Quando você faz isso corretamente, a ferramenta de rede inicia o log de solicitações de rede feitas por Gerenciador de Armazenamento para pontos de extremidade de serviço e gerenciamento.When you do this correctly, your networking tool starts logging network requests made by Storage Explorer to management and service endpoints. Por exemplo, insira https://cawablobgrs.blob.core.windows.net/ para o ponto de extremidade de BLOB em um navegador e você receberá uma resposta semelhante à seguinte:For example, enter https://cawablobgrs.blob.core.windows.net/ for your blob endpoint in a browser, and you'll receive a response that resembles the following:

    Exemplo de código

    Essa resposta sugere que o recurso existe, embora você não possa acessá-lo.This response suggests the resource exists, even though you can't access it.

Entre em contato com o administrador do servidor proxyContact proxy server admin

Se as configurações de proxy estiverem corretas, talvez seja necessário entrar em contato com o administrador do servidor proxy para:If your proxy settings are correct, you may have to contact your proxy server admin to:

  • Verifique se o proxy não bloqueia o tráfego para os pontos de extremidade de gerenciamento ou recurso do Azure.Make sure your proxy doesn't block traffic to Azure management or resource endpoints.
  • Verifique o protocolo de autenticação usado por seu servidor proxy.Verify the authentication protocol used by your proxy server. No momento, o Gerenciador de Armazenamento não oferece suporte a proxies NTLM.Storage Explorer doesn't currently support NTLM proxies.

Mensagem de erro "Não é Possível Recuperar Filhos""Unable to Retrieve Children" error message

Se você estiver conectado ao Azure por meio de um proxy, verifique se as configurações de proxy estão corretas.If you're connected to Azure through a proxy, verify that your proxy settings are correct. Se você tiver acesso a um recurso do proprietário da assinatura ou da conta, verifique se você tem permissões de leitura ou de lista para esse recurso.If you're granted access to a resource from the owner of the subscription or account, verify that you have read or list permissions for that resource.

A cadeia de conexão não tem definições de configuração completasConnection string doesn't have complete configuration settings

Se você receber essa mensagem de erro, é possível que você não tenha as permissões necessárias para obter as chaves para sua conta de armazenamento.If you receive this error message, it's possible that you don't have the necessary permissions to obtain the keys for your storage account. Para confirmar que esse é o caso, vá para o portal e localize sua conta de armazenamento.To confirm that this is the case, go to the portal and locate your storage account. Você pode fazer isso clicando com o botão direito do mouse no nó da sua conta de armazenamento e selecionando abrir no portal.You can do this by right-clicking the node for your storage account and selecting Open in Portal. Em seguida, vá para a folha chaves de acesso .Then, go to the Access Keys blade. Se você não tiver permissões para exibir chaves, verá uma mensagem "você não tem acesso".If you don't have permissions to view keys, you'll see a "You don't have access" message. Para contornar esse problema, você pode obter a chave de conta de outra pessoa e anexar por meio do nome e da chave, ou pode pedir a alguém uma SAS para a conta de armazenamento e usá-la para anexar a conta de armazenamento.To work around this issue, you can either obtain the account key from someone else and attach through the name and key, or you can ask someone for a SAS to the storage account and use it to attach the storage account.

Se você vir as chaves de conta, execute um problema no GitHub para que possamos ajudá-lo a resolver o problema.If you do see the account keys, file an issue in GitHub so that we can help you resolve the issue.

Ocorreu um erro ao adicionar uma nova conexão: TypeError: não é possível ler a propriedade ' version ' de undefinedError occurred while adding new connection: TypeError: Cannot read property 'version' of undefined

Se você receber essa mensagem de erro ao tentar adicionar uma conexão personalizada, os dados de conexão armazenados no Gerenciador de credenciais local poderão estar corrompidos.If you receive this error message when you try to add a custom connection, the connection data that's stored in the local credential manager might be corrupted. Para contornar esse problema, tente excluir as conexões locais corrompidas e, em seguida, adicione-as novamente:To work around this issue, try deleting your corrupted local connections, and then re-add them:

  1. Iniciar Gerenciador de Armazenamento.Start Storage Explorer. No menu, vá para ajuda > alternar ferramentas para desenvolvedores.From the menu, go to Help > Toggle Developer Tools.
  2. Na janela aberta, na guia aplicativo , vá para armazenamento local (lado esquerdo) > file:// .In the opened window, on the Application tab, go to Local Storage (left side) > file://.
  3. Dependendo do tipo de conexão com a qual você está tendo um problema, procure sua chave e copie seu valor em um editor de texto.Depending on the type of connection you're having an issue with, look for its key and then copy its value into a text editor. O valor é uma matriz de seus nomes de conexão personalizados, como o seguinte:The value is an array of your custom connection names, like the following:
    • Contas de armazenamentoStorage accounts
      • StorageExplorer_CustomConnections_Accounts_v1
    • Contêineres de blobBlob containers
      • StorageExplorer_CustomConnections_Blobs_v1
      • StorageExplorer_CustomConnections_Blobs_v2
    • Compartilhamentos de arquivosFile shares
      • StorageExplorer_CustomConnections_Files_v1
    • FilasQueues
      • StorageExplorer_CustomConnections_Queues_v1
    • TabelasTables
      • StorageExplorer_CustomConnections_Tables_v1
  4. Depois de salvar os nomes de conexão atuais, defina o valor em Ferramentas para Desenvolvedores como [].After you save your current connection names, set the value in Developer Tools to [].

Se desejar preservar as conexões que não estão corrompidas, você poderá usar as etapas a seguir para localizar as conexões corrompidas.If you want to preserve the connections that aren't corrupted, you can use the following steps to locate the corrupted connections. Se você não se lembrar de perder todas as conexões existentes, poderá ignorar essas etapas e seguir as instruções específicas da plataforma para limpar os dados de conexão.If you don't mind losing all existing connections, you can skip these steps and follow the platform-specific instructions to clear your connection data.

  1. Em um editor de texto, adicione novamente cada nome de conexão a Ferramentas para Desenvolvedores e, em seguida, verifique se a conexão ainda está funcionando.From a text editor, re-add each connection name to Developer Tools, and then check whether the connection is still working.
  2. Se uma conexão estiver funcionando corretamente, ela não estará corrompida e você poderá deixá-la lá com segurança.If a connection is working correctly, it's not corrupted and you can safely leave it there. Se uma conexão não estiver funcionando, remova seu valor de Ferramentas para Desenvolvedores e registre-o para que você possa adicioná-lo novamente mais tarde.If a connection isn't working, remove its value from Developer Tools, and record it so that you can add it back later.
  3. Repita até que você tenha examinado todas as suas conexões.Repeat until you have examined all your connections.

Depois de passar por todas as suas conexões, para todos os nomes de conexões que não forem adicionados de volta, você deverá limpar os dados corrompidos (se houver) e adicioná-los novamente usando as etapas padrão no Gerenciador de Armazenamento:After going through all your connections, for all connections names that aren't added back, you must clear their corrupted data (if there is any) and add them back by using the standard steps in Storage Explorer:

  1. No menu Iniciar , pesquise por Gerenciador de credenciais e abra-o.On the Start menu, search for Credential Manager and open it.
  2. Vá para credenciais do Windows.Go to Windows Credentials.
  3. Em credenciais genéricas, procure entradas que tenham a chave de <connection_type_key>/<corrupted_connection_name> (por exemplo, StorageExplorer_CustomConnections_Accounts_v1/account1).Under Generic Credentials, look for entries that have the <connection_type_key>/<corrupted_connection_name> key (for example, StorageExplorer_CustomConnections_Accounts_v1/account1).
  4. Exclua essas entradas e adicione novamente as conexões.Delete these entries and re-add the connections.

Se você ainda encontrar esse erro depois de executar essas etapas, ou se quiser compartilhar o que você suspeita que danificou as conexões, abra um problema em nossa página do github.If you still encounter this error after running these steps, or if you want to share what you suspect has corrupted the connections, open an issue on our GitHub page.

Problemas com a URL SASIssues with SAS URL

Se você estiver se conectando a um serviço por meio de uma URL SAS e ocorrendo um erro:If you're connecting to a service through a SAS URL and experiencing an error:

  • Verifique se a URL fornece as permissões necessárias para ler ou lista recursos.Verify that the URL provides the necessary permissions to read or list resources.
  • Verifique se a URL não expirou.Verify that the URL has not expired.
  • Se a URL SAS tiver base em uma política de acesso, verifique se a política de acesso não foi revogada.If the SAS URL is based on an access policy, verify that the access policy has not been revoked.

Se você anexou acidentalmente usando uma URL SAS inválida e agora não puder desanexar, siga estas etapas:If you accidentally attached by using an invalid SAS URL and now cannot detach, follow these steps:

  1. Quando estiver executando Gerenciador de Armazenamento, pressione F12 para abrir a janela Ferramentas para Desenvolvedores.When you're running Storage Explorer, press F12 to open the Developer Tools window.
  2. Na guia aplicativo , selecione armazenamento local > file:// na árvore à esquerda.On the Application tab, select Local Storage > file:// in the tree on the left.
  3. Localize a chave associada ao tipo de serviço do URI SAS problemático.Find the key associated with the service type of the problematic SAS URI. Por exemplo, se o URI da SAS incorreta for para um contêiner de blob, procure a chave nomeada StorageExplorer_AddStorageServiceSAS_v1_blob.For example, if the bad SAS URI is for a blob container, look for the key named StorageExplorer_AddStorageServiceSAS_v1_blob.
  4. O valor da chave deve ser uma matriz JSON.The value of the key should be a JSON array. Localize o objeto associado ao URI inadequado e, em seguida, exclua-o.Find the object associated with the bad URI, and then delete it.
  5. Pressione Ctrl+R para recarregar o Gerenciador de Armazenamento.Press Ctrl+R to reload Storage Explorer.

Dependências do LinuxLinux dependencies

Gerenciador de Armazenamento 1.10.0 e posterior está disponível como um snap do repositório de snap.Storage Explorer 1.10.0 and later is available as a snap from the Snap Store. O Gerenciador de Armazenamento snap instala todas as suas dependências automaticamente e é atualizado quando uma nova versão do snap está disponível.The Storage Explorer snap installs all its dependencies automatically, and it's updated when a new version of the snap is available. Instalar o Gerenciador de Armazenamento snap é o método recomendado de instalação.Installing the Storage Explorer snap is the recommended method of installation.

Gerenciador de Armazenamento requer o uso de um Gerenciador de senhas, que talvez você precise se conectar manualmente antes que Gerenciador de Armazenamento funcione corretamente.Storage Explorer requires the use of a password manager, which you might need to connect manually before Storage Explorer will work correctly. Você pode se conectar Gerenciador de Armazenamento ao Gerenciador de senhas do sistema executando o seguinte comando:You can connect Storage Explorer to your system's password manager by running the following command:

snap connect storage-explorer:password-manager-service :password-manager-service

Você também pode baixar o aplicativo como um arquivo. tar. gz, mas precisará instalar as dependências manualmente.You can also download the application as a .tar.gz file, but you'll have to install dependencies manually.

Importante

Gerenciador de Armazenamento conforme fornecido no download. tar. gz tem suporte apenas para distribuições do Ubuntu.Storage Explorer as provided in the .tar.gz download is supported only for Ubuntu distributions. Outras distribuições não foram verificadas e podem exigir pacotes adicionais ou alternativos.Other distributions haven't been verified and may require alternative or additional packages.

Esses pacotes são os requisitos mais comuns para Gerenciador de Armazenamento no Linux:These packages are the most common requirements for Storage Explorer on Linux:

Observação

Gerenciador de Armazenamento versão 1.7.0 e anteriores exigem o .NET Core 2,0.Storage Explorer version 1.7.0 and earlier require .NET Core 2.0. Se você tiver uma versão mais recente do .NET Core instalada, terá que corrigir Gerenciador de armazenamento.If you have a newer version of .NET Core installed, you'll have to patch Storage Explorer. Se estiver executando o Gerenciador de Armazenamento 1.8.0 ou posterior, você poderá usar o até o .NET Core 2,2.If you're running Storage Explorer 1.8.0 or later, you should be able to use up to .NET Core 2.2. As versões além de 2,2 não foram verificadas para funcionar neste momento.Versions beyond 2.2 have not been verified to work at this time.

  1. Baixar Gerenciador de Armazenamento.Download Storage Explorer.
  2. Instale o tempo de execução do .NET Core.Install the .NET Core Runtime.
  3. Execute o comando a seguir:Run the following command:
    sudo apt-get install libgconf-2-4 libgnome-keyring0
    

Aplicação de patch Gerenciador de Armazenamento para versões mais recentes do .NET CorePatching Storage Explorer for newer versions of .NET Core

Para Gerenciador de Armazenamento 1.7.0 ou anterior, talvez seja necessário corrigir a versão do .NET Core usada pelo Gerenciador de Armazenamento:For Storage Explorer 1.7.0 or earlier, you might have to patch the version of .NET Core used by Storage Explorer:

  1. Baixe a versão 1.5.43 do StreamJsonRpc do NuGet.Download version 1.5.43 of StreamJsonRpc from NuGet. Procure o link "baixar pacote" no lado direito da página.Look for the "Download package" link on the right side of the page.
  2. Depois de baixar o pacote, altere sua extensão de arquivo de .nupkg para .zip.After you download the package, change its file extension from .nupkg to .zip.
  3. Descompacte o pacote.Unzip the package.
  4. Abra a pasta streamjsonrpc.1.5.43/lib/netstandard1.1/.Open the streamjsonrpc.1.5.43/lib/netstandard1.1/ folder.
  5. Copie StreamJsonRpc.dll para os seguintes locais na pasta Gerenciador de Armazenamento:Copy StreamJsonRpc.dll to the following locations in the Storage Explorer folder:
    • StorageExplorer/resources/app/ServiceHub/Services/Microsoft.Developer.IdentityService/
    • StorageExplorer/resources/app/ServiceHub/Hosts/ServiceHub.Host.Core.CLR.x64/

"Abrir no Explorer" da portal do Azure não funciona"Open In Explorer" from the Azure portal doesn't work

Se o botão abrir no Explorer na portal do Azure não funcionar, verifique se você está usando um navegador compatível.If the Open In Explorer button on the Azure portal doesn't work, make sure you're using a compatible browser. Os seguintes navegadores foram testados quanto à compatibilidade:The following browsers have been tested for compatibility:

  • Microsoft EdgeMicrosoft Edge
  • Mozilla FirefoxMozilla Firefox
  • Google ChromeGoogle Chrome
  • Microsoft Internet ExplorerMicrosoft Internet Explorer

Próximos passosNext steps

Se nenhuma dessas soluções funcionar para você, abra um problema no GitHub.If none of these solutions work for you, open an issue in GitHub. Você também pode fazer isso selecionando o botão relatar o problema no GitHub no canto inferior esquerdo.You can also do this by selecting the Report issue to GitHub button in the lower-left corner.

Comentários