Todos os produtos
Search
Central de documentação

File Storage NAS:Visão geral da API

Última atualização: Aug 05, 2026

Padrões de API e SDKs predefinidos multilíngues

A OpenAPI deste produto (NAS/2017-06-26) utiliza o estilo de assinatura RPC. Encapsulamos SDKs para linguagens de programação comuns para desenvolvedores. Os desenvolvedores podem baixar o SDK para chamar diretamente a OpenAPI deste produto sem se preocupar com detalhes técnicos. Se o SDK existente não atender às suas necessidades, você pode usar o mecanismo de assinatura para integração com assinatura própria. Como os detalhes da autoassinatura são muito complexos, isso pode levar cerca de 5 dias úteis. Portanto, recomendamos ingressar em nosso grupo de serviço DingTalk (147535001692) e realizar a integração de assinatura sob orientação especializada.

Antes de usar a API, você precisa preparar sua conta de identidade e chave de acesso (AccessKey) para acessar efetivamente a API por meio de ferramentas cliente (SDK, CLI, etc.). Para obter detalhes, consulte Obter um AccessKey.

Cenários de assinatura personalizada

Se o seu cenário de negócios tiver requisitos especiais e você precisar integrar a API por meio de autoassinatura, recomendamos consultar primeiro nossa equipe de suporte técnico (grupo de serviço DingTalk: 147535001692) para obter orientação profissional e garantir uma integração eficiente.

Preparação de conta e segurança

As contas da Alibaba Cloud têm permissões administrativas completas sobre todos os recursos. Quando um AccessKey é comprometido, todos os recursos associados estarão em risco de acesso não autorizado. Para garantir a segurança, recomenda-se criar um usuário RAM com apenas permissões de acesso à API e configurar seu AccessKey, além de configurar políticas RAM com base no princípio do menor privilégio (PoLP). Use a conta da Alibaba Cloud apenas em cenários específicos em que as permissões da conta da Alibaba Cloud sejam explicitamente necessárias.

Operações de serviço

API

Título

Descrição

OpenNASService OpenNASService. Ativa o serviço NAS.

Região

API

Título

Descrição

DescribeZones DescribeZones. Consulta todas as zonas em uma região e os tipos de sistema de arquivos compatíveis em cada zona.
DescribeRegions Query regions Consulta as regiões disponíveis do Alibaba Cloud.

Sistema de arquivos

API

Título

Descrição

CreateFileSystem Create a file system. Cria um sistema de arquivos.
DeleteFileSystem DeleteFileSystem. Exclui um sistema de arquivos.
ModifyFileSystem Modificar descrição do sistema de arquivos. Modifica a descrição de um sistema de arquivos.
DescribeFileSystems Consultar informações do sistema de arquivos. Consulta informações do sistema de arquivos.
UpgradeFileSystem UpgradeFileSystem. Aumenta a capacidade de um sistema de arquivos Extreme NAS ou de um sistema de arquivos Cloud Parallel File Storage (CPFS).
DescribeFilesystemsAssociatedHpnZones DescribeFilesystemsAssociatedHpnZones. Obtém a lista de HpnZones para um sistema de arquivos. O desempenho de acesso é ideal quando os nós de computação estão localizados em uma das HpnZones associadas.

Ponto de montagem

API

Título

Descrição

CreateMountTarget Create a mount target Creates a mount target.
DeleteMountTarget DeleteMountTarget. Exclui um destino de montagem.
ModifyMountTarget Modificar informações do ponto de montagem. Modifica as informações do ponto de montagem.
DescribeMountTargets Consultar informações de pontos de montagem. Consulta informações de pontos de montagem.
DescribeMountedClients DescribeMountedClients. Consulta os clientes nos quais um sistema de arquivos está montado.

Ponto de acesso

API

Título

Descrição

CreateAccessPoint Criar um ponto de acesso. Cria um ponto de acesso.
ModifyAccessPoint Modificar informações do ponto de acesso. Modifica as informações do ponto de acesso.
DescribeAccessPoints Consultar informações de pontos de acesso. Consulta informações de pontos de acesso.
DescribeAccessPoint Consultar detalhes do ponto de acesso. Consulta os detalhes de um ponto de acesso.
DeleteAccessPoint DeleteAccessPoint. Exclui um ponto de acesso.
ListAccessPoints Consultar informações de pontos de acesso. Consulta informações de pontos de acesso.
CreateDir CreateDir. Cria um diretório em um sistema de arquivos.

Grupo de permissões

API

Título

Descrição

CreateAccessGroup Create a permission group Creates a permission group.
DeleteAccessGroup Delete access group Delete an existing access group.
ModifyAccessGroup Modify a permission group. Modifica um grupo de permissões.
DescribeAccessGroups Query permission group information Queries permission group information.
CreateAccessRule Create a permission rule Creates a permission rule for a permission group.
DeleteAccessRule Delete a permission rule Deletes a permission rule from a permission group.
ModifyAccessRule Modify a permission group rule Modifica uma regra de permissão em um grupo de permissões.
DescribeAccessRules Consultar descrição da regra de permissão. Consulta a descrição de uma regra de permissão.

Snapshot

API

Título

Descrição

CreateSnapshot CreateSnapshot. Cria um snapshot.
DeleteSnapshot Excluir um snapshot ou cancelar uma tarefa de snapshot que está sendo criada. Exclui um snapshot especificado ou cancela uma tarefa de snapshot que está sendo criada.
DescribeSnapshots Consultar lista de snapshots. Consulta informações sobre um ou mais snapshots de um sistema de arquivos especificado.
CreateAutoSnapshotPolicy Create an automatic snapshot policy Creates an automatic snapshot policy.
DeleteAutoSnapshotPolicy DeleteAutoSnapshotPolicy. Exclui uma política de snapshot automático.
ModifyAutoSnapshotPolicy ModifyAutoSnapshotPolicy. Modifica uma política de snapshot automático. Após a modificação de uma política de snapshot automático aplicada a um sistema de arquivos, a alteração é aplicada imediatamente aos snapshots subsequentes criados para o sistema de arquivos.
ApplyAutoSnapshotPolicy Aplicar uma política de snapshot automático a sistemas de arquivos. Aplica uma política de snapshot automático a um ou mais sistemas de arquivos.
CancelAutoSnapshotPolicy Cancelar a política de snapshot automático para um ou mais sistemas de arquivos. Cancela a política de snapshot automático criada para um sistema de arquivos.
DescribeAutoSnapshotPolicies Consultar políticas de snapshot automático criadas. Consulta as políticas de snapshot automático que foram criadas.
DescribeAutoSnapshotTasks Query automatic snapshot tasks. Consulta a lista de tarefas de snapshot automático.
ResetFileSystem Reverter um sistema de arquivos para um snapshot. Reverte um sistema de arquivos para o estado de um snapshot histórico especificado.

Tag

API

Título

Descrição

TagResources TagResources. Cria tags e as vincula a sistemas de arquivos.
UntagResources UntagResources. Remove as tags de um sistema de arquivos.
ListTagResources ListTagResources. Consulta tags.

Cota

API

Título

Descrição

SetDirQuota Set a directory quota for a file system Define uma cota de diretório para um sistema de arquivos.
CancelDirQuota Cancel a directory quota for a file system Cancels a directory quota for a file system.
DescribeDirQuotas DescribeDirQuotas. Consulta as cotas de diretório de um sistema de arquivos.

Gerenciamento de ciclo de vida

API

Título

Descrição

CreateLifecyclePolicy Create a lifecycle management policy Cria uma política de gerenciamento de ciclo de vida.
UpdateLifecyclePolicy Atualizar as regras de uma política de gerenciamento de ciclo de vida. Atualiza as regras de uma política de gerenciamento de ciclo de vida. Apenas o CPFS for Lingjun é suportado. UpdateLifecyclePolicy utiliza semântica de sobrescrita. Se um parâmetro opcional for deixado vazio, o campo correspondente será excluído. Para adicionar regras de ciclo de vida, primeiro chame a operação DescribeLifecyclePolicies para obter as configurações atuais das regras de ciclo de vida, adicione as novas configurações de regras de ciclo de vida e, em seguida, chame a operação UpdateLifecyclePolicy para atualizar as configurações das regras de ciclo de vida.
DeleteLifecyclePolicy DeleteLifecyclePolicy. Exclui uma política de ciclo de vida.
ModifyLifecyclePolicy Modify a lifecycle management policy Modifica uma política de gerenciamento de ciclo de vida.
GetDirectoryOrFileProperties GetDirectoryOrFileProperties. Verifica se um diretório especificado contém arquivos de armazenamento de acesso infrequente ou archive, ou se um arquivo especificado é um arquivo de armazenamento de acesso infrequente ou archive.
DescribeLifecyclePolicies Consultar políticas de gerenciamento de ciclo de vida. Obtém a lista de políticas de gerenciamento de ciclo de vida.
CreateLifecycleRetrieveJob Create a data retrieval task Creates a data retrieval task.
CancelLifecycleRetrieveJob CancelLifecycleRetrieveJob. Cancela uma tarefa de recuperação de dados em execução.
RetryLifecycleRetrieveJob RetryLifecycleRetrieveJob. Tenta novamente uma tarefa de recuperação de dados com falha.
StartLifecyclePolicyExecution StartLifecyclePolicyExecution. Inicia a execução de uma política de ciclo de vida.
StopLifecyclePolicyExecution Stop executing a lifecycle policy Interrompe a execução de uma política de ciclo de vida.
DescribeLifecyclePolicyLogs Consultar logs de execução de uma política de ciclo de vida. Consulta os logs de execução de uma política de ciclo de vida. Você pode consultar logs dos últimos 90 dias ou até 1000 entradas de log. Apenas o CPFS for Lingjun é suportado.
ListLifecycleRetrieveJobs Consultar lista de tarefas de recuperação de dados. Obtém a lista de tarefas de recuperação de dados criadas.
ListDirectoriesAndFiles Consultar lista de diretórios e arquivos. Obtém a lista de arquivos da classe de armazenamento IA e subdiretórios que contêm arquivos da classe de armazenamento IA em um diretório especificado em um sistema de arquivos NAS de uso geral.

Lixeira

API

Título

Descrição

EnableRecycleBin EnableRecycleBin. Ativa o recurso de lixeira para um sistema de arquivos.
DisableAndCleanRecycleBin DisableAndCleanRecycleBin. Desativa e esvazia a lixeira de um sistema de arquivos NAS de uso geral.
UpdateRecycleBinAttribute UpdateRecycleBinAttribute. Modifica o período de retenção de dados na lixeira de um sistema de arquivos.
GetRecycleBinAttribute Obter atributos da lixeira. Consulta a configuração da lixeira de um sistema de arquivos NAS de uso geral especificado.
CreateRecycleBinRestoreJob CreateRecycleBinRestoreJob Restaura um arquivo ou diretório da lixeira.
CreateRecycleBinDeleteJob Excluir permanentemente um arquivo ou diretório da lixeira. Cria uma tarefa para excluir permanentemente um arquivo ou diretório da lixeira.
CancelRecycleBinJob CancelRecycleBinJob. Cancela um job em execução da lixeira.
ListRecycleBinJobs Consultar tarefas na lixeira. Consulta informações sobre uma ou mais tarefas na lixeira.
ListRecentlyRecycledDirectories Consultar diretórios excluídos recentemente. Consulta diretórios nos quais operações de exclusão foram realizadas recentemente.
ListRecycledDirectoriesAndFiles Query deleted files or directories Consulta arquivos ou diretórios excluídos.

AgenticSpace

API

Título

Descrição

CreateAgenticSpace Create an agentic space. Cria um espaço Agentic.
ModifyAgenticSpace Modify an agentic space. Modifica um espaço Agentic.
GetAgenticSpace Query an agentic space. Consulta um espaço Agentic.
DeleteAgenticSpace Excluir um espaço agentic. Exclui um espaço agentic.
SetAgenticSpaceQuota Set agenticSpace quota. Define a cota para um espaço Agentic.
DescribeAgenticSpaces Query agenticSpace. Consulta espaços Agentic.

ACL do AD SMB

API

Título

Descrição

EnableSmbAcl Enable SMB AD ACL. Ativa o recurso SMB AD ACL.
DisableSmbAcl Disable SMB AD ACL. Desativa o recurso SMB AD ACL.
ModifySmbAcl Update SMB AD ACL. Atualiza o recurso de ACL do AD SMB.
DescribeSmbAcl Query SMB AD ACL. Consulta o recurso SMB AD ACL.
CreateFile CreateFile. Cria um diretório ou arquivo.

ACL do NAS NFS

API

Título

Descrição

EnableNfsAcl EnableNfsAcl. Ativa o recurso de ACL NFS para um sistema de arquivos.
DisableNfsAcl DisableNfsAcl. Desativa o recurso de ACL NFS para um sistema de arquivos.
DescribeNfsAcl DescribeNfsAcl. Consulta se o recurso NFS ACL está ativado para um sistema de arquivos.

Gerenciamento de logs

API

Título

Descrição

CreateLogAnalysis CreateLogAnalysis. Exporta os logs de um sistema de arquivos NAS de uso geral para o Simple Log Service.
DeleteLogAnalysis DeleteLogAnalysis. Desativa o despejo de logs para um sistema de arquivos NAS de uso geral.
DescribeLogAnalysis Retrieve log analysis information Lists the log analysis configurations in log analysis.

Grupo de recursos

API

Título

Descrição

ChangeResourceGroup Change resource group Changes the resource group to which a file system instance belongs.

Canal de armazenamento virtual

API

Título

Descrição

DetachVscFromFilesystems Dissociar um dispositivo VSC de um sistema de arquivos. Dissocia um dispositivo VSC de um sistema de arquivos.
AttachVscToFilesystems Associate a VSC device with a file system Associa um dispositivo VSC a um sistema de arquivos.
DescribeFilesystemsVscAttachInfo Consulta as informações do canal de armazenamento virtual associado a um sistema de arquivos. Consulta as informações do canal de armazenamento virtual associado a um sistema de arquivos.