CreateFileSystem - Cloud Parallel File Storage: 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 a cobrança e os preços do File Storage NAS. Para mais informações, consulte Cobrança e Preços.
Para criar uma instância de sistema de arquivos, conclua a verificação de nome real. Para mais informações, consulte Verificação de nome real.
Ao invocar esta operação, a função vinculada ao serviço NAS associada à operação é criada automaticamente. Para 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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

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 (padrão): NAS de uso geral. extreme: NAS Extreme. cpfs: Cloud Parallel File Storage (CPFS) (localmente redundante). cpfsse: CPFS SE (redundante entre zonas). Valores válidos: standard : NAS de uso geral. cpfs : Cloud Paralleled File System (CPFS) (localmente redundante) cpfsse : Cloud Paralleled File System (CPFS) SE (redundante entre zonas) extreme : NAS Extreme.	standard
ChargeType	string	Não	O método de cobrança. Valores válidos: PayAsYouGo (padrão): Pós-pago. 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 entra em vigor apenas quando ChargeType está definido como Subscription. Se uma instância de assinatura não for renovada antes de expirar, a instância será liberada automaticamente após a expiração. Para mais informações sobre renovação, consulte a documentação de renovação.	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 está definido como extreme, cpfs ou cpfsse. Para valores disponíveis, consulte as especificações reais na página de compra: Página de compra pós-paga do NAS Extreme Página de compra pós-paga do sistema de arquivos paralelo CPFS	100
Bandwidth	integer	Não	A taxa de transferência máxima do sistema de arquivos. Unidade: MB/s. Para valores de especificação disponíveis, consulte as especificações reais na página de compra. Página de compra pós-paga do sistema de arquivos paralelo CPFS	150
StorageType	string	Sim	O tipo de armazenamento. Se FileSystemType estiver definido como standard, valores válidos: Performance, Capacity, Premium e Agentic (AgenticFS). Se FileSystemType estiver definido como extreme, valores válidos: standard e advance. Se FileSystemType estiver definido como cpfs, valores válidos: 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, valores válidos: advance_100 (linha de base de 100 MB/s/TiB). Valores válidos: standard : NAS Extreme Standard. Agentic : Agentic. Capacity : Capacity. advance_200 : Cloud Paralleled File System com linha de base de 200 MB/s/TiB. advance_100 : Cloud Paralleled File System com linha de base de 100 MB/s/TiB. Premium : Premium. Performance : Performance. economic : NAS Extreme econômico. advance : NAS Extreme avançado.	Performance
ZoneId	string	Não	O ID da zona. Uma zona é uma área física com redes elétricas e redes independentes dentro de uma região. Se FileSystemType estiver definido como standard, este parâmetro é opcional. Por padrão, uma zona ativa que atenda às configurações condicionais de ProtocolType e StorageType é selecionada aleatoriamente. Se FileSystemType estiver definido como extreme ou cpfs, este parâmetro é obrigatório. Nota Sistemas de arquivos e servidores Elastic Computing Service (ECS) em zonas diferentes dentro da mesma região podem se comunicar entre si. Coloque o sistema de arquivos e o servidor Elastic Computing Service (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, valores válidos: NFS e SMB. Se FileSystemType estiver definido como extreme, valores válidos: NFS. Se FileSystemType estiver definido como cpfs, valores válidos: cpfs. Se FileSystemType estiver definido como cpfsse, valores válidos: cpfs. Valores válidos: cpfs : Protocolo cpfs. SMB : Protocolo SMB. NFS : Protocolo NFS. dual : Protocolo duplo NFS+SMB.	NFS
EncryptType	integer	Não	Especifica se o sistema de arquivos deve ser criptografado. Usa chaves gerenciadas pelo Key Management Service (KMS) para criptografar dados armazenados no sistema de arquivos. A descriptografia não é necessária quando você lê ou grava dados criptografados. Valores válidos: 0 (padrão): Não criptografado. 1: Chave gerenciada pelo NAS. Suportado quando FileSystemType está definido como standard ou extreme. 2: Chave personalizada (KMS). Suportado quando FileSystemType está definido como standard ou extreme. Nota NAS Extreme: A Chave personalizada (KMS) é suportada em todas as regiões, exceto China East 1 Finance. NAS de uso geral: A Chave personalizada (KMS) é suportada em todas as regiões. Valores válidos: 0 : não criptografado. 1 : Criptografia com chave gerenciada pelo NAS. 2 : Criptografia KMS.	1
SnapshotId	string	Não	O ID do snapshot. Este parâmetro é suportado apenas para sistemas de arquivos NAS Extreme com o tipo de armazenamento avançado. Nota Um sistema de arquivos criado a partir de um snapshot tem a mesma versão do sistema de arquivos de origem do snapshot. Por exemplo, se a versão do sistema de arquivos de origem for 1 e você quiser criar um sistema de arquivos versão 2, primeiro crie o sistema de arquivos A a partir do snapshot, depois crie o sistema de arquivos B que atenda à configuração da versão 2, copie os dados do sistema de arquivos A para o sistema de arquivos B e migre suas cargas de trabalho para o sistema de arquivos B após a conclusão da cópia.	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 configurá-lo.	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 configurá-lo.	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 (-).	A descrição deste sistema de arquivos
ClientToken	string	Não	Garante a idempotência da solicitação. Gere um valor de parâmetro exclusivo a partir do seu cliente. O valor ClientToken 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 usa o RequestId da solicitação de API como ClientToken. O RequestId pode variar para cada solicitação de API.	123e4567-e89b-12d3-a456-42665544****
KmsKeyId	string	Não	O ID da chave KMS. Este parâmetro é obrigatório apenas quando EncryptType está definido como 2.	fcbd**-62-4a-b605-c58cc1d5**
DryRun	boolean	Não	Especifica se deve ser realizado um dry run para esta solicitação. Um dry run verifica a validade dos parâmetros e a disponibilidade de recursos sem realmente criar a instância ou gerar cobranças. Valores válidos: true: Envia uma solicitação de dry run sem criar a instância. Os itens de verificação incluem parâmetros obrigatórios, formato da solicitação, limites de serviço e inventário do NAS. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de status HTTP 200 será retornado, mas FileSystemId estará vazio. false (padrão): Envia uma solicitação normal. Após a verificação ser bem-sucedida, a instância é criada.	true
ResourceGroupId	string	Não	O ID do grupo de recursos. Você pode visualizar os IDs dos grupos de recursos no Console de Gerenciamento de Recursos.	rg-acfmwavnfdf****
Tag	array<object>	Não	As tags. Comprimento do array: 1 a 20. Se o array contiver vários objetos de tag, a chave da tag (Key) deve ser exclusiva.
	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 CPFS SE. Valores válidos: ZRS. Valores válidos: ZRS : redundante entre zonas.	ZRS
RedundancyVSwitchIds	array	Não	A lista de IDs de vSwitch redundantes entre zonas. Se RedundancyType estiver definido como ZRS, este parâmetro é obrigatório. Você deve especificar três IDs de vSwitch de três zonas diferentes.
	string	Não	A lista de IDs de vSwitch redundantes entre zonas.	vsw-123xxx

Notas sobre a idempotência da API:
Como a operação CreateFileSystem envolve criação de recursos em nuvem e cobrança, se uma solicitação atingir o tempo limite ou ocorrer um erro interno do servidor, o cliente poderá tentar repetir a solicitação. Defina o parâmetro ClientToken na solicitação para evitar pedidos duplicados causados por múltiplas tentativas.

Nota

Atualmente, esta operação suporta idempotência apenas quando FileSystemType está definido como extreme ou cpfs. Quando FileSystemType está 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, sensível a maiúsculas e minúsculas, gerada pelo cliente, que contém no máximo 64 caracteres ASCII. Exemplo: ClientToken=123e4567-e89b-12d3-a456-42665544****
Se você fornecer um ClientToken que já foi usado anteriormente, mas com parâmetros de solicitação diferentes, o NAS retornará o código de erro IdempotentParameterMismatch.

Nota

Os parâmetros SignatureNonce, Timestamp e Signature devem mudar nas tentativas repetidas. Isso ocorre porque o NAS usa SignatureNonce para evitar ataques de replay e Timestamp para marcar a hora de cada solicitação. Portanto, uma nova tentativa deve fornecer valores diferentes de SignatureNonce e Timestamp, o que também altera o valor de Signature.

Após a adição do parâmetro ClientToken:
- Se a resposta for HTTP 200, a nova tentativa retornará o mesmo resultado da solicitação anterior, sem afetar o estado do lado do servidor.
- Se a resposta for HTTP 4xx e a mensagem de erro não indicar uma mensagem do tipo "tente mais tarde", a nova tentativa nunca terá sucesso. Solucione o problema com base na mensagem de erro, modifique os parâmetros da solicitação e tente novamente.
- Se a resposta for HTTP 5xx, a solicitação pode ter atingido o tempo limite ou pode ter ocorrido um erro interno do servidor. Reenvie a mesma solicitação (com o mesmo ClientToken e parâmetros de solicitação de negócios) para confirmar o resultado.
O ClientToken é válido por 30 dias.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A estrutura da resposta.
RequestId	string	O ID da solicitação.	98696EF0-1607-4E9D-B01D-F20930B6****
FileSystemId	string	O ID do sistema de arquivos criado.	1ca404****

Exemplos

Resposta de sucesso

JSON formato

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

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.	Parâmetros diferentes foram especificados para o mesmo ClientToken.
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 permissão para criar a função vinculada ao serviço AliyunServiceRoleForNasExtreme. Conceda a autorização ram:CreateServiceLinkedRole ao usuário 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 permissão para criar a função vinculada ao serviço AliyunServiceRoleForNasStandard. Conceda a autorização ram:CreateServiceLinkedRole ao usuário 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 permissão para criar a função vinculada ao serviço AliyunServiceRoleForNasEncryption. Conceda a autorização ram:CreateServiceLinkedRole ao usuário 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 suporta criptografia com Chave Personalizada (KMS).
400	MissingParameter.KmsKeyId	When parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request.	O parâmetro KmsKeyId é obrigatório quando o tipo de criptografia é Chave personalizada (KMS).
400	InvalidParameter.InvalidKmsKeyId	The specified KMS key ID is invalid.	O valor do KeyId do KMS é inválido.
400	InvalidParameter.KmsKeyIdNotFound	The specified KMS key ID does not exist.	O KeyId do KMS não existe.
403	OperationDenied.InvalidState	The operation is not permitted when the status is processing.	Esta operação não é permitida enquanto o status está sendo processado.
403	InvalidFileSystem.AlreadyExisted	The specified file system already exists.	O sistema de arquivos especificado já existe. Você pode chamar 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 estoque 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.