Todos os produtos
Search
Central de documentação

Cloud Parallel File Storage:CreateFileSystem

Última atualização: Oct 21, 2026

Cria um sistema de arquivos.

Descrição da operação

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

nas:CreateFileSystem

create

*FileSystem.

acs:nas:{#regionId}:{#accountId}:filesystem/*

  • nas:EncryptedType
  • nas:FileSystemType
Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

FileSystemType

string

Não

O tipo do sistema de arquivos.

Valores válidos:

  • standard: NAS de uso geral. Este é o valor padrão.

  • extreme: NAS Extreme.

  • cpfs: Cloud Parallel File Storage (edição com redundância local).

  • cpfsse: Cloud Parallel File Storage SE (edição com redundância de zona).

Valores válidos:

  • standard :

    NAS de uso geral.

  • cpfs :

    Cloud Paralleled File System (edição com redundância local)

  • cpfsse :

    Cloud Paralleled File System SE (edição com redundância de zona)

  • extreme :

    NAS Extreme.

standard

ChargeType

string

Não

O método de cobrança.

Valores válidos:

  • PayAsYouGo: pós-pago. Este é o valor padrão.

  • Subscription: assinatura.

Valores válidos:

  • PayAsYouGo :

    Pós-pago.

  • Subscription :

    Assinatura.

PayAsYouGo

Duration

integer

Não

A duração da assinatura.

Unidade: meses. Este parâmetro é obrigatório e só entra em vigor quando ChargeType é definido como Subscription.

Se nenhuma renovação for realizada quando a instância de assinatura expirar, a instância expirará e estará sujeita à liberação automática.

1

Capacity

integer

Não

A capacidade do sistema de arquivos. Unidade: GiB. Este parâmetro é obrigatório e só entra em vigor quando FileSystemType é definido como extreme, cpfs ou cpfsse.

Para valores válidos, consulte as especificações reais na página de compra:

100

Bandwidth

integer

Não

A taxa de transferência máxima do sistema de arquivos.

Unidade: MB/s.

Para valores válidos, consulte as especificações reais na página de compra.

Página de compra do sistema de arquivos paralelo CPFS (pós-pago)

150

StorageType

string

Sim

O tipo de armazenamento.

  • Quando FileSystemType é definido como standard, os valores válidos são Performance, Capacity, Premium e Agentic (AgenticFS).

  • Quando FileSystemType é definido como extreme, os valores válidos são standard (Standard) e advance (Advanced).

  • Quando FileSystemType é definido como cpfs, os valores válidos são advance_100 (linha de base de 100 MB/s/TiB), advance_200 (linha de base de 200 MB/s/TiB) e economic (Economy).

  • Quando FileSystemType é definido como cpfsse, o valor válido é advance_100 (linha de base de 100 MB/s/TiB).

Valores válidos:

  • Agentic :

    Agentic.

  • Capacity :

    Capacity.

  • Premium :

    Premium.

  • Performance :

    Performance.

  • economic :

    Economy.

  • advance :

    Advanced.

Performance

ZoneId

string

Não

O ID da zona.

Uma zona é uma área física com redes e redes elétricas independentes em uma região.

Quando FileSystemType é definido como standard, este parâmetro é opcional. Por padrão, uma zona ativa condicional é selecionada aleatoriamente com base nas configurações de ProtocolType e StorageType.

Quando FileSystemType é definido como extreme ou cpfs, este parâmetro é obrigatório.

Nota
  • Os sistemas de arquivos e os servidores do Elastic Compute Service em diferentes zonas ativas da mesma região podem se comunicar entre si.

  • Implante o sistema de arquivos e o Elastic Compute Service na mesma zona ativa para evitar latência entre zonas.

cn-hangzhou-b

ProtocolType

string

Sim

O tipo de protocolo de transferência de arquivos.

  • Quando FileSystemType é definido como standard, os valores válidos são NFS e SMB.

  • Quando FileSystemType é definido como extreme, o valor válido é NFS.

  • Quando FileSystemType é definido como cpfs, o valor válido é cpfs.

  • Quando FileSystemType é definido como cpfsse, o valor válido é cpfs.

Valores válidos:

  • dual :

    NFS e SMB.

  • SMB :

    SMB.

  • NFS :

    NFS.

NFS

EncryptType

integer

Não

Especifica se o sistema de arquivos deve ser criptografado.

Usa chaves gerenciadas pelo KMS para criptografar dados em repouso no sistema de arquivos. Ao ler e gravar dados criptografados, nenhuma descriptografia é necessária.

Valores válidos:

  • 0: não criptografado. Este é o valor padrão.

  • 1: chave gerenciada pelo NAS. Este valor é suportado quando FileSystemType é definido como standard ou extreme.

  • 2: chave personalizada. Este valor é suportado quando FileSystemType é definido como standard ou extreme.

Nota
  • Extreme NAS: O recurso de chave personalizada (KMS) é suportado em todas as regiões, exceto China East 1 Finance Cloud.

  • NAS de uso geral: O recurso de chave personalizada (KMS) é suportado em todas as regiões.

Valores válidos:

  • 0 :

    Não criptografado.

  • 1 :

    Criptografia com chave gerenciada pelo NAS.

  • 2 :

    Criptografia com chave personalizada.

1

SnapshotId

string

Não

O ID do snapshot.

Este parâmetro é suportado apenas para sistemas de arquivos Extreme NAS do tipo de armazenamento Advanced.

Nota

Se você criar um sistema de arquivos a partir de um snapshot, o sistema de arquivos criado terá a mesma versão do sistema de arquivos de origem do snapshot. Por exemplo, se o sistema de arquivos de origem do snapshot for da versão 1 e você quiser criar um sistema de arquivos da versão 2, poderá primeiro criar o Sistema de Arquivos A a partir do snapshot, depois criar o Sistema de Arquivos B que atenda às configurações da versão 2, copiar os dados do Sistema de Arquivos A para o Sistema de Arquivos B e, em seguida, migrar seu negócio para o Sistema de Arquivos B.

s-extreme-snapsho****

VpcId

string

Não

O ID da VPC.

  • Este parâmetro é obrigatório quando FileSystemType é definido como cpfs ou cpfsse.

  • Este parâmetro é reservado e não entra em vigor quando FileSystemType é definido como standard ou extreme. Você não precisa configurar este parâmetro.

vpc-bp18cx9a7zoh0h9b4****

VSwitchId

string

Não

O ID do vSwitch.

  • Este parâmetro é obrigatório quando FileSystemType é definido como cpfs.

  • Este parâmetro é reservado e não entra em vigor quando FileSystemType não é definido como cpfs. Você não precisa configurar este parâmetro.

vsw-bp131dkqilvw5pnlt****

Description

string

Não

A descrição do sistema de arquivos.

Limites:

  • A descrição deve ter de 2 a 128 caracteres de comprimento.

  • A descrição deve começar com uma letra e não pode começar com http:// ou https://.

  • A descrição pode conter dígitos, dois-pontos (:), sublinhados (_) e hifens (-).

The description of the file system

ClientToken

string

Não

O token do cliente que é usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que o valor seja exclusivo entre diferentes solicitações. O token do cliente pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.

Nota

Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o ClientToken. O RequestId de cada solicitação de API pode ser diferente.

123e4567-e89b-12d3-a456-42665544****

KmsKeyId

string

Não

O ID da chave do KMS.

Este parâmetro é obrigatório apenas quando EncryptType é definido como 2.

fcbd****-62**-4a**-b605-c58cc1d5****

DryRun

boolean

Não

Especifica se deve ser realizado um dry run na solicitação de criação.

Um dry run ajuda a verificar a validade dos parâmetros e o inventário, sem realmente criar a instância ou incorrer em taxas.

Valores válidos:

  • true: realiza um dry run sem criar a instância. O sistema verifica se os parâmetros obrigatórios foram especificados, o formato da solicitação, os limites de negócios e o inventário do NAS. Se a solicitação falhar no dry run, um erro será retornado. Se a solicitação passar no dry run, o código de status HTTP 200 será retornado, mas o FileSystemId estará vazio.

  • false: realiza uma solicitação normal. Se a solicitação passar no dry run, a instância será criada. Este é o valor padrão.

true

ResourceGroupId

string

Não

O ID do grupo de recursos.

Você pode visualizar o ID do grupo de recursos no console do Resource Management.

rg-acfmwavnfdf****

Tag

array<object>

Não

As tags.

Comprimento do array: 1 a 20. Se o array contiver vários objetos de tag, as chaves de tag devem ser exclusivas.

object

Não

O objeto de tag.

Key

string

Não

A chave da tag.

Limites:

  • A chave da tag não pode estar vazia ou ser uma string vazia.

  • A chave da tag pode ter até 128 caracteres de comprimento.

  • A chave da tag não pode começar com aliyun ou acs:.

  • A chave da tag não pode conter http:// ou https://.

nastest

Value

string

Não

O valor da tag.

Limites:

  • O valor da tag não pode estar vazio ou ser uma string vazia.

  • O valor da tag pode ter até 128 caracteres de comprimento.

  • O valor da tag não pode conter http:// ou https://.

testValue

RedundancyType

string

Não

O tipo de redundância de armazenamento. Este parâmetro entra em vigor apenas para o Cloud Parallel File Storage SE. Valor válido: ZRS.

Valores válidos:

  • ZRS :

    Redundância de zona.

  • LRS :

    Armazenamento com redundância local.

ZRS

RedundancyVSwitchIds

array

Não

Os IDs dos vSwitches com redundância de zona. Este parâmetro é obrigatório quando RedundancyType é definido como ZRS. Você deve especificar três IDs de vSwitch, e os vSwitches devem residir em três zonas diferentes.

string

Não

O ID do vSwitch com redundância de zona.

vsw-123xxx

Observe os seguintes itens sobre a idempotência da API:
Como a operação CreateFileSystem envolve a criação de recursos em nuvem e incorre em taxas, o cliente pode tentar novamente a solicitação se ocorrer um tempo limite de solicitação ou erro interno do servidor. Especifique o parâmetro ClientToken na solicitação para evitar pedidos duplicados causados por múltiplas tentativas.

Nota

Esta operação suporta idempotência apenas quando o parâmetro FileSystemType é definido como extreme ou cpfs. Quando o parâmetro FileSystemType é definido como standard, esta operação não suporta idempotência.

Os detalhes do parâmetro ClientToken são os seguintes:

  • ClientToken é uma string exclusiva e sensível a maiúsculas e minúsculas que é gerada pelo cliente e contém no máximo 64 caracteres ASCII. Exemplo: ClientToken=123e4567-e89b-12d3-a456-42665544****

  • Se você especificar um ClientToken que já foi usado, mas outros parâmetros de solicitação foram alterados, o NAS retornará o código de erro IdempotentParameterMismatch.

Nota

Os parâmetros SignatureNonce, Timestamp e Signature devem ser alterados durante uma nova tentativa. Isso ocorre porque o NAS usa SignatureNonce para evitar ataques de repetição e Timestamp para registrar a hora de cada solicitação. Portanto, você deve fornecer valores diferentes para os parâmetros SignatureNonce e Timestamp em uma nova tentativa, o que também resulta em uma alteração no valor de Signature.

  • Após a adição do parâmetro ClientToken:

    • Se o código de status HTTP 200 for retornado, o cliente poderá obter o mesmo resultado da solicitação anterior após uma nova tentativa, e o status do servidor não será afetado.

    • Se um código de status HTTP 4xx for retornado e a mensagem de erro não contiver informações semelhantes a "try it later", a nova tentativa nunca será bem-sucedida. Você deve solucionar o problema com base na mensagem de erro, modificar os parâmetros da solicitação e, em seguida, tentar a solicitação novamente.

    • Se um código de status HTTP 5xx for retornado, isso indica que pode ter ocorrido um tempo limite de rede ou um erro interno do servidor. Você pode reenviar a mesma solicitação, que deve conter o mesmo ClientToken e os mesmos parâmetros de solicitação de negócios, para confirmar o resultado da solicitação.

  • Um ClientToken é válido por 30 dias.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A estrutura da resposta.

FileSystemId

string

O ID do sistema de arquivos criado.

1ca404****

RequestId

string

O ID da solicitação.

98696EF0-1607-4E9D-B01D-F20930B6****

Exemplos

Resposta de sucesso

JSON formato

{
  "FileSystemId": "1ca404****",
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

202 RequestAccepted The request has been accepted by the server. A solicitação foi aceita pelo backend.
400 IdempotentParameterMismatch The same client token was passed in to different parameters. O mesmo ClientToken foi usado com parâmetros diferentes.
400 InvalidParameter.KmsServiceNotEnabled Key Management Service is not enabled. O KMS não está ativado.
400 DryRunOperation The request is validated with DryRun flag set. A solicitação passou na validação.
400 SubAccount.NoExtremeSLRPermission The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasExtreme. Please authorize the RAM user the permission ram:CreateServiceLinkedRole. O usuário atual do Resource Access Management (RAM) não tem as permissões necessárias para criar a função vinculada ao serviço AliyunServiceRoleForNasExtreme. Conceda a autorização ram:CreateServiceLinkedRole ao usuário do Resource Access Management (RAM).
400 SubAccount.NoStandardSLRPermission The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasStandard. Please authorize the RAM user the permission ram:CreateServiceLinkedRole. O usuário atual do Resource Access Management (RAM) não tem as permissões necessárias para criar a função vinculada ao serviço AliyunServiceRoleForNasStandard. Conceda a autorização ram:CreateServiceLinkedRole ao usuário do Resource Access Management (RAM).
400 SubAccount.NoEncryptionSLRPermission The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasEncryption. Please authorize the RAM user the permission ram:CreateServiceLinkedRole. O usuário atual do Resource Access Management (RAM) não tem as permissões necessárias para criar a função vinculada ao serviço AliyunServiceRoleForNasEncryption. Conceda a autorização ram:CreateServiceLinkedRole ao usuário do Resource Access Management (RAM).
400 InvalidParam.NotSupportBYOK The specified file system type does not support the BYOK encryption function. O tipo de sistema de arquivos especificado não oferece suporte à criptografia de chave personalizada (KMS).
400 MissingParameter.KmsKeyId When parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request. Quando o tipo de criptografia for Chave Personalizada (KMS), o parâmetro KmsKeyId é obrigatório.
400 InvalidParameter.InvalidKmsKeyId The specified KMS key ID is invalid. O KMS KeyId especificado é inválido.
400 InvalidParameter.KmsKeyIdNotFound The specified KMS key ID does not exist. O KMS KeyId especificado não existe.
403 OperationDenied.InvalidState The operation is not permitted when the status is processing. Esta operação não é permitida enquanto o recurso estiver no estado de processamento.
403 InvalidFileSystem.AlreadyExisted The specified file system already exists. O sistema de arquivos especificado já existe. Você pode chamar a operação DescribeFileSystems e especificar o ID do sistema de arquivos para visualizar as informações relacionadas.
403 Resource.OutOfStock The inventory of the specified zone is insufficient. O inventário na zona especificada é insuficiente.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.