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

Cria um Fileset.

Descrição da operação

Notas de uso do CPFS.
- Somente o CPFS 2.2.0 e versões posteriores suportam a criação de Filesets. Você pode visualizar as informações da versão na página de detalhes do sistema de arquivos no console.
- Um único sistema de arquivos CPFS suporta no máximo 10 Filesets.
- O diretório pai deve ser um diretório existente.
- A profundidade máxima suportada para um caminho de Fileset é de 8 níveis, sendo o diretório raiz / o nível 0. Por exemplo, se o caminho do Fileset for /test/aaa/ccc/, a profundidade do caminho é de 3 níveis.
- Filesets aninhados não são suportados. Se um diretório pai for especificado como um Fileset, seus subdiretórios não poderão ser especificados como Filesets.
- Um Fileset suporta no máximo 1 milhão de arquivos. Se o número de arquivos exceder esse limite, a adição de novos arquivos retornará uma mensagem de erro no space.
Notas de uso do CPFS for Lingjun
- Somente o CPFS for Lingjun 2.7.0 e versões posteriores suportam a criação de Filesets. Você pode visualizar as informações da versão na página de detalhes do sistema de arquivos no console.
- Um único sistema de arquivos CPFS suporta no máximo 500 Filesets.
- O caminho do Fileset deve ser um novo caminho e não pode ser um caminho existente. Os caminhos de Fileset não podem ser renomeados e não suportam links simbólicos.
- A profundidade máxima suportada para um caminho de Fileset é de 8 níveis, sendo o diretório raiz / o nível 0. Por exemplo, se o caminho do Fileset for /test/aaa/ccc/, a profundidade do caminho é de 3 níveis.
- Se o caminho do Fileset for um diretório de vários níveis, o diretório pai deve ser um diretório existente.
- Filesets aninhados não são suportados. Se um diretório pai for especificado como um Fileset, seus subdiretórios não poderão ser especificados como Filesets. Um caminho de Fileset suporta apenas uma cota.
- Para a cota de capacidade do Fileset, o valor inicial mínimo é 10 GiB, e a unidade de expansão é 1 GiB.
- Um Fileset suporta no máximo 10 bilhões de arquivos ou diretórios. O valor inicial mínimo é 10.000, e a unidade de expansão é 1.
- Ao modificar uma cota de diretório, a capacidade da cota configurada ou o número de arquivos deve ser maior que a capacidade utilizada ou o número de arquivos.
- As estatísticas de cota têm um atraso de 15 minutos. O uso real atual entra em vigor após 15 minutos.

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:CreateFileset

create

*Fileset.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
FileSystemId	string	Sim	O ID do sistema de arquivos. CPFS: Deve começar com cpfs-, por exemplo, cpfs-099394bd928c**. CPFS for Lingjun: Deve começar com bmcpfs-, por exemplo, bmcpfs-290w65p03ok64ya**.	bmcpfs-290w65p03ok64y*****
FileSystemPath	string	Sim	O caminho absoluto do Fileset a ser criado. Limites de caminho do CPFS: O diretório pai do diretório especificado deve ser um diretório existente no sistema de arquivos. O comprimento é de 2 a 1.024 caracteres. O diretório especificado deve começar e terminar com uma barra (/). Limites de caminho do CPFS for Lingjun: O comprimento é de 2 a 1.024 caracteres. O diretório especificado deve começar e terminar com uma barra (/). O caminho do Fileset deve ser um novo caminho e não pode ser um caminho existente. Os caminhos de Fileset não podem ser renomeados e não suportam links simbólicos. A profundidade máxima suportada para um caminho de Fileset é de 8 níveis, sendo o diretório raiz / o nível 0. Por exemplo, se o caminho do Fileset for /test/aaa/ccc/, a profundidade do caminho é de 3 níveis. Se o caminho do Fileset for um diretório de vários níveis, o diretório pai deve ser um diretório existente. Filesets aninhados não são suportados. Se um diretório pai for especificado como um Fileset, seus subdiretórios não poderão ser especificados como Filesets. Um caminho de Fileset suporta apenas uma cota. O comprimento total do caminho é de até 990 caracteres.	/test/
DryRun	boolean	Não	Especifica se deve ser realizado um dry run na solicitação de criação. Um dry run verifica a validade dos parâmetros e o estoque, mas não cria a instância nem gera cobranças. Valores válidos: true: envia uma solicitação de verificação sem criar a instância. Os itens de verificação incluem se os parâmetros obrigatórios foram especificados, o formato da solicitação, os limites de negócios e o estoque 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 FilesetId estará vazio. false (padrão): envia uma solicitação normal e cria a instância diretamente após a aprovação na verificação.	false
DeletionProtection	boolean	Não	A propriedade de proteção contra liberação da instância. Especifica se a instância pode ser liberada por meio do console ou da operação de API DeleteFileset. true: ativa a proteção contra liberação para a instância. false (padrão): desativa a proteção contra liberação para a instância. Nota Esta propriedade restringe apenas as operações de liberação manual e não se aplica às operações de liberação do sistema.	false
Description	string	Não	A descrição do Fileset. O comprimento é de 2 a 128 caracteres. Deve começar com uma letra ou um caractere chinês e não pode começar com http:// ou https://. Pode conter dígitos, dois-pontos (:), sublinhados (_) e hifens (-).	Internal transaction directory
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode gerar um valor de parâmetro a partir do seu cliente para garantir que o valor seja exclusivo em diferentes solicitações. O parâmetro ClientToken suporta 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 ClientToken. O RequestId de cada solicitação de API pode ser diferente.	123e4567-e89b-12d3-a456-4266554*****
Quota	object	Não	As informações de cota. Nota Este parâmetro é suportado apenas pelo CPFS for Lingjun 2.7.0 e versões posteriores.
FileCountLimit	integer	Não	O limite do número de arquivos para a cota. Valores válidos: Valor mínimo: 10.000. Valor máximo: 10.000.000.000.	10000
SizeLimit	integer	Não	O limite da capacidade total para a cota. Unidade: bytes. Valores válidos: Valor mínimo: 10.737.418.240 (10 GiB). Tamanho do passo: 1.073.741.824 (1 GiB).	10737418240

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	98696EF0-1607-4E9D-B01D-F20930B6****
FsetId	string	O ID do Fileset.	fset-1902718ea0ae****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "FsetId": "fset-1902718ea0ae****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalCharacters	The parameter contains illegal characters.	O parâmetro especificado é inválido.
400	MissingFileSystemId	FileSystemId is mandatory for this action.	O parâmetro FileSystemId não foi especificado.
400	MissingFileSystemPath	FileSystemPath is mandatory for this action.	O parâmetro FileSystemPath está ausente.
400	InvalidFilesystemType.NotSupport	This Api does not support this fileSystem type.	A operação de API atual não oferece suporte a este tipo de sistema de arquivos.
400	InvalidFilesystemVersion.NotSupport	This Api does not support this fileSystem version.	A operação de API atual não oferece suporte a esta versão do sistema de arquivos.
400	InvalidRequest	The request is invalid.	A solicitação é inválida.
400	Quota.Invalid.Limit	Quota limit is invalid.	A cota é inválida.
400	Resource.Exceed.Limit	Resource exceed limit.	A quantidade de recursos excede o limite.
400	Resource.Check.Fail	Resource check failed.	A verificação de recurso falhou.
400	Fileset.Path.Duplicate	Fileset path is duplicate.	O caminho do Fileset já existe.
400	Fileset.Path.Nested	Fileset path is nested.	O caminho do Fileset está aninhado.
400	Fileset.Path.NotExist	Fileset.Path.Not.Exist.	O caminho do diretório pai do Fileset não existe.
400	Fileset.Path.Exist	Fileset already exist.	O caminho do Fileset já existe.
403	OperationDenied.AlreadyExists	The operation is denied due to IdirName already exists in parent path.	O nome do diretório a ser criado já existe no diretório pai.
403	OperationDenied.TooManyFilesets	The operation is denied due to too many fileset in filesystem.	O número de diretórios Fileset no sistema de arquivos excede o limite.
403	OperationDenied.TooManyDepths	The operation is denied due to Fileset path too deep.	A profundidade do caminho do diretório Fileset excede o limite.
403	OperationDenied.NestedDir	The operation is denied due to nested directory.	Falha ao criar a configuração de atualização automática porque existem diretórios aninhados.
403	OperationDenied.DependencyViolation	The operation is denied due to dependancy violation.	As condições para a execução desta operação não foram atendidas.
403	OperationDenied.FilesetNotSupported	The operation is not supported.	O sistema de arquivos não suporta Fileset.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	O sistema de arquivos especificado não existe.
404	InvalidFileSystemPath.ParentNotFound	The specified parent path does not exist.	O diretório pai especificado não existe.
404	InvalidFileSystemPath.NotDirectory	The specified idir parent path is not directory.	O diretório pai especificado não é um diretório.
404	InvalidFileSystemPath.InvalidCharacters	The specified fileset path contains invalid characters.	O caminho do Fileset especificado contém caracteres inválidos.
404	InvalidFilesetPath.InvalidParameter	Fileset path is invalid.	O caminho do fileset especificado é inválido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.