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.
- Apenas o CPFS 2.2.0 e versões posteriores suportam a criação de Fileset. 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 a criação de até 10 Filesets.
- O diretório pai deve ser um diretório existente.
- A profundidade máxima suportada de um caminho de Fileset é de 8 níveis. 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.
- Você não pode aninhar Filesets. Se um diretório pai já estiver especificado como um Fileset, seus subdiretórios não poderão ser especificados como Filesets.
- Um Fileset suporta até 1 milhão de arquivos. Se o número de arquivos exceder esse limite, a adição de um novo arquivo retornará a mensagem de erro no space.
Notas de uso do CPFS for Lingjun
- Apenas o CPFS for Lingjun 2.7.0 e versões posteriores suportam a criação de Fileset. 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 for Lingjun suporta a criação de até 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 podem ser links simbólicos.
- A profundidade máxima suportada de um caminho de Fileset é de 8 níveis. 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 contiver vários níveis de diretório, o diretório pai deve ser um diretório existente.
- Você não pode aninhar Filesets. Se um diretório pai já estiver especificado como um Fileset, seus subdiretórios não poderão ser especificados como Filesets. Cada 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 até 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 a contagem de arquivos deve ser maior que a capacidade utilizada ou a contagem de arquivos.
- As estatísticas de cota têm um atraso de 15 minutos. O uso real atual é refletido apenas 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: O ID deve começar com `cpfs-`. Exemplo: cpfs-099394bd928c**. CPFS for Lingjun: O ID deve começar com `bmcpfs-`. 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 deve ser 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 deve ser 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 podem ser links simbólicos. A profundidade máxima suportada de um caminho de Fileset é de 8 níveis. 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 contiver vários níveis de diretório, o diretório pai deve ser um diretório existente. Você não pode aninhar Filesets. Se um diretório pai já estiver especificado como um Fileset, seus subdiretórios não poderão ser especificados como Filesets. Cada caminho de Fileset suporta apenas uma cota. O comprimento total do caminho pode ser de até 990 caracteres.	/test/
DryRun	boolean	Não	Especifica se deve ser realizado um dry run para esta solicitação de criação. Um dry run realiza verificações como validade de parâmetros e estoque. Ele não cria a instância de fato nem incorre em taxas. Valores válidos: true: Envia uma solicitação de verificação e não cria 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 FsetId estará vazio. false (padrão): Envia uma solicitação normal e cria a instância diretamente após a verificação ser bem-sucedida.	false
DeletionProtection	boolean	Não	O atributo 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 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 Este atributo limita 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. A descrição deve ter de 2 a 128 caracteres de comprimento. A descrição deve começar com uma letra maiúscula, uma letra minúscula ou um caractere chinês. Não pode começar com http:// ou https://. A descrição pode conter dígitos, dois-pontos (:), sublinhados (_) ou hifens (-).	Internal transaction directory
ClientToken	string	Não	Garante a idempotência da solicitação. Você pode gerar um valor em seu cliente para garantir que este parâmetro seja exclusivo em diferentes solicitações. O ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. 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 pode ser diferente para cada solicitação de API.	123e4567-e89b-12d3-a456-4266554*****
Quota	object	Não	As informações de cota. Nota Apenas o CPFS for Lingjun 2.7.0 e versões posteriores suportam este parâmetro.
FileCountLimit	integer	Não	O limite de contagem de arquivos da cota. Valores válidos: Valor mínimo: 10.000. Valor máximo: 10.000.000.000.	10000
SizeLimit	integer	Não	O limite de capacidade total da cota. Unidade: Byte. Valores válidos: Valor mínimo: 10.737.418.240 (10 GiB). 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.