O Cloud Parallel File Storage (CPFS) oferece quatro métodos para gerenciar recursos programaticamente: SDK, interface de linha de comando (CLI), Terraform e Resource Orchestration Service (ROS).
Escolha um método de integração
A Alibaba Cloud disponibiliza o OpenAPI Explorer para ajudar desenvolvedores a aprender e usar as APIs dos serviços em nuvem de forma rápida e eficiente. Essa ferramenta combina funcionalidades como busca inteligente de APIs, documentação, depuração online, obtenção de SDKs, exemplos de código, diagnóstico de erros e estatísticas de chamadas. Com o OpenAPI Explorer, você chama as APIs dos serviços da Alibaba Cloud e visualiza as requisições e respostas correspondentes. A ferramenta também gera automaticamente códigos de exemplo de SDK para acelerar o início do uso dos serviços. Para mais informações, consulte O que é o OpenAPI?.
Versões
A OpenAPI da Alibaba Cloud utiliza números de versão para gerenciar as releases das APIs de seus serviços. Por exemplo, o Cloud Parallel File Storage (CPFS) suporta atualmente a versão da API 2017-06-26. Esse identificador representa um número de versão, não uma data. Ele indica a estrutura de dados da API e não significa que a API permaneceu inalterada desde 2017-06-26.
O Cloud Parallel File Storage (CPFS) e o Apsara File Storage NAS compartilham o mesmo SDK. Portanto, use os endpoints e o SDK do Apsara File Storage NAS ao trabalhar com o CPFS.
|
Versão |
Descrição |
|
Recomendada |
Depuração online
O Cloud Parallel File Storage (CPFS) oferece recursos como depuração de API no OpenAPI Explorer. Antes de chamar uma API, compreenda as versões, os endpoints e os métodos de integração fornecidos pelo CPFS.
Na página de depuração do OpenAPI Explorer, o painel de navegação à esquerda lista as APIs de sistema de arquivos, como CreateFileSystem, DeleteFileSystem e DescribeFileSystems. O painel central contém o formulário de configuração de parâmetros da API CreateFileSystem. Esse formulário inclui campos como FileSystemType (valores válidos: standard, extreme, cpfs), ChargeType (valores válidos: PayAsYouGo, Subscription), Duration, Capacity, Bandwidth, StorageType (obrigatório, marcado com um asterisco vermelho) e ZoneId. Selecione um endpoint para uma região específica, como China East 1 (Hangzhou). Na parte inferior da página, há um botão Send Request.
Ponto de entrada para depuração
Para depurar a API, acesse Cloud Parallel File Storage (CPFS).
A tabela a seguir compara os quatro métodos de integração para ajudar você a escolher aquele que melhor se adapta ao seu caso de uso.
|
Método |
Funcionamento |
Quando usar |
|
SDK (recomendado) |
Chama a OpenAPI por meio de uma biblioteca cliente nativa da linguagem. Gerencia autenticação, novas tentativas e análise de respostas automaticamente. |
Ideal para desenvolver aplicações ou scripts de automação em Python, Java, Go ou outras linguagens suportadas. Melhor opção para a maioria dos desenvolvedores. |
|
CLI |
Interage com a OpenAPI por meio de uma ferramenta de linha de comando. Não exige codificação. |
Adequado para executar operações pontuais, escrever scripts shell ou testar chamadas de API interativamente. |
|
Terraform |
Declara recursos do CPFS como infraestrutura como código. Converte modelos em chamadas de OpenAPI. |
Projetado para gerenciar recursos do CPFS juntamente com outras infraestruturas de nuvem em fluxos de trabalho GitOps ou de infraestrutura como código (IaC). |
|
Resource Orchestration Service (ROS) |
Usa o ROS da Alibaba Cloud para definir e implantar pilhas de recursos a partir de modelos. |
Recomendado para orquestrar recursos do CPFS com outros recursos da Alibaba Cloud como parte de uma pilha de implantação maior. |
Endpoints
Para minimizar a latência, use o endpoint da região onde seus recursos do CPFS estão localizados. Por exemplo, o endpoint público do CPFS na região China (Ulanqab) é nas.cn-wulanchabu.aliyuncs.com, e o endpoint de VPC é nas-vpc.cn-wulanchabu.aliyuncs.com.
Dois tipos de endpoint estão disponíveis:
Endpoints públicos — acessíveis de qualquer lugar, inclusive fora da Alibaba Cloud.
-
Endpoints de VPC — acessíveis apenas de dentro de uma virtual private cloud (VPC) na mesma região da Alibaba Cloud. Vantagens dos endpoints de VPC:
Maior segurança: os endpoints de VPC são acessíveis somente de dentro de uma VPC, oferecendo isolamento e privacidade mais robustos.
Menor latência: esses endpoints usam caminhos de rede interna, que geralmente proporcionam tempos de resposta mais rápidos que os endpoints públicos e ajudam a evitar problemas como latência da Internet e limitações de largura de banda.
Custo reduzido: a comunicação ocorre via rede interna.
A tabela abaixo lista as regiões e os endpoints suportados para o CPFS General-purpose Edition.
|
Nome da região |
ID da região |
Endpoint público |
Endpoint de VPC |
|
China (Qingdao) |
cn-qingdao |
nas.cn-qingdao.aliyuncs.com |
nas-vpc.cn-qingdao.aliyuncs.com |
|
China (Beijing) |
cn-beijing |
nas.cn-beijing.aliyuncs.com |
nas-vpc.cn-beijing.aliyuncs.com |
|
China (Zhangjiakou) |
cn-zhangjiakou |
nas.cn-zhangjiakou.aliyuncs.com |
nas-vpc.cn-zhangjiakou.aliyuncs.com |
|
China (Hohhot) |
cn-huhehaote |
nas.cn-huhehaote.aliyuncs.com |
nas-vpc.cn-huhehaote.aliyuncs.com |
|
China (Ulanqab) |
cn-wulanchabu |
nas.cn-wulanchabu.aliyuncs.com |
nas-vpc.cn-wulanchabu.aliyuncs.com |
|
China (Hangzhou) |
cn-hangzhou |
nas.cn-hangzhou.aliyuncs.com |
nas-vpc.cn-hangzhou.aliyuncs.com |
|
China (Shanghai) |
cn-shanghai |
nas.cn-shanghai.aliyuncs.com |
nas-vpc.cn-shanghai.aliyuncs.com |
|
China (Shenzhen) |
cn-shenzhen |
nas.cn-shenzhen.aliyuncs.com |
nas-vpc.cn-shenzhen.aliyuncs.com |
|
China (Heyuan) |
cn-heyuan |
nas.cn-heyuan.aliyuncs.com |
nas-vpc.cn-heyuan.aliyuncs.com |
|
China (Chengdu) |
cn-chengdu |
nas.cn-chengdu.aliyuncs.com |
nas-vpc.cn-chengdu.aliyuncs.com |
|
Singapore |
ap-southeast-1 |
nas.ap-southeast-1.aliyuncs.com |
nas-vpc.ap-southeast-1.aliyuncs.com |
Identidades de usuário suportadas
|
Identidade do usuário |
Status de suporte |
|
Suportado |
|
|
Usuário RAM (Recomendado) |
Suportado |
|
Função RAM (Recomendado) |
Suportado |
Recomendamos o uso de um usuário RAM ou de uma função RAM para fazer chamadas de API, concedendo permissões com base nas necessidades específicas do seu negócio.
Mais informações
Métodos de integração
O SDK oferece a configuração mais simples e o melhor suporte a longo prazo. Use-o, a menos que tenha um motivo específico para escolher outro método, como criar scripts de operações shell (CLI) ou gerenciar infraestrutura como código (Terraform ou ROS).
SDK da Alibaba Cloud
A Alibaba Cloud fornece SDKs para diversas linguagens de programação, incluindo Java, C#, Go, Python, Node.js/TypeScript, PHP e C++. Use esses SDKs para chamar as APIs. Eles simplificam o desenvolvimento ao gerenciar a lógica de assinatura, timeouts e novas tentativas, além de retornar objetos de resposta estruturados. Para mais informações sobre o SDK da Alibaba Cloud, consulte SDK da Alibaba Cloud.
Use o SDK da Alibaba Cloud para chamar as APIs do Cloud Parallel File Storage (CPFS) no OpenAPI Explorer. Para obter informações sobre as linguagens suportadas e como instalar dependências, consulte SDK do Apsara File Storage NAS.
CLI da Alibaba Cloud
A CLI da Alibaba Cloud permite interagir com os serviços da Alibaba Cloud e gerenciar seus recursos de nuvem pela linha de comando usando o comando aliyun. Para mais informações sobre a CLI da Alibaba Cloud, consulte O que é a CLI da Alibaba Cloud.
Chamadas manuais de API (Não recomendado)
Para fazer chamadas HTTP nativas, implemente o algoritmo de assinatura e construa requisições personalizadas. Para mais detalhes sobre o mecanismo de assinatura, consulte Referência da API e Corpo da requisição V3 e mecanismo de assinatura.
Notas de uso
Se uma chamada de API retornar um erro, use o código de erro retornado para verificar se os parâmetros e valores da sua requisição estão corretos. Para mais informações, consulte Central de Códigos de Erro.
Registre o RequestID ou a mensagem de erro do SDK retornada pela chamada e use a Plataforma de Diagnóstico da OpenAPI da Alibaba Cloud para diagnósticos de autoatendimento.