CreateFileSystem - File Storage NAS: Central de Documentação do Alibaba Cloud

Cria um sistema de arquivos.

Descrição da operação

Antes de chamar esta operação, certifique-se de compreender totalmente as regras de cobrança e os preços do File Storage NAS. Para obter mais informações, consulte Visão geral da cobrança e Preços.
Para criar um sistema de arquivos, você deve passar pela verificação de nome real. Para obter mais informações, consulte Verificação de nome real para contas.
Ao invocar esta operação, a função vinculada ao serviço para NAS necessária para a operação é criada automaticamente. Para obter mais informações, consulte Gerenciar a função vinculada ao serviço para NAS.

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: Sistema de arquivos NAS de uso geral. Este é o valor padrão. extreme: Sistema de arquivos NAS Extreme. cpfs: Cloud Parallel File Storage (CPFS) (armazenamento com redundância local). cpfsse: CPFS SE (armazenamento com redundância de zona). Valores válidos: standard : NAS de uso geral. cpfs : Cloud Parallel File Storage (armazenamento com redundância local) cpfsse : Cloud Parallel File Storage SE (armazenamento 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: pré-pago. Valores válidos: PayAsYouGo : Pós-pago. Subscription : Pré-pago.	PayAsYouGo
Duration	integer	Não	A duração da assinatura. Unidade: meses. Este parâmetro é obrigatório e entra em vigor apenas quando ChargeType é definido como Subscription. Quando uma instância pré-paga expira, se nenhuma renovação for realizada, a instância expira e a liberação automática é acionada.	1
Capacity	integer	Não	A capacidade do sistema de arquivos. Unidade: GiB. Este parâmetro é obrigatório e entra em vigor apenas quando FileSystemType é definido como extreme, cpfs ou cpfsse. Para valores válidos, consulte as especificações reais na página de compra: Página de compra para sistemas de arquivos NAS Extreme pós-pagos Página de compra para sistemas de arquivos paralelos pós-pagos	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 para sistemas de arquivos paralelos pós-pagos	150
StorageType	string	Sim	O tipo de armazenamento. Se FileSystemType estiver definido como standard, os valores válidos são Performance, Capacity, Premium e Agentic. Se FileSystemType estiver definido como extreme, os valores válidos são standard e advance. Se FileSystemType estiver 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. Se FileSystemType estiver 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 na mesma região. Se FileSystemType estiver definido como standard, este parâmetro é opcional. Por padrão, uma zona elegível que atenda aos requisitos é selecionada aleatoriamente com base nas configurações de ProtocolType e StorageType. Se FileSystemType estiver definido como extreme ou cpfs, este parâmetro é obrigatório. Nota Os sistemas de arquivos e as instâncias ECS em zonas diferentes da mesma região podem se comunicar entre si. Recomendamos que você implante o sistema de arquivos e a instância ECS na mesma zona para evitar latência entre zonas.	cn-hangzhou-b
ProtocolType	string	Sim	O tipo de protocolo de transferência de arquivos. Se FileSystemType estiver definido como standard, os valores válidos são NFS e SMB. Se FileSystemType estiver definido como extreme, o valor válido é NFS. Se FileSystemType estiver definido como cpfs, o valor válido é cpfs. Se FileSystemType estiver definido como cpfsse, o valor válido é cpfs. Valores válidos: dual : Protocolos duplos NFS e SMB. SMB : Protocolo SMB. NFS : Protocolo NFS.	NFS
EncryptType	integer	Não	Especifica se o sistema de arquivos deve ser criptografado. O KMS é usado para gerenciar chaves e 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: criptografia de chave gerenciada pelo NAS. Este valor é suportado quando FileSystemType é definido como standard ou extreme. 2: criptografia de chave personalizada. Este valor é suportado quando FileSystemType é definido como standard ou extreme. Nota Sistemas de arquivos NAS Extreme: O recurso de Chave Personalizada (KMS) é suportado em todas as regiões, exceto China East 1 Finance Cloud. Sistemas de arquivos 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 de chave gerenciada pelo NAS. 2 : Criptografia de chave personalizada.	1
SnapshotId	string	Não	O ID do snapshot. Este parâmetro é suportado apenas para sistemas de arquivos NAS Extreme do tipo de armazenamento premium. Nota Ao 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 e, em seguida, criar o Sistema de Arquivos B que atenda às configurações da versão 2. Depois de copiar os dados do Sistema de Arquivos A para o Sistema de Arquivos B, migre sua carga de trabalho para o Sistema de Arquivos B.	s-extreme-snapsho****
VpcId	string	Não	O ID da VPC. Se FileSystemType estiver definido como cpfs ou cpfsse, este parâmetro é obrigatório. Se FileSystemType estiver definido como standard ou extreme, este parâmetro é reservado e não entra em vigor. Você não precisa configurar este parâmetro.	vpc-bp18cx9a7zoh0h9b4****
VSwitchId	string	Não	O ID do vSwitch. Se FileSystemType estiver definido como cpfs, este parâmetro é obrigatório. Se FileSystemType não estiver definido como cpfs, este parâmetro é reservado e não entra em vigor. 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. A descrição deve começar com uma letra e não pode começar com `http://` ou `https://`. A descrição pode conter letras, dígitos, dois-pontos (:), sublinhados (_) e hifens (-).	The description of this file system
ClientToken	string	Não	O token de cliente 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 de cliente pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para obter 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 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 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 se os parâmetros são válidos e se os recursos são suficientes. Nenhuma instância é criada e nenhuma taxa é cobrada durante um dry run. Valores válidos: true: envia uma solicitação de verificação sem criar a instância. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido, se os limites do serviço foram atendidos e se os recursos do File Storage NAS são suficientes. Se a solicitação falhar na verificação, uma mensagem de erro será retornada. Se a solicitação passar na verificação, o código de status HTTP 200 será retornado e o parâmetro FileSystemId estará vazio. false: envia uma solicitação normal e cria a instância se a solicitação passar na verificação. 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. A chave da tag pode ter até 128 caracteres. 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. O valor da tag pode ter até 128 caracteres. 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 CPFS SE. Valor válido: ZRS. Valores válidos: ZRS : Armazenamento com 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
HpnZone	string	Não	O ID do cluster (zona de rede de alto desempenho). Este parâmetro é obrigatório quando FileSystemType é definido como bmcpfs e não pode ser modificado após a criação do sistema de arquivos. Você pode chamar a operação DescribeSpecifications para consultar os valores disponíveis. Zona de rede de alto desempenho. Exemplo: B1.	B1

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 várias tentativas.

Nota

Esta operação suporta idempotência apenas quando o parâmetro FileSystemType é definido como extreme ou cpfs. Se o parâmetro FileSystemType for 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 de no máximo 64 caracteres ASCII gerada pelo cliente. Exemplo: ClientToken=123e4567-e89b-12d3-a456-42665544****
Se você fornecer um ClientToken que já foi usado, mas outros parâmetros de solicitação foram alterados, o File Storage NAS retornará o código de erro IdempotentParameterMismatch.

Nota

Os parâmetros SignatureNonce, Timestamp e Signature devem mudar durante uma nova tentativa. Isso ocorre porque o File Storage NAS usa SignatureNonce para evitar ataques de repetição e Timestamp para marcar a hora de cada solicitação. Portanto, uma solicitação repetida deve fornecer valores diferentes de SignatureNonce e Timestamp, o que também resulta em um valor de Signature diferente.

Após adicionar o parâmetro ClientToken:
- Se um código de status HTTP 200 for retornado, uma nova tentativa retornará o mesmo resultado ao cliente sem afetar o estado do servidor.
- Se um código de status HTTP 4xx for retornado e a mensagem de erro não sugerir tentar novamente mais tarde, as novas tentativas nunca terão sucesso. Você deve solucionar o problema com base na mensagem de erro, modificar os parâmetros da solicitação e, em seguida, tentar novamente a solicitação.
- 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 incluir o mesmo ClientToken e os mesmos parâmetros de solicitação de negócios, para confirmar o resultado.
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.