Tutorial: Solicitar o Azure Data Box

Para o serviço Azure Data Box

Antes de começar, verifique se:

• Você tem sua conta de armazenamento do Microsoft Azure com credenciais de acesso, como o nome e a chave de acesso.

• A assinatura usada para o serviço do Data Box é de um dos seguintes tipos:

  • O MCA (Contrato de Cliente da Microsoft) para novas assinaturas ou EA (Contrato Enterprise) da Microsoft para assinaturas existentes. Leia mais sobre o MCA para novas assinaturas e assinaturas do EA.
  • CSP (Provedor de Soluções na Nuvem). Saiba mais sobre o programa do Azure CSP.

    Observação

    Esse serviço tem suporte do programa CSP do Azure na Índia quando você usa o modelo de cobrança moderno. Se você usa o modelo de cobrança herdado de acordo com seu contrato, não pode criar pedidos do Data Box.

  • Microsoft Azure Sponsorship. Saiba mais sobre o programa Azure Sponsorship.
  • MPN (Microsoft Partner Network). Saiba mais sobre o Microsoft Partner Network.

• Verifique se você tem acesso de proprietário ou colaborador à assinatura para criar um pedido de dispositivo.

Para o dispositivo Azure Data Box

Antes de começar, verifique se:

• Você deve ter um computador host conectado à rede do datacenter. O Data Box copiará os dados deste computador. Seu computador host deve executar um sistema operacional com suporte, conforme descrito em Requisitos de sistema do Azure Data Box.
• Seu datacenter deve ter uma rede de alta velocidade. É altamente recomendável que você tenha pelo menos uma conexão de 10 GbE. Se uma conexão de 10 GbE não estiver disponível, um link de dados de 1 GbE poderá ser usado, mas as velocidades de cópia serão afetadas.

Para o serviço Azure Data Box

Antes de começar, verifique se:

• Você tem sua conta de armazenamento do Microsoft Azure com credenciais de acesso, como o nome e a chave de acesso.

• A assinatura usada para o serviço do Data Box é de um dos seguintes tipos:

  • O MCA (Contrato de Cliente da Microsoft) para novas assinaturas ou EA (Contrato Enterprise) da Microsoft para assinaturas existentes. Leia mais sobre o MCA para novas assinaturas e assinaturas do EA.
  • CSP (Provedor de Soluções na Nuvem). Saiba mais sobre o programa do Azure CSP.

    Observação

    Esse serviço tem suporte do programa CSP do Azure na Índia quando você usa o modelo de cobrança moderno. Se você usa o modelo de cobrança herdado de acordo com seu contrato, não pode criar pedidos do Data Box.

  • Microsoft Azure Sponsorship. Saiba mais sobre o programa Azure Sponsorship.
  • MPN (Microsoft Partner Network). Saiba mais sobre o Microsoft Partner Network.

• Verifique se você tem acesso de proprietário ou colaborador à assinatura para criar um pedido de dispositivo.

Para o dispositivo Azure Data Box

Antes de começar, verifique se:

• Você deve ter um computador host conectado à rede do datacenter. O Data Box copiará os dados deste computador. Seu computador host deve executar um sistema operacional com suporte, conforme descrito em Requisitos de sistema do Azure Data Box.
• Seu datacenter deve ter uma rede de alta velocidade. É altamente recomendável que você tenha pelo menos uma conexão de 10 GbE. Se uma conexão de 10 GbE não estiver disponível, um link de dados de 1 GbE poderá ser usado, mas as velocidades de cópia serão afetadas.

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Você pode entrar no Azure e executar comandos da CLI do Azure de uma das duas formas a seguir:

• Você pode instalar a CLI e executar comandos da CLI localmente.
• Você pode executar comandos da CLI de dentro do portal do Azure, no Azure Cloud Shell.

Usamos a CLI do Azure por meio do Windows PowerShell neste tutorial, mas você pode escolher qualquer uma das opções.

Para CLI do Azure

Antes de começar, verifique se:

Instalar a CLI localmente

• Instalar a CLI do Azure versão 2.0.67 ou posterior. Ou instale usando a MSI em vez disso.

Entre no Azure

Abra uma janela de comando do Windows PowerShell e entre no Azure com o comando az sign in:

PS C:\Windows> az login

A saída confirma uma entrada bem-sucedida:

You have logged in. Now let us find all the subscriptions to which you have access.
[
   {
      "cloudName": "AzureCloud",
      "homeTenantId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "isDefault": true,
      "managedByTenants": [],
      "name": "My Subscription",
      "state": "Enabled",
      "tenantId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "user": {
          "name": "gusp@contoso.com",
          "type": "user"
      }
   }
]

Instalar a extensão da CLI do Azure Data Box

Para usar os comandos da CLI do Azure Data Box, instale a extensão. As extensões da CLI do Azure fornecem acesso a comandos experimentais e de pré-lançamento antes do envio como parte da CLI principal. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

Para instalar a extensão para o Azure Data Box, execute o seguinte comando: az extension add --name databox:

    PS C:\Windows> az extension add --name databox

Se a extensão for instalada com êxito, a seguinte saída será exibida:

    The installed extension 'databox' is experimental and not covered by customer support. Please use with discretion.
    PS C:\Windows>

    # az databox help

    PS C:\Windows> az databox -h

    Group
        az databox

    Subgroups:
        job [Experimental] : Commands to manage databox job.

    For more specific examples, use: az find "az databox"

        Please let us know how we are doing: https://aka.ms/clihats

Usar o Azure Cloud Shell

Você pode usar Azure Cloud Shell, um ambiente de shell interativo hospedado do Azure, por meio de seu navegador para executar comandos da CLI. O Azure Cloud Shell dá suporte a Bash ou Windows PowerShell com serviços do Azure. A CLI do Azure é pré-instalada e configurada para usar com sua conta. Selecione o botão Cloud Shell no menu na seção superior direita do portal do Azure:

O botão inicia um shell interativo que você pode usar para executar as etapas descritas neste artigo de instruções.

Para o serviço Azure Data Box

Antes de começar, verifique se:

• Você tem sua conta de armazenamento do Microsoft Azure com credenciais de acesso, como o nome e a chave de acesso.

• A assinatura usada para o serviço do Data Box é de um dos seguintes tipos:

  • O MCA (Contrato de Cliente da Microsoft) para novas assinaturas ou EA (Contrato Enterprise) da Microsoft para assinaturas existentes. Leia mais sobre o MCA para novas assinaturas e assinaturas do EA.
  • CSP (Provedor de Soluções na Nuvem). Saiba mais sobre o programa do Azure CSP.

    Observação

    Esse serviço tem suporte do programa CSP do Azure na Índia quando você usa o modelo de cobrança moderno. Se você usa o modelo de cobrança herdado de acordo com seu contrato, não pode criar pedidos do Data Box.

  • Microsoft Azure Sponsorship. Saiba mais sobre o programa Azure Sponsorship.
  • MPN (Microsoft Partner Network). Saiba mais sobre o Microsoft Partner Network.

• Verifique se você tem acesso de proprietário ou colaborador à assinatura para criar um pedido de dispositivo.

Para o dispositivo Azure Data Box

Antes de começar, verifique se:

• Você deve ter um computador host conectado à rede do datacenter. O Data Box copiará os dados deste computador. Seu computador host deve executar um sistema operacional com suporte, conforme descrito em Requisitos de sistema do Azure Data Box.
• Seu datacenter deve ter uma rede de alta velocidade. É altamente recomendável que você tenha pelo menos uma conexão de 10 GbE. Se uma conexão de 10 GbE não estiver disponível, um link de dados de 1 GbE poderá ser usado, mas as velocidades de cópia serão afetadas.

Para o Azure PowerShell

Antes de começar:

• Instale o Windows PowerShell 6.2.4 ou posterior.
• Instale o módulo do Azure PowerShell (AZ).
• Instale o módulo do Azure Data Box (Az.DataBox).
• Entre no Azure.

Instalar o Azure PowerShell e os módulos localmente

Instalar ou atualizar o Windows PowerShell

Você precisa ter o Windows PowerShell versão 6.2.4 ou superior instalado. Para saber qual versão do PowerShell está instalada, execute: $PSVersionTable.

O exemplo de saída a seguir confirma que a versão 6.2.3 está instalada:

    PS C:\users\gusp> $PSVersionTable
    
    Name                           Value
    ----                           -----
    PSVersion                      6.2.3
    PSEdition                      Core
    GitCommitId                    6.2.3
    OS                             Microsoft Windows 10.0.18363
    Platform                       Win32NT
    PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}
    PSRemotingProtocolVersion      2.3
    SerializationVersion           1.1.0.1
    WSManStackVersion              3.0

Caso sua versão do Windows PowerShell seja inferior à 6.2.4, você precisará atualizá-la. Para instalar a última versão do PowerShell, confira Instalar o Azure PowerShell.

Instalar os módulos do Azure PowerShell e Data Box

Você precisa instalar os módulos do Azure PowerShell para usar o Azure PowerShell para solicitar uma Caixa de Dados do Azure. Para instalar os módulos do Azure PowerShell:

1. Instale o módulo Az PowerShell.
2. Instale o Az.DataBox usando o comando Install-Module -Name Az.DataBox.

PS C:\PowerShell\Modules> Install-Module -Name Az.DataBox
PS C:\PowerShell\Modules> Get-InstalledModule -Name "Az.DataBox"

Version              Name                                Repository           Description
-------              ----                                ----------           -----------
0.1.1                Az.DataBox                          PSGallery            Microsoft Azure PowerShell - DataBox ser…

Entrar no Azure

Abra uma janela de comando do Windows PowerShell e entre no Azure com o comando Connect-AzAccount:

PS C:\Windows> Connect-AzAccount

A saída de amostra a seguir confirma uma entrada bem-sucedida:

WARNING: To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code FSBFZMBKC to authenticate.

Account              SubscriptionName                          TenantId                             Environment
-------              ----------------                          --------                             -----------
gusp@contoso.com     MySubscription                            aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa AzureCloud

PS C:\Windows\System32>

Para obter informações detalhadas sobre como entrar no Azure usando o Windows PowerShell, confira Entrar com o Azure PowerShell.

Para pedido e dispositivo, execute as seguintes etapas no portal do Azure:

1. Use suas credenciais do Microsoft Azure para entrar nesta URL: https://portal.azure.com.

2. Selecione + Criar um recurso e pesquise Azure Data Box. Selecione Azure Data Box.

   

3. Selecione Criar.

   

4. Verifique se o serviço Data Box está disponível em sua região. Insira ou selecione as informações a seguir e selecione Aplicar.

   Configuração	Valor
   Tipo de transferência	Selecione Importar no Azure.
   Assinatura	Selecione um Contrato Enterprise (EA), um Provedor de Soluções em Nuvem (CSP) ou uma assinatura de patrocínio do Azure para o serviço Data Box. A assinatura está vinculada à sua conta de cobrança.
   Resource group	Selecione um grupo de recursos existente. Um grupo de recursos é um contêiner lógico para os recursos que podem ser gerenciados ou implantados juntos.
   País/região de origem	Selecione o país/região em que os dados residem no momento.
   Região do Azure de destino	Selecione a região do Azure para onde você deseja transferir dados. Para obter mais informações, confira disponibilidade de região para o Data Box ou disponibilidade de região para o Data Box Heavy. Se as regiões de origem e destino selecionadas cruzarem as fronteiras internacionais do país/região, o Data Box e o Data Box Heavy não ficarão disponíveis.

   

5. Selecione o produto Data Box a ser solicitado, o Data Box, conforme mostrado no exemplo fornecido, ou o Data Box Heavy.

   A capacidade máxima utilizável para um único pedido do Data Box é de 80 TB. A capacidade máxima utilizável para um único pedido do Data Box Heavy é de 770 TB. Você pode criar vários pedidos para acomodar os tamanhos de dados maiores.

   Você não poderá selecionar o Data Box ou o Data Box Heavy se:

   • As regiões de origem e destino selecionadas ultrapassam as fronteiras internacionais do país/região.

     Para transferir seus dados através das fronteiras do país/região, importe-os para um destino dentro do mesmo país/região. Após a conclusão da importação de dados, use a Importação/Exportação do Azure para transferir os dados para o país/região desejado.

   • Sua assinatura do Azure não dá suporte ao produto Data Box. Em alguns casos, sua assinatura pode não ter suporte para um produto Data Box em um país/região específico.

   Se você selecionar Data Box Heavy, a equipe do Data Box verificará a disponibilidade do dispositivo em sua região e notificará quando você poderá continuar fazendo o pedido.

   

6. Na guia Solicitar, vá para a guia Informações Básicas. Insira ou selecione as informações a seguir. Em seguida, selecione Avançar: Destino dos dados>.

   Configuração	Valor
   Subscription	A assinatura é preenchida automaticamente com base na seleção anterior.
   Resource group	O grupo de recursos selecionado anteriormente.
   Nome do pedido de importação	Forneça um nome amigável para acompanhar o pedido. O nome pode ter de 3 a 24 caracteres que podem ser letras, números ou hifens. O nome deve começar e terminar com uma letra ou um número.

   

7. Na tela Destino de dados, selecione o Destino de dados – contas de armazenamento ou discos gerenciados.

   A guia Destino dos dados é alterada com base no destino selecionado. Confira Para usar as contas de armazenamento ou Para usar os discos gerenciados na seção a seguir para obter instruções.

   Para usar contas de armazenamento

   Selecione contas de armazenamento como o destino de armazenamento. A tela a seguir será exibida.

   

   Com base na região especificada do Azure, selecione uma ou mais contas de armazenamento na lista filtrada de contas de armazenamento existentes. O Data Box pode ser vinculado a até dez contas de armazenamento. Você também pode criar uma nova conta de Uso geral v1, Uso geral v2 ou de Armazenamento de Blobs.

   • Se você selecionar as contas do Azure Premium FileStorage, a cota provisionada no compartilhamento da conta de armazenamento aumentará de acordo com o tamanho dos dados que estão sendo carregados nos compartilhamentos de arquivos. Depois que a cota for aumentada, ela não será ajustada novamente, por exemplo, se por algum motivo o Data Box não puder carregar seus dados.

     Essa cota é usada para cobrança. Depois que os dados são carregados no datacenter, você deve ajustar a cota de acordo com as suas necessidades. Para obter mais informações, confira Noções básicas sobre cobrança.

   • Se você estiver usando uma conta de armazenamento de Uso Geral v1, Uso Geral v2 ou de Blob, as opções Habilitar a cópia para arquivar e Habilitar compartilhamentos de arquivos grandes será exibida. Habilitar Copiar para arquivar permite que você envie seus blobs para a camada de arquivos automaticamente. Todos os dados carregados na camada de arquivo permanecem offline e precisam ser reidratados antes de serem lidos ou modificados.

     Quando Copiar para o arquivo estiver habilitado, um compartilhamento Archive extra ficará disponível durante o processo de cópia. O compartilhamento extra está disponível para métodos SMB, NFS, REST e os serviço de cópia de dados.

     

   Observação

   Contas de armazenamento com redes virtuais são compatíveis. Para permitir que o serviço do Data Box trabalhe com contas de armazenamento protegido, habilite os serviços confiáveis em definições de firewall de rede da conta de armazenamento. Para obter mais informações, confira como Adicionar o Azure Data Box como um serviço confiável.

   Para usar os discos gerenciados

   Ao usar o Data Box para criar Discos gerenciados a partir dos discos rígidos virtuais (VHDs) no local, também precisará fornecer as seguintes informações:

   Configuração

   Valor

   Grupos de recursos

   Se você pretende criar discos gerenciados de VHDs locais, crie novos grupos de recursos. Você poderá usar um grupo de recursos existente somente se o grupo de recursos tiver sido criado anteriormente durante a criação de um pedido do Data Box para discos gerenciados pelo serviço Data Box. Especifique vários grupos de recursos separados por ponto e vírgula. Há suporte para um limite máximo de dez grupos de recursos.

   

   A conta de armazenamento especificada para os discos gerenciados é usada como uma conta de armazenamento de preparo. O serviço do Data Box carrega os VHDs como blobs de páginas na conta de armazenamento de preparo antes de converter os blobs de páginas em discos gerenciados e movê-los para os grupos de recursos. Para obter mais informações, confira Verificar o upload de dados para o Azure.

   Observação

   O Data Box dá suporte à cópia de apenas 1 MiB alinhado, arquivos .vhd de tamanho fixo para a criação de discos gerenciados. Os VHDs dinâmicos, VHDs diferenciais, arquivos .vmdk ou .vhdx não têm suporte.

   Caso um blob de páginas não seja convertido com êxito em um disco gerenciado, ele permanecerá na conta de armazenamento e você será cobrado pelo armazenamento.

8. Selecione Avançar: segurança> para continuar.

   A tela Segurança permite que você use a própria chave de criptografia e o próprio dispositivo, compartilhe senhas e opte por usar a criptografia dupla.

   Todas as configurações na tela Segurança são opcionais. Se você não alterar nenhuma configuração, as configurações padrão serão aplicadas.

   

9. Se você quiser usar a própria chave gerenciada pelo cliente para proteger a chave de acesso de desbloqueio para o novo recurso, expanda Tipo de criptografia.

   A configuração de uma chave gerenciada pelo cliente para seu Azure Data Box é opcional. Por padrão, o Data Box usa uma chave gerenciada da Microsoft para proteger a chave de acesso de desbloqueio.

   Uma chave gerenciada pelo cliente não afeta como os dados no dispositivo são criptografados. A chave é usada somente para criptografar a chave de acesso de desbloqueio do dispositivo.

   Se você não quiser usar uma chave gerenciada pelo cliente, pule para a Etapa 15.

   

10. Para usar uma chave gerenciada pelo cliente, selecione Chave gerenciada pelo cliente como o tipo da chave. Em seguida, selecione Selecionar um cofre de chaves e uma chave.

    

11. No painel Selecionar chave no Azure Key Vault:

    • A Assinatura é populada automaticamente.

    • Para Cofre de chaves, você pode selecionar um cofre de chaves existente na lista suspensa.

      

      Ou então, selecione Criar cofre de chaves se você desejar fazê-lo.

      

      Em seguida, na tela Criar cofre de chaves, insira o grupo de recursos e um nome do cofre de chaves. Verifique se as opções Exclusão temporária e Proteção contra limpeza estão habilitadas. Aceite todos os outros padrões e selecione Examinar + Criar.

      

      Examine as informações do seu cofre de chaves e selecione Criar. Aguarde alguns minutos até que a criação do cofre de chaves seja concluída.

      

12. O painel Selecionar uma chave exibe o cofre de chaves selecionado.

    

    Se você desejar criar uma chave, selecione Criar chave. Você precisa usar uma chave RSA. O tamanho pode ser 2048 ou maior. Insira um nome para a nova chave, aceite os outros padrões e selecione Criar.

    

    Você será notificado quando a chave for criada no seu cofre de chaves. Sua nova chave está selecionada no painel Selecionar uma chave.

13. Selecione a Versão da chave a ser usada e, em seguida, escolha Selecionar.

    

    Se você desejar criar uma versão da chave, selecione Criar versão.

    

    Escolha configurações para a nova versão de chave e selecione Criar.

    

    As configurações Tipo de criptografia na tela Segurança mostram seu cofre de chaves e sua chave.

    

14. Selecione uma identidade de usuário com a qual gerenciar o acesso a esse recurso. Escolha Selecionar uma identidade de usuário. No painel à direita, selecione a assinatura e a identidade gerenciada a ser usada. Em seguida, escolha Selecionar.

    Uma identidade gerenciada atribuída pelo usuário é um recurso do Azure autônomo que pode ser usado para gerenciar vários recursos. Para obter mais informações, confira Tipos de identidade gerenciada.

    Se você precisar criar uma identidade gerenciada, siga as diretrizes em Criar, listar, excluir ou atribuir uma função a uma identidade gerenciada atribuída pelo usuário usando o portal do Azure.

    

    A identidade de usuário é mostrada nas configurações Tipo de criptografia.

    :

    Importante

    Se você usar uma chave gerenciada pelo cliente, deverá habilitar as permissões Get, UnwrapKey e WrapKey na chave. Sem essas permissões, a criação do pedido falhará. Elas também são necessárias durante a cópia de dados. Para definir as permissões na CLI do Azure, confira az keyvault set-policy.

15. Se você não quiser usar as senhas geradas pelo sistema que o Azure Data Box usa por padrão, expanda Traga a própria senha na tela Segurança.

    As senhas geradas pelo sistema são seguras e recomendadas, a menos que sua organização exija o contrário.

    

    • Para usar a própria senha para o novo dispositivo, em Definir preferência para a senha do dispositivo, selecione Usar a própria senha e digite uma senha que atenda aos requisitos de segurança.

    A senha deve ser alfanumérica e conter entre 12 e 15 caracteres. Também deve conter pelo menos uma letra maiúscula, uma letra minúscula, um caractere especial e um número.

    • Os caracteres especiais permitidos são: @ # - $ % ^ ! + = ; : _ ( )
    • Estes caracteres não são permitidos: i L o O 0

    

• Para usar as próprias senhas para compartilhamentos:

  1. Em Definir preferência para senhas de compartilhamento, selecione Usar as próprias senhas e Selecionar senhas para os compartilhamentos.

     

  2. Digite uma senha para cada conta de armazenamento no pedido. A senha é usada em todos os compartilhamentos da conta de armazenamento.

     A senha deve ser alfanumérica e conter entre 12 e 64 caracteres. Também deve conter pelo menos uma letra maiúscula, uma letra minúscula, um caractere especial e um número.

     • Os caracteres especiais permitidos são: @ # - $ % ^ ! + = ; : _ ( )
     • Estes caracteres não são permitidos: i L o O 0

  3. Para usar a mesma senha para todas as contas de armazenamento, selecione Copiar para todos.

  4. Quando terminar, selecione Salvar.

     

  Na tela de Segurança, será possível usar a opção Exibir ou alterar senhas para alterar as senhas.

16. Em Segurança, caso queira habilitar uma criptografia dupla baseada em software, expanda Criptografia dupla (para ambientes altamente seguros) e selecione Habilitar criptografia dupla para o pedido.

    

    Uma criptografia baseada em software será executada além da criptografia AES de 256 bits dos dados no Data Box.

    Observação

    Habilitar essa opção poderá fazer com que o processamento de pedidos e a cópia de dados demorem mais. Não será possível alterar essa opção depois de criar seu pedido.

    Selecione Avançar: Detalhes de contato> para continuar.

17. Em Detalhes de contato, selecione + Adicionar Endereço.

    

18. Na tela Adicionar endereço, forneça seu nome e sobrenome, o nome e endereço postal da empresa e um número de telefone válido. Selecione Validar endereço. O serviço valida o endereço para disponibilidade do serviço e notifica se o serviço está disponível para esse endereço.

    

    Se você selecionou envio autogerenciado, receberá uma notificação por email depois que o pedido for feito com sucesso. Para saber mais sobre a remessa autogerenciada, confira Usar a remessa autogerenciada.

19. Selecione Adicionar endereço de envio depois que os detalhes do envio forem validados com sucesso. Você retornará à guia Detalhes do contato.

20. Além de Email, adicione um ou mais endereços de email. O serviço envia as notificações por email em relação a quaisquer atualizações do status do pedido para os endereços de email especificados.

    É recomendável usar um email de grupo para que você continue a receber notificações caso um administrador do grupo saia.

    

    Selecione Examinar + Pedir para continuar.

21. Em Examinar + Pedir:

    1. Examine as informações em Examinar + Pedir relacionadas com o pedido, os detalhes do contato, a notificação e os termos de privacidade.

    2. Marque a caixa correspondente ao contrato de termos de privacidade. Quando você marca a caixa de seleção, as informações do pedido são validadas.

    3. Depois que o pedido for validado, selecione Pedido.

       

    O pedido leva alguns minutos para ser criado e é semelhante ao exemplo fornecido. Você pode selecionar Ir para o recurso para abrir o pedido.

    

1. Anote suas configurações para seu pedido do Data Box. Essas configurações incluem suas informações pessoais/empresariais, nome da assinatura, informações do dispositivo e informações de envio. Essas configurações são usadas como parâmetros ao executar o comando da CLI para criar a ordem do Data Box. A seguinte tabela mostra as configurações de parâmetro usadas para az databox job create:

   Configuração (parâmetro)	Descrição	Valor de exemplo
   resource-group	Use um grupo existente ou crie um novo. Um grupo de recursos é um contêiner lógico para os recursos que podem ser gerenciados ou implantados juntos.	"myresourcegroup"
   name	O nome do pedido que você está criando.	"mydataboxorder"
   contact-name	O nome associado ao endereço para entrega.	"Gus Poland"
   phone	O número de telefone da pessoa ou empresa que está recebendo a ordem.	"14255551234"
   local	A região do Azure mais próxima usada para enviar o dispositivo.	"Oeste dos EUA"
   sku	O dispositivo Data Box específico que você está solicitando. Os valores válidos são: "DataBox", "DataBoxDisk" e "DataBoxHeavy"	"DataBox"
   email-list	Os endereços de email associados ao pedido.	"gusp@contoso.com"
   street-address1	O endereço o qual a ordem será enviada.	"15700 NE 39th St"
   street-address2	As informações de endereço secundário, como número do apartamento ou número do edifício.	"Prédio 123"
   cidade	A cidade para a qual o dispositivo será enviado.	"Redmond"
   state-or-province	O estado para o qual o dispositivo será enviado.	"WA"
   country	O país para o qual o dispositivo será enviado.	"Estados Unidos"
   postal-code	O CEP ou o código postal associado ao endereço para entrega.	"98052"
   company-name	O nome da empresa para a qual você trabalha.	"Contoso, LTD"
   do Azure	A conta de Armazenamento do Azure da qual você deseja importar dados.	"mystorageaccount"
   depurar	Incluir informações de depuração para registro em log detalhado	--debug
   ajuda	Exibir informações de ajuda para esse comando.	--help -h
   only-show-errors	Mostrar apenas erros, suprimindo avisos.	--only-show-errors
   output -o	Define o formato de saída. Valores permitidos: json, jsonc, none, table, tsv, yaml, yamlc. O valor padrão é json.	--output "json"
   Consulta	A cadeia de caracteres de consulta JMESPath. Para obter mais informações, confira JMESPath.	--query <string>
   verbose	Incluir o registro em log detalhado.	--verbose

2. No prompt de comando ou terminal escolhido, execute az data box job create para criar seu pedido do Azure Data Box.

   az databox job create --resource-group <resource-group> --name <order-name> --location <azure-location> --sku <databox-device-type> --contact-name <contact-name> --phone <phone-number> --email-list <email-list> --street-address1 <street-address-1> --street-address2 <street-address-2> --city "contact-city" --state-or-province <state-province> --country <country> --postal-code <postal-code> --company-name <company-name> --storage-account "storage-account"
   

   O comando de amostra a seguir ilustra o uso do comando:

   az databox job create --resource-group "myresourcegroup" \
                         --name "mydataboxtest3" \
                         --location "westus" \
                         --sku "DataBox" \
                         --contact-name "Gus Poland" \
                         --phone "14255551234" \
                         --email-list "gusp@contoso.com" \
                         --street-address1 "15700 NE 39th St" \
                         --street-address2 "Bld 25" \
                         --city "Redmond" \
                         --state-or-province "WA" \
                         --country "US" \
                         --postal-code "98052" \
                         --company-name "Contoso" \
                         --storage-account mystorageaccount
   

   O exemplo de saída a seguir confirma a criação bem-sucedida do trabalho:

   Command group 'databox job' is experimental and not covered by customer support. Please use with discretion.
   {
     "cancellationReason": null,
     "deliveryInfo": {
        "scheduledDateTime": "0001-01-01T00:00:00+00:00"
   },
   "deliveryType": "NonScheduled",
   "details": null,
   "error": null,
   "id": "/subscriptions/[GUID]/resourceGroups/myresourcegroup/providers/Microsoft.DataBox/jobs/mydataboxtest3",
   "identity": {
     "type": "None"
   },
   "isCancellable": true,
   "isCancellableWithoutFee": true,
   "isDeletable": false,
   "isShippingAddressEditable": true,
   "location": "westus",
   "name": "mydataboxtest3",
   "resourceGroup": "myresourcegroup",
   "sku": {
     "displayName": null,
     "family": null,
     "name": "DataBox"
   },
   "startTime": "2020-06-10T23:28:27.354241+00:00",
   "status": "DeviceOrdered",
   "tags": {},
   "type": "Microsoft.DataBox/jobs"
   
   }
   PS C:\Windows>
   
   

3. A menos que a saída padrão seja modificada, todos os comandos da CLI do Azure retornam uma resposta json. Você pode alterar o formato de saída usando o parâmetro global --output <output-format>. A alteração do formato para "tabela" melhora a legibilidade da saída.

   O exemplo a seguir contém o mesmo comando, mas com o valor do parâmetro --output modificado para alterar a resposta formatada:

   az databox job create --resource-group "myresourcegroup" --name "mydataboxtest4" --location "westus" --sku "DataBox" --contact-name "Gus Poland" --phone "14255551234" --email-list "gusp@contoso.com" --street-address1 "15700 NE 39th St" --street-address2 "Bld 25" --city "Redmond" --state-or-province "WA" --country "US" --postal-code "98052" --company-name "Contoso" --storage-account mystorageaccount --output "table"
   

   O exemplo de resposta a seguir ilustra o formato de saída modificado:

   
    Command group 'databox job' is experimental and not covered by customer support. Please use with discretion.
    DeliveryType    IsCancellable    IsCancellableWithoutFee    IsDeletable    IsShippingAddressEditable    Location    Name            ResourceGroup    StartTime                         Status
    --------------  ---------------  -------------------------  -------------  ---------------------------  ----------  --------------  ---------------  --------------------------------  -------------
    NonScheduled    True             True                       False          True                         westus      mydataboxtest4  myresourcegroup  2020-06-18T03:48:00.905893+00:00  DeviceOrdered
   
   

Realize as seguintes etapas usando o Azure PowerShell para solicitar um dispositivo:

1. Antes de criar a ordem de importação, busque sua conta de armazenamento e salve o objeto em uma variável.

    $storAcct = Get-AzStorageAccount -Name "mystorageaccount" -ResourceGroup "myresourcegroup"
   

2. Anote suas configurações para seu pedido do Data Box. Essas configurações incluem suas informações pessoais/empresariais, nome da assinatura, informações do dispositivo e informações de envio. Essas configurações são usadas como parâmetros ao executar o cmdlet do PowerShell para criar a ordem do Data Box. A tabela a seguir mostra as configurações de parâmetro usadas para New-AzDataBoxJob.

   Configuração (parâmetro)	Descrição	Valor de exemplo
   ResourceGroupName [obrigatório]	Usar um grupo de recursos existente. Um grupo de recursos é um contêiner lógico para os recursos que podem ser gerenciados ou implantados juntos.	"myresourcegroup"
   Name [obrigatório]	O nome do pedido que você está criando.	"mydataboxorder"
   ContactName [obrigatório]	O nome associado ao endereço para entrega.	"Gus Poland"
   PhoneNumber [obrigatório]	O número de telefone da pessoa ou empresa que está recebendo a ordem.	"14255551234"
   Location [obrigatório]	A região do Azure mais próxima de você que envia seu dispositivo.	"WestUS"
   DataBoxType [obrigatório]	O dispositivo Data Box específico que você está solicitando. Os valores válidos são: "DataBox", "DataBoxDisk" e "DataBoxHeavy"	"DataBox"
   EmailId [obrigatório]	Os endereços de email associados ao pedido.	"gusp@contoso.com"
   StreetAddress1 [obrigatório]	O endereço da rua para onde a ordem é enviada.	"15700 NE 39th St"
   StreetAddress2	As informações de endereço secundário, como número do apartamento ou número do edifício.	"Prédio 123"
   StreetAddress3	As informações de endereço terciário.
   City [obrigatório]	A cidade para a qual o dispositivo será enviado.	"Redmond"
   StateOrProvinceCode [obrigatório]	O estado para o qual o dispositivo será enviado.	"WA"
   CountryCode [obrigatório]	O país para o qual o dispositivo será enviado.	"Estados Unidos"
   PostalCode [obrigatório]	O CEP ou o código postal associado ao endereço para entrega.	"98052"
   CompanyName	O nome da empresa para a qual você trabalha.	"Contoso, LTD"
   StorageAccountResourceId [obrigatório]	A ID da conta de Armazenamento do Azure da qual você deseja importar dados.	<AzstorageAccount>.id

3. Use o cmdlet New-AzDataBoxJob para criar sua ordem do Azure Data Box, conforme mostrado no exemplo a seguir.

    PS> $storAcct = Get-AzureStorageAccount -StorageAccountName "mystorageaccount"
    PS> New-AzDataBoxJob -Location "WestUS" \
                         -StreetAddress1 "15700 NE 39th St" \
                         -PostalCode "98052" \
                         -City "Redmond" \
                         -StateOrProvinceCode "WA" \
                         -CountryCode "US" \
                         -EmailId "gusp@contoso.com" \
                         -PhoneNumber 4255551234 \
                         -ContactName "Gus Poland" \
                         -StorageAccount $storAcct.id \
                         -DataBoxType DataBox \
                         -ResourceGroupName "myresourcegroup" \
                         -Name "myDataBoxOrderPSTest"
   

   A saída de amostra a seguir confirma a criação do trabalho:

    jobResource.Name     jobResource.Sku.Name jobResource.Status jobResource.StartTime jobResource.Location ResourceGroup
    ----------------     -------------------- ------------------ --------------------- -------------------- -------------
    myDataBoxOrderPSTest DataBox              DeviceOrdered      07-06-2020 05:25:30   westus               myresourcegroup
   

Depois de fazer o pedido, você pode acompanhar o status dele no portal do Azure. Acesse seu pedido do Data Box e, em seguida, acesse Visão Geral para exibir o status. O portal mostra o pedido sob o estado Pedido.

Se o dispositivo não estiver disponível, você receberá uma notificação. Se o dispositivo estiver disponível, a Microsoft identificará o dispositivo e o preparará para envio. As seguintes ações ocorrem durante a preparação do dispositivo:

• Os compartilhamentos SMB são criados para cada conta de armazenamento associada ao dispositivo.
• Para cada compartilhamento, as credenciais de acesso, como nome de usuário e senha, são geradas.
• A senha do dispositivo é gerada. Essa senha é usada para desbloquear o dispositivo.
• O dispositivo é bloqueado para evitar acesso não autorizado em qualquer ponto.

Quando a preparação do dispositivo for concluída, o portal mostrará a ordem em um estado Processado.

Em seguida, a Microsoft preparará e enviará seu dispositivo por meio de uma operadora regional. Você receberá um número de rastreamento depois que o dispositivo for enviado. O portal mostra o pedido no estado Despachado.

Acompanhar um pedido

Para obter informações de acompanhamento sobre um só pedido do Azure Data Box existente, execute az databox job show. O comando exibe informações sobre o pedido como, entre outras: nome, grupo de recursos, informações de acompanhamento, ID da assinatura, informações de contato, tipo de remessa e SKU do dispositivo.

az databox job show --resource-group <resource-group> --name <order-name>

A seguinte tabela mostra as informações de parâmetro para az databox job show:

O exemplo a seguir contém o mesmo comando, mas com o valor do parâmetro output definido como "tabela":

 PS C:\WINDOWS\system32> az databox job show --resource-group "myresourcegroup" \
                                             --name "mydataboxtest4" \
                                             --output "table"

O exemplo de resposta a seguir mostra o formato de saída modificado:

 Command group 'databox job' is experimental and not covered by customer support. Please use with discretion.
 DeliveryType    IsCancellable    IsCancellableWithoutFee    IsDeletable    IsShippingAddressEditable    Location    Name            ResourceGroup    StartTime                         Status
 --------------  ---------------  -------------------------  -------------  ---------------------------  ----------  --------------  ---------------  --------------------------------  -------------
 NonScheduled    True             True                       False          True                         westus      mydataboxtest4  myresourcegroup  2020-06-18T03:48:00.905893+00:00  DeviceOrdered

Listar todos os pedidos

Ao fazer a ordem de vários dispositivos, você pode executar az databox job list para exibir todas as suas ordens do Azure Data Box. O comando lista todos os pedidos que pertencem a um grupo de recursos específico. Também exibido na saída: nome do pedido, status da remessa, região do Azure, tipo de entrega, status do pedido. Pedidos cancelados também são incluídos na lista. O comando também exibe carimbos de data/hora de cada pedido.

az databox job list --resource-group <resource-group>

A seguinte tabela mostra as informações de parâmetro para az databox job list:

O exemplo a seguir mostra o comando com o formato de saída especificado como "tabela":

 PS C:\WINDOWS\system32> az databox job list --resource-group "GDPTest" --output "table"

O exemplo de resposta a seguir exibe a saída com formatação modificada:

Command group 'databox job' is experimental and not covered by customer support. Please use with discretion.
CancellationReason                                               DeliveryType    IsCancellable    IsCancellableWithoutFee    IsDeletable    IsShippingAddressEditable    Location    Name                 ResourceGroup    StartTime                         Status
---------------------- ----------------------------------------  --------------  ---------------  -------------------------  -------------  ---------------------------  ----------  -------------------  ---------------  --------------------------------  -------------
OtherReason This was a test order for documentation purposes.    NonScheduled    False            False                      True           False                        westus      gdpImportTest        MyResGrp         2020-05-26T23:20:57.464075+00:00  Cancelled
NoLongerNeeded This order was created for documentation purposes.NonScheduled    False            False                      True           False                        westus      mydataboxExportTest  MyResGrp         2020-05-27T00:04:16.640397+00:00  Cancelled
IncorrectOrder                                                   NonScheduled    False            False                      True           False                        westus      mydataboxtest2       MyResGrp         2020-06-10T16:54:23.509181+00:00  Cancelled
                                                                 NonScheduled    True             True                       False          True                         westus      mydataboxtest3       MyResGrp         2020-06-11T22:05:49.436622+00:00  DeviceOrdered
                                                                 NonScheduled    True             True                       False          True                         westus      mydataboxtest4       MyResGrp         2020-06-18T03:48:00.905893+00:00  DeviceOrdered
PS C:\WINDOWS\system32>

Acompanhar um pedido

Para obter informações de acompanhamento sobre um único pedido do Azure Data Box existente, execute Get-AzDataBoxJob. O comando exibe informações sobre o pedido como, entre outras: nome, grupo de recursos, informações de acompanhamento, ID da assinatura, informações de contato, tipo de remessa e SKU do dispositivo.

 Get-AzDataBoxJob -ResourceGroupName <String> -Name <String>

A seguinte tabela mostra as informações de parâmetro para Get-AzDataBoxJob:

O exemplo a seguir pode ser usado para recuperar os detalhes sobre uma ordem específica:

Get-AzDataBoxJob -ResourceGroupName "myResourceGroup" -Name "myDataBoxOrderPSTest"

A saída do exemplo a seguir indica que o comando foi concluído com êxito:

jobResource.Name     jobResource.Sku.Name jobResource.Status jobResource.StartTime jobResource.Location ResourceGroup
----------------     -------------------- ------------------ --------------------- -------------------- -------------
myDataBoxOrderPSTest DataBox              DeviceOrdered      7/7/2020 12:37:16 AM  WestUS               myResourceGroup

Listar todos os pedidos

Para exibir todos as suas ordens do Azure Data Box, execute o cmdlet Get-AzDataBoxJob. O cmdlet lista todas as ordens que pertencem a um grupo de recursos específico. A saída resultante também contém dados adicionais, como o nome da ordem, o status de envio, a região do Azure, o tipo de entrega, o status da ordem e o carimbo de data/hora associado a cada ordem. Pedidos cancelados também são incluídos na lista.

O exemplo a seguir pode ser usado para recuperar detalhes sobre todos as ordens associados a um grupo de recursos específico do Azure:

Get-AzDataBoxJob -ResourceGroupName <String>

A saída do exemplo a seguir indica que o comando foi concluído com êxito:

jobResource.Name     jobResource.Sku.Name jobResource.Status jobResource.StartTime jobResource.Location ResourceGroup
----------------     -------------------- ------------------ --------------------- -------------------- -------------
guspImportTest       DataBox              Cancelled          5/26/2020 11:20:57 PM WestUS               myResourceGroup
mydataboxExportTest  DataBox              Cancelled          5/27/2020 12:04:16 AM WestUS               myResourceGroup
mydataboximport1     DataBox              Cancelled          6/26/2020 11:00:34 PM WestUS               myResourceGroup
myDataBoxOrderPSTest DataBox              Cancelled          7/07/2020 12:37:16 AM WestUS               myResourceGroup
mydataboxtest2       DataBox              Cancelled          6/10/2020 4:54:23  PM WestUS               myResourceGroup
mydataboxtest4       DataBox              DeviceOrdered      6/18/2020 3:48:00  AM WestUS               myResourceGroup
PS C:\WINDOWS\system32>

Para cancelar e excluir uma ordem usando o portal do Microsoft Azure, selecione Visão Geral na barra de comandos. Para cancelar a ordem, selecione a opção Cancelar. Para excluir uma ordem cancelada, selecione a opção Excluir.

Cancelar um pedido

Use o comando az databox job cancel para cancelar uma ordem de Caixa de Dados. Você precisa especificar o motivo do cancelamento do pedido.

A tabela a seguir fornece informações sobre os parâmetros do comando az databox job cancel:

O seguinte exemplo de comando pode ser usado para cancelar uma ordem específica de Data Box:

az databox job cancel --resource-group "myresourcegroup" --name "mydataboxtest3" --reason "Our migration plan was modified and we are ordering a device using a different cost center."

A saída do exemplo a seguir indica que o comando foi concluído com êxito:

Command group 'databox job' is experimental and not covered by customer support. Please use with discretion.
Are you sure you want to perform this operation? (y/n): y

Excluir um pedido

Depois de cancelar uma ordem de Data Box do Azure, use o comando az databox job delete para excluir a ordem.

A seguinte tabela mostra as informações de parâmetro para az databox job delete:

O exemplo a seguir pode ser usado para excluir uma ordem específica do Azure Data Box depois de ser cancelado:

az databox job delete --resource-group "myresourcegroup" --name "mydataboxtest3" --yes --verbose

A saída do exemplo a seguir indica que o comando foi concluído com êxito:

Command group 'databox job' is experimental and not covered by customer support. Please use with discretion.
command ran in 1.142 seconds.

Cancelar um pedido

Você pode cancelar uma ordem do Azure Data Box usando o cmdlet Stop-AzDataBoxJob. Você precisa especificar o motivo do cancelamento do pedido.

A seguinte tabela mostra as informações de parâmetro para Stop-AzDataBoxJob:

O exemplo a seguir pode ser usado para excluir uma ordem específica do Azure Data Box depois de ser cancelado:

Stop-AzDataBoxJob -ResourceGroupName myResourceGroup \
    -Name "myDataBoxOrderPSTest" \
    -Reason "I entered erroneous information and need to cancel and re-order."

A saída do exemplo a seguir indica que o comando foi concluído com êxito:

Confirm
"Cancelling Databox Job "myDataBoxOrderPSTest
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Excluir um pedido

Depois de cancelar uma ordem do Azure Data Box, você pode excluí-lo usando o cmdlet Remove-AzDataBoxJob.

A tabela a seguir mostra informações de parâmetros para Remove-AzDataBoxJob:

O exemplo a seguir pode ser usado para excluir uma ordem específica de Data Box após o cancelamento:

Remove-AzDataBoxJob -ResourceGroup "myresourcegroup" \
    -Name "mydataboxtest3"

A saída do exemplo a seguir indica que o comando foi concluído com êxito:

Confirm
"Removing Databox Job "mydataboxtest3
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y