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

Cria um sistema de arquivos.

Descrição da operação

Antes de usar esta operação, certifique-se de entender o faturamento do File Storage NAS. Para mais informações, consulte Faturamento 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 chamar esta operação, o sistema cria automaticamente a função vinculada ao serviço necessária para a operação. 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

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 (padrão): Sistema de arquivos NAS de uso geral. extreme: Sistema de arquivos Extreme NAS. cpfs: Cloud Parallel File Storage (CPFS) (localmente redundante). cpfsse: Cloud Parallel File Storage (CPFS) SE (redundante entre zonas). Valores válidos: standard : Sistema de arquivos NAS de uso geral. cpfs : Cloud Paralleled File System (CPFS) (localmente redundante) cpfsse : Cloud Paralleled File System (CPFS) SE (redundante entre zonas) extreme : Sistema de arquivos Extreme NAS.	standard
ChargeType	string	Não	O método de faturamento. Valores válidos: PayAsYouGo (padrão): Pay-as-you-go. Subscription: Assinatura. Valores válidos: PayAsYouGo : Pay-as-you-go. 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 uma instância de assinatura não for renovada após a expiração, a instância será liberada automaticamente.	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 os valores disponíveis, consulte as especificações reais na página de compra: Página de compra pay-as-you-go do Extreme NAS Página de compra pay-as-you-go 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 os valores de especificação disponíveis, consulte as especificações reais na página de compra. Página de compra pay-as-you-go 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 e Premium. 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 : Extreme NAS Standard. Capacity : NAS Capacity. advance_200 : Cloud Paralleled File System (CPFS) com linha de base de 200 MB/s/TiB. advance_100 : Cloud Paralleled File System (CPFS) com linha de base de 100 MB/s/TiB. Premium : NAS Premium. Performance : NAS Performance. economic : Cloud Paralleled File System (CPFS) economy. advance : Extreme NAS Advanced.	Performance
ZoneId	string	Não	O ID da zona. Uma zona é uma área física independente dentro de uma região que possui sua própria fonte de alimentação e rede. Se FileSystemType estiver definido como standard, este parâmetro é opcional. Por padrão, uma zona ativa que corresponda ao ProtocolType e StorageType condicionais é selecionada aleatoriamente. Se FileSystemType estiver definido como extreme ou cpfs, este parâmetro é obrigatório. Nota Os sistemas de arquivos e as instâncias do Elastic Computing Service (ECS) em zonas diferentes da mesma região podem se comunicar entre si. Coloque o sistema de arquivos e o servidor 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.	NFS
EncryptType	integer	Não	Especifica se o sistema de arquivos deve ser criptografado. Usa chaves gerenciadas pelo Key Management Service (KMS) para criptografar os dados armazenados no sistema de arquivos. Nenhuma descriptografia é necessária ao ler ou gravar dados criptografados. Valores válidos: 0 (padrão): Não criptografado. 1: Chave gerenciada pelo NAS. Suportado quando FileSystemType é definido como standard ou extreme. 2: Chave personalizada (KMS). Suportado quando FileSystemType é definido como standard ou extreme. Nota Extreme NAS: O recurso de Chave Personalizada (KMS) é suportado em todas as regiões, exceto na China (Hangzhou) 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 : Chave gerenciada pelo NAS. 2 : Chave personalizada (KMS)	1
SnapshotId	string	Não	O ID do snapshot. Este parâmetro é suportado apenas para sistemas de arquivos Extreme NAS com o tipo de armazenamento Advanced. 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 da versão 2, primeiro crie o sistema de arquivos A a partir do snapshot e, em seguida, 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 (-).	此文件系统的描述。
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 do 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 usará o RequestId da solicitação de API como o 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 é 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 incorrer em 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 de 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 o 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 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, 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. 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. 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, cada um de uma zona diferente.
	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 a criação e o faturamento de recursos em nuvem, o cliente pode tentar novamente a solicitação se ocorrer um tempo limite de solicitação ou um erro interno do servidor. Defina o parâmetro ClientToken na solicitação para evitar pedidos duplicados causados por várias tentativas.

Nota

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

Detalhes sobre o parâmetro ClientToken:

ClientToken é uma string exclusiva e 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 antes, 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 a cada nova tentativa. Isso ocorre porque o NAS usa o SignatureNonce para evitar ataques de repetição e o Timestamp para marcar a hora de cada solicitação. Portanto, uma nova solicitação 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 seu 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 será bem-sucedida. Solucione o problema com base na mensagem de erro e modifique os parâmetros da solicitação antes de tentar novamente.
- Se a resposta for HTTP 5xx, a solicitação pode ter encontrado um tempo limite de rede ou um erro interno do servidor. Reenvie a mesma solicitação (com o mesmo ClientToken e os mesmos 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
202	RequestAccepted	The request has been accepted by the server.
400	IdempotentParameterMismatch	The same client token was passed in to different parameters.
400	InvalidParameter.KmsServiceNotEnabled	Key Management Service is not enabled.
400	DryRunOperation	The request is validated with DryRun flag set.
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.
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.
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.
400	InvalidParam.NotSupportBYOK	The specified file system type does not support the BYOK encryption function.
400	MissingParameter.KmsKeyId	When parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request.
400	InvalidParameter.InvalidKmsKeyId	The specified KMS key ID is invalid.
400	InvalidParameter.KmsKeyIdNotFound	The specified KMS key ID does not exist.
403	OperationDenied.InvalidState	The operation is not permitted when the status is processing.
403	InvalidFileSystem.AlreadyExisted	The specified file system already exists.
403	Resource.OutOfStock	The inventory of the specified zone is insufficient.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.