Todos os produtos
Search
Central de documentação

File Storage NAS:Exemplo de integração com CLI

Última atualização: Aug 28, 2026

O Alibaba Cloud Command Line Interface (CLI) é uma ferramenta de linha de comando de uso geral desenvolvida com base nas APIs. Com o Alibaba Cloud CLI, você interage com o File Storage NAS (NAS) e gerencia seus recursos do NAS por meio de uma ferramenta de shell. Este tópico descreve como usar o Alibaba Cloud CLI para chamar operações da API do NAS.

Informações básicas

Para obter mais informações sobre o Alibaba Cloud CLI, consulte What is Alibaba Cloud CLI

Instale o Alibaba Cloud CLI

Instale o Alibaba Cloud CLI antes de utilizá-lo. A instalação é compatível com os sistemas operacionais Windows, Linux e macOS. Selecione o pacote de instalação adequado ao sistema operacional do seu dispositivo. Para mais detalhes, consulte os tópicos a seguir:

Você também pode usar o Cloud Shell fornecido pela Alibaba Cloud para depurar comandos no Alibaba Cloud CLI. Para saber mais sobre o Cloud Shell, consulte What is Cloud Shell?

Configure o Alibaba Cloud CLI

Importante

Uma conta Alibaba Cloud tem permissão para chamar todas as operações de API. O uso dessa conta para realizar operações representa um risco elevado. Recomendamos chamar as operações de API ou executar tarefas rotineiras de O&M como um usuário do Resource Access Management (RAM). Anexe a política AliyunNASFullAccess ao usuário RAM.

Antes de usar o Alibaba Cloud CLI, configure as informações de credencial, como credenciais de identidade e ID de região. O Alibaba Cloud CLI oferece suporte a diversos tipos de credenciais de identidade. Para mais informações, consulte Configure and manage credentials. Neste exemplo, usam-se credenciais AccessKey. Siga as etapas abaixo:

  1. Crie um usuário RAM e conceda as permissões necessárias para gerenciar os serviços da Alibaba Cloud conforme suas necessidades de negócio. Para mais detalhes, consulte Create a RAM user e Manage RAM user permissions.

  2. Após criar e autorizar o usuário RAM, gere um par de AccessKey para ele e anote o AccessKey ID e o AccessKey Secret para configurar as credenciais posteriormente. Consulte Create an AccessKey para mais informações.

  3. Especifique um ID de região. O Alibaba Cloud CLI chama as operações de API na região definida. Para verificar as regiões disponíveis, consulte Endpoints.

  4. Use o par de AccessKey do usuário RAM para configurar as credenciais de identidade no arquivo de configuração chamado AkProfile. Consulte Configure and manage credentials para mais informações.

Gerar um comando CLI

  1. Faça login no OpenAPI Portal.

  2. Na página de depuração de API, pesquise a API desejada na caixa de pesquisa à esquerda. Na seção Parameter Configuration, insira os parâmetros conforme a documentação da API e clique em CLI Example, à direita de Parameter Configuration, para gerar um exemplo de comando com os parâmetros preenchidos.

    • Clique em Run Command para abrir o Cloud Shell e depurar o comando rapidamente.

    • Clique em Copy para copiar o exemplo de comando para a área de transferência. Em seguida, cole-o em sua ferramenta de shell local para executá-lo.

      • Atente aos formatos dos parâmetros ao copiar e colar o comando CLI no shell local. Para mais informações sobre os formatos de parâmetros do Alibaba Cloud CLI, consulte Understand command parameters.

      • Por padrão, a opção --region é adicionada ao comando de exemplo gerado no OpenAPI Explorer. Ao copiar o comando para sua ferramenta de shell, o Alibaba Cloud CLI ignora as informações de região das configurações padrão de credenciais e variáveis de ambiente, executando preferencialmente o comando na região especificada. Mantenha ou remova essa opção conforme a necessidade do seu cenário.

Usar o Alibaba Cloud CLI para chamar operações da API do NAS

Sintaxe

No Alibaba Cloud CLI, use a seguinte sintaxe para executar comandos. Para mais detalhes, consulte Generate and run CLI commands with OpenAPI Explorer.

aliyun <command> <subcommand> [options and parameters]

Opções de comando

Ao usar o Alibaba Cloud CLI, especifique opções de comando para alterar comportamentos ou habilitar recursos estendidos. As opções abaixo são frequentemente usadas:

  • --profile<profileName>: Ao usar a opção --profile com o parâmetro profileName para definir um perfil de configuração, o Alibaba Cloud CLI ignora as configurações padrão de credenciais de identidade e variáveis de ambiente, usando as configurações especificadas para executar os comandos.

  • --help: Especifique a opção --help para obter informações de ajuda sobre um comando. Consulte Use the help command para mais detalhes.

Exemplos

Nota

Nos exemplos a seguir, os comandos são executados no Prompt de Comando do Windows. Os formatos dos parâmetros variam em outros sistemas operacionais. Para mais informações sobre os formatos de parâmetros do Alibaba Cloud CLI, consulte Understand command parameters.

  • Exemplo 1: Usar o Alibaba Cloud CLI para chamar a operação CreateFileSystem do NAS e criar um sistema de arquivos NFS (Network File System) de Capacidade de Uso Geral com pagamento conforme o uso.

    1. Execute o seguinte comando:

      aliyun nas CreateFileSystem --FileSystemType standard --ChargeType PayAsYouGo --StorageType Capacity --ProtocolType NFS
    2. Visualize a saída do comando.

      {
              "FileSystemId": "6a2464****",
              "RequestId": "3879AB9C-1DED-5A49-A015-350138B23BF0"
      }
  • Exemplo 2: Usar o Alibaba Cloud CLI para chamar a operação CreateAccessGroup do NAS e criar um grupo de permissões chamado vpc_test.

    1. Execute o seguinte comando:

      aliyun nas CreateAccessGroup --AccessGroupName vpc_test --AccessGroupType Vpc
    2. Visualize a saída do comando.

      {
              "AccessGroupName": "vpc_test",
              "RequestId": "95CB3005-C251-5E11-A949-29CB2C7A9C54"
      }
Nota

Se uma chamada de operação da API do NAS retornar um erro, verifique se os parâmetros da solicitação e seus valores são válidos com base no código de erro retornado.

Você também pode usar o RequestID ou a mensagem de erro do SDK presente na resposta, juntamente com a OpenAPI Diagnostic Platform, para diagnosticar o problema.