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 completa 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. Invoque operações da OpenAPI para serviços da Alibaba Cloud, visualize requisições e respostas e gere exemplos de chamadas via SDK. Para mais informações, consulte O que é OpenAPI?.
Versão
A OpenAPI da Alibaba Cloud utiliza números de versão para gerenciar as listas de APIs dos produtos em nuvem. 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 |
|
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 de API na seguinte URL: https://next.api.alibabacloud.com/api/NAS/2017-06-26/CreateFileSystem?tab=DOC
Endpoints
Para obter latência ideal, selecione o endpoint de serviço 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 |
Suportada |
|
Sim |
|
|
Usuário RAM (Recomendado) |
Sim |
|
Função RAM (Recomendado) |
Sim |
Recomendamos o uso de um Usuário RAM ou de uma Função RAM com as permissões mínimas necessárias para chamar APIs.
Mais informações
Métodos de integração
Os SDKs representam a forma mais simples e com melhor suporte para chamar a OpenAPI.
O File Storage NAS suporta vários 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 que melhor atende à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 novas tentativas. Eles retornam objetos de resposta estruturados, o que simplifica o desenvolvimento. Para mais informações sobre os SDKs da Alibaba Cloud, consulte SDKs da Alibaba Cloud.
Utilize 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 serviços da Alibaba Cloud e gerenciar recursos em nuvem. Para mais informações sobre a Alibaba Cloud CLI, consulte O que é Alibaba Cloud CLI.
Conjunto de ferramentas open-source do NAS
O Alibaba Cloud NAS oferece um conjunto de ferramentas open-source com suporte oficial no GitHub, contendo scripts e utilitários para testes de desempenho, assistência de 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 uma lista completa de ferramentas e instruções de uso.
Resource Orchestration Service (ROS)
O Resource Orchestration Service (ROS) simplifica o gerenciamento de recursos em nuvem. Defina seus recursos da Alibaba Cloud e suas dependências em modelos para que o mecanismo do ROS os crie e configure automaticamente. Para mais informações, consulte O que é Resource Orchestration Service.
Para verificar os tipos de recursos do File Storage NAS suportados pelo ROS, consulte Exemplos de integração com ROS.
Encapsulamento personalizado de API
Chamadas HTTP brutas 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 o Guia de referência da API e Corpo da requisição V3 e mecanismo de assinatura.
Solução de problemas
Solução de problemas com códigos de erro
Se uma chamada de API retornar um erro, utilize o código de erro retornado para diagnosticar o problema. Para mais informações, consulte Central de Códigos de Erro.
Diagnóstico de autoatendimento
Registre o RequestID da resposta da API ou as informações de erro do SDK e utilize a Plataforma de Diagnóstico da OpenAPI da Alibaba Cloud para diagnóstico de autoatendimento.