CreateLifecyclePolicy - File Storage NAS: Central de Documentação do Alibaba Cloud

Cria uma política de gerenciamento de ciclo de vida.

Descrição da operação

Apenas sistemas de arquivos NAS de uso geral e CPFS para Lingjun suportam a criação de políticas de gerenciamento de ciclo de vida.
Você pode criar até 10 políticas de gerenciamento de ciclo de vida do tipo Auto e 100 do tipo OnDemand para cada sistema de arquivos CPFS para Lingjun.
Você pode criar até 20 políticas de gerenciamento de ciclo de vida para NAS de uso geral em cada região.

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

create

*LifecyclePolicy.

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.	31a8e4****
LifecyclePolicyName	string	Não	O nome da política de gerenciamento de ciclo de vida. O nome deve ter de 3 a 64 caracteres e deve começar com uma letra maiúscula ou minúscula. Pode conter letras, dígitos, sublinhados (_) e hifens (-). Nota Este parâmetro é obrigatório para NAS de uso geral, mas não é obrigatório para CPFS para Lingjun.	lifecyclepolicy_01
Path	string	Não	O caminho absoluto do diretório associado à política de gerenciamento de ciclo de vida. Este parâmetro é suportado apenas pelo NAS de uso geral. O NAS de uso geral suporta a associação de apenas um único diretório. O caminho deve começar com uma barra (/) e deve ser um caminho existente no ponto de montagem. Nota Este parâmetro é suportado apenas pelo NAS de uso geral. Para o NAS de uso geral, configure Paths.N para associar vários diretórios ao mesmo tempo. Você deve especificar Path ou Paths, mas não ambos.	/pathway/to/folder
LifecycleRuleName	string	Não	A regra de gerenciamento associada à política de gerenciamento de ciclo de vida. Este parâmetro é suportado apenas pelo NAS de uso geral. Valores válidos: DEFAULT_ATIME_14: arquivos que não foram acessados por 14 dias. DEFAULT_ATIME_30: arquivos que não foram acessados por 30 dias. DEFAULT_ATIME_60: arquivos que não foram acessados por 60 dias. DEFAULT_ATIME_90: arquivos que não foram acessados por 90 dias. DEFAULT_ATIME_180: arquivos que não foram acessados por 180 dias. DEFAULT_ATIME_180 é suportado apenas quando StorageType está definido como Archive. Nota Se uma política de classe de armazenamento IA já estiver configurada para o diretório, o limite de tempo para a política de classe de armazenamento de arquivamento deve ser maior que o da política de classe de armazenamento IA ao configurar a política de classe de armazenamento de arquivamento. Este parâmetro é suportado apenas pelo NAS de uso geral. Valores válidos: DEFAULT_ATIME_14 : Arquivos que não foram acessados por 14 dias. DEFAULT_ATIME_90 : Arquivos que não foram acessados por 90 dias. DEFAULT_ATIME_60 : Arquivos que não foram acessados por 60 dias. DEFAULT_ATIME_180 : Arquivos que não foram acessados por 180 dias. DEFAULT_ATIME_30 : Arquivos que não foram acessados por 30 dias.	DEFAULT_ATIME_14
StorageType	string	Sim	O tipo de armazenamento em camadas. InfrequentAccess: classe de armazenamento IA. Archive: classe de armazenamento de arquivamento. Nota O NAS de uso geral suporta tanto InfrequentAccess quanto Archive. O CPFS para Lingjun suporta apenas InfrequentAccess. Valores válidos: Archive : Armazenamento de arquivamento. InfrequentAccess : Classe de armazenamento IA.	InfrequentAccess
Paths	array	Não	Os caminhos absolutos dos diretórios associados à política de gerenciamento de ciclo de vida.	"/path1", "/path2"
	string	Não	O caminho absoluto do diretório associado à política de gerenciamento de ciclo de vida. Vários diretórios podem ser associados. O caminho deve começar com uma barra (/) e deve ser um caminho existente no ponto de montagem. Valores válidos de N: 1 a 10. Nota Este parâmetro é obrigatório para CPFS para Lingjun.	“/path1"
Description	string	Não	A descrição da política de ciclo de vida. Formato: A descrição deve ter de 3 a 64 caracteres e deve começar com uma letra. Pode conter letras, dígitos, sublinhados (_) e hifens (-). Nota Este parâmetro é suportado apenas pelo CPFS para Lingjun.	Description
LifecyclePolicyType	string	Não	O tipo de política. Auto (padrão): execução automática. OnDemand: execução sob demanda. Valores válidos: Auto : Execução automática. OnDemand : Execução sob demanda.	Auto
TransitRules	array<object>	Não	As regras de trânsito de dados de arquivos. Você pode configurar até 1 regra. Nota Este parâmetro é suportado apenas quando LifecyclePolicyType está definido como Auto para sistemas de arquivos CPFS para Lingjun.
	object	Não	A regra de trânsito de dados de arquivos. Você pode configurar até 1 regra. Nota Este parâmetro é suportado apenas quando LifecyclePolicyType está definido como Auto para sistemas de arquivos CPFS para Lingjun.
Attribute	string	Não	O atributo da regra. Valores válidos: Atime: a hora de acesso do arquivo. Valores válidos: Atime : A hora de acesso do arquivo.	Atime
Threshold	string	Não	O limite da regra. Valores válidos: Quando Attribute está definido como Atime, o valor indica o número de dias em que um arquivo não foi acessado. Valores válidos: 0 a 365.	3
RetrieveRules	array<object>	Não	As regras de recuperação de dados de arquivos. Você pode configurar até 1 regra. Nota Este parâmetro é suportado apenas por sistemas de arquivos CPFS para Lingjun. Nota Quando LifecyclePolicyType está definido como OnDemand, você deve especificar pelo menos uma das regras de transição ativas (TransitRules) e regras de recuperação (RetrieveRules).
	object	Não	A regra de recuperação de dados de arquivos. Você pode configurar até 1 regra.
Attribute	string	Não	O atributo da regra. Valores válidos: RetrieveType: o método de recuperação. Valores válidos: RetrieveType : O método de recuperação.	RetrieveType
Threshold	string	Não	O limite da regra. Valores válidos: RetrieveType AfterVisit: suportado quando LifecyclePolicyType está definido como Auto, o que indica recuperação com melhor esforço na visita. All: suportado quando LifecyclePolicyType está definido como OnDemand, o que indica a recuperação de todos os arquivos. Valores válidos: All : Recupera todos os arquivos. AfterVisit : Recuperação com melhor esforço na visita.	All
DeleteRules	array<object>	Não	As regras de expiração e exclusão de dados de arquivos. Você pode configurar até 1 regra.
	object	Não	As regras de expiração e exclusão de dados de arquivos. Você pode configurar até 1 regra.
Attribute	string	Não	O atributo da regra. Valores válidos: Atime: a hora de acesso do arquivo. Valores válidos: Atime : A hora de acesso do arquivo.	Atime
Threshold	string	Não	O limite da regra. Valores válidos: Quando Attribute está definido como Atime, o valor indica o número de dias em que um arquivo não foi acessado. Valores válidos: 1 a 365.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	BC7C825C-5F65-4B56-BEF6-98C56C7C****
Success	boolean	O status da solicitação. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou.	true
LifecyclePolicyId	string	O ID da política de ciclo de vida.	lsp-bp1234567890ab****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "Success": true,
  "LifecyclePolicyId": "lsp-bp1234567890ab****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationDenied.FileSystemNotSupportedForLifecycle	The file system does not support lifecycle.	O sistema de arquivos especificado não suporta o gerenciamento de ciclo de vida.
400	OperationDenied.EncryptedFileSystemNotSupportedForLifecycle	The encrypted file system does not support lifecycle.	Os sistemas de arquivos criptografados não suportam o gerenciamento de ciclo de vida.
400	OperationDenied.LifecyclePolicyCountLimitExceeded	The maximum number of LifecyclePolicies is exceeded.	O número máximo de políticas de ciclo de vida foi atingido.
400	InvalidLifecyclePolicy.AlreadyExist	The specified LifecyclePolicy already exists.	A política de ciclo de vida especificada já existe.
400	InvalidParameter.PathsNumberExceed	The maximum number of Path.N for this operation is 10.	Cada política pode ser associada a no máximo 10 caminhos.
400	InvalidFilesystemType.NotSupport	The API operation does not support the file system type.	A operação de API atual não oferece suporte a este tipo de sistema de arquivos.
400	InvalidParameter.PathOrPaths	Either Path or Paths.N must be specified.	Você deve especificar o parâmetro Path ou Paths.N, mas não ambos.
400	MissingFileSystemId	FileSystemId is mandatory for this action.	O parâmetro FileSystemId não foi especificado.
400	Lifecycle.Count.Exceeded	The lifecycle policy count exceeds the max limit per type per filesystem.	O número de políticas de ciclo de vida excede o limite.
403	OperationDenied.NotSupportPaths.N	Your request does not meet the gray condition. The Paths.N parameter is not supported.	A solicitação atual não passa na política de liberação canary. O parâmetro Paths.N não é suportado.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	O sistema de arquivos especificado não existe.
404	InvalidParameter.PathNotExist	The specified path does not exist.	O caminho especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.