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 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 mais informações, consulte Verificação de nome real para contas.
-
Ao invocar esta operação, o sistema realiza a criação automática da função vinculada ao serviço para associar ao NAS. Para mais informações, consulte Gerenciar a função vinculada ao serviço para o NAS.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
nas:CreateFileSystem |
create |
*FileSystem.
|
|
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:
Valores válidos:
|
standard |
| ChargeType |
string |
Não |
O método de cobrança. Valores válidos:
Valores válidos:
|
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.
Valores válidos:
|
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
|
cn-hangzhou-b |
| ProtocolType |
string |
Sim |
O tipo de protocolo de transferência de arquivos.
Valores válidos:
|
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:
Nota
Valores válidos:
|
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.
|
vpc-bp18cx9a7zoh0h9b4**** |
| VSwitchId |
string |
Não |
O ID do vSwitch.
|
vsw-bp131dkqilvw5pnlt**** |
| Description |
string |
Não |
A descrição do sistema de arquivos. Limites:
|
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 |
| 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:
|
nastest |
| Value |
string |
Não |
O valor da tag. Limites:
|
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 |
| 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.
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.
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.