Todos os produtos
Search
Central de documentação

File Storage NAS:Visão geral da integração

Última atualização: Sep 09, 2026

O File Storage NAS oferece suporte a diversos métodos de integração, incluindo SDKs, CLI, Terraform e chamadas diretas de API.

OpenAPI

A Alibaba Cloud disponibiliza o OpenAPI Portal, uma plataforma unificada para busca inteligente de APIs, documentação, depuração online, download de SDKs, exemplos de código, diagnóstico de erros e estatísticas de chamadas. Você pode invocar operações da OpenAPI para services da Alibaba Cloud, visualizar requisições e respostas e gerar exemplos de chamadas via SDK. Para mais informações, consulte What is OpenAPI?.

Versão

A OpenAPI da Alibaba Cloud utiliza números de versão para gerenciar as listas de APIs dos produtos cloud. O File Storage NAS suporta atualmente a versão da API 2017-06-26. A string 2017-06-26 é um identificador de versão, não uma data. Os dados da API exibidos são sempre os mais recentes e podem ter sido alterados desde a publicação da versão 2017-06-26.

Versão

Descrição

2017-06-26

Recomendada

Depuração online

O OpenAPI Portal fornece ferramentas de depuração de API para o File Storage NAS. Antes de invocar uma operação de API, familiarize-se com as versões disponíveis, endpoints e métodos de integração.

O painel de navegação à esquerda lista todas as operações de API do File Storage NAS, como CreateFileSystem, DeleteFileSystem e DescribeFileSystems. Selecione uma operação de API para configurar seus parâmetros na área principal, incluindo FileSystemType, ChargeType, StorageType e ZoneId. O painel direito oferece documentação da API, exemplos de SDK e exemplos de CLI. Após configurar os parâmetros, clique em Initiate Call para testar a chamada da API.

URL de depuração

Acesse a página de depuração da API na seguinte URL: Página de depuração do CreateFileSystem

Endpoints

Para obter latência ideal, selecione o endpoint de service na mesma região dos seus recursos. Por exemplo, para recursos na região China (Qingdao), o endpoint público do File Storage NAS é nas.cn-qingdao.aliyuncs.com e o endpoint de VPC é nas-vpc.cn-qingdao.aliyuncs.com.

  • Os endpoints públicos são acessíveis globalmente.

  • Os endpoints de VPC são acessíveis apenas a partir de uma rede VPC dentro da mesma região da Alibaba Cloud e oferecem diversas vantagens:

    • Maior segurança: Ao restringir o acesso à sua VPC, esses endpoints isolam o tráfego da internet pública.

    • Tempos de resposta mais rápidos: Como operam em uma rede VPC interna, geralmente apresentam tempos de resposta menores que os endpoints públicos, evitando limitações de latência e largura de banda da rede pública.

    • Custos reduzidos: A comunicação ocorre pela rede interna, o que pode diminuir ou eliminar cobranças de transferência de dados.

Para mais informações, consulte Endpoints.

Identidades de usuário suportadas

Identidade

Suporte

Alibaba Cloud account

Sim

RAM User (Recomendado)

Sim

RAM Role (Recomendado)

Sim

Recomendamos o uso de um RAM User ou de uma RAM Role com as permissões mínimas necessárias para chamar APIs.

Mais informações

Métodos de integração

Nota

Os SDKs representam a forma mais simples e com melhor suporte para invocar a OpenAPI.

O File Storage NAS suporta múltiplos métodos de integração, incluindo SDKs, Alibaba Cloud CLI, conjunto de ferramentas open-source do NAS, Terraform e Resource Orchestration Service (ROS). Escolha o método mais adequado às suas necessidades.

SDKs da Alibaba Cloud

  • A Alibaba Cloud fornece SDKs para Java, C#, Go, Python, Node.js/TypeScript, PHP e C++. Esses SDKs permitem invocar operações da OpenAPI por meio de métodos tipados, gerenciando automaticamente lógica de assinatura, timeouts e tentativas. Eles retornam objetos de resposta estruturados, o que simplifica o desenvolvimento. Para mais detalhes sobre os SDKs da Alibaba Cloud, consulte Alibaba Cloud SDKs.

  • Use os SDKs da Alibaba Cloud para chamar as APIs do File Storage NAS. Para linguagens suportadas e métodos de instalação de dependências, consulte SDK do File Storage NAS.

Alibaba Cloud CLI

A Alibaba Cloud CLI permite executar o comando aliyun em um terminal para interagir com os services da Alibaba Cloud e gerenciar recursos cloud. Para mais informações sobre a Alibaba Cloud CLI, consulte What is Alibaba Cloud CLI.

Conjunto de ferramentas open-source do NAS

O Alibaba Cloud NAS disponibiliza um conjunto de ferramentas open-source com suporte oficial no GitHub, contendo scripts e utilitários para testes de desempenho, auxílio na montagem e análise de capacidade.

  • Ferramenta de estatísticas de capacidade do NAS (nas_stat_util)

    Analisa e coleta estatísticas sobre o uso de capacidade no nível de diretório para um sistema de arquivos NAS. Suporta diversas condições de filtragem e formatos de saída.

  • Kit de ferramentas de montagem NAS/CPFS (alinas-utils)

    Um kit de ferramentas para montar sistemas de arquivos NAS e CPFS da Alibaba Cloud.

Visite a página do projeto no GitHub para obter a lista completa de ferramentas e instruções de uso.

Resource Orchestration Service (ROS)

  • O Resource Orchestration Service (ROS) simplifica o gerenciamento de recursos cloud. Defina seus recursos da Alibaba Cloud e suas dependências em modelos, e o mecanismo do ROS os criará e configurará automaticamente. Para mais informações, consulte What is Resource Orchestration Service.

  • Para verificar os tipos de recursos do File Storage NAS suportados pelo ROS, consulte ROS integration examples.

Encapsulamento personalizado de API

Chamadas HTTP diretas exigem a implementação do algoritmo de assinatura e a construção de requisições personalizadas. Para mais detalhes sobre o mecanismo de assinatura, consulte API reference guide e V3 request body and signing mechanism.

Solução de problemas

Solução de problemas com códigos de erro

Se uma chamada de API retornar um erro, use o código de erro recebido para diagnosticar o problema. Para mais informações, consulte Central de Códigos de Erro.

Diagnóstico autônomo

Registre o RequestID da resposta da API ou das informações de erro do SDK e use a Plataforma de Diagnóstico da OpenAPI da Alibaba Cloud para diagnósticos autônomos.