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

Cria um serviço de protocolo para um sistema de arquivos Cloud Parallel File Storage (CPFS). O processo de criação leva aproximadamente de 5 a 10 minutos.

Descrição da operação

Esta operação é aplicável apenas a sistemas de arquivos CPFS.
Apenas o CPFS 2.3.0 e versões posteriores suportam serviços de protocolo. Você pode chamar a operação DescribeFileSystems para consultar a versão do sistema de arquivos.
Especificações do serviço de protocolo.

Os serviços de protocolo incluem dois tipos de protocolo: General e Cache. Em comparação com o tipo General, o tipo Cache fornece armazenamento em cache de dados de hot spot. Quando ocorre um acerto de cache, a largura de banda do serviço de protocolo do tipo Cache pode exceder a largura de banda do sistema de arquivos CPFS e atingir a largura de banda máxima configurada para o serviço de protocolo.
- General: Fornece acesso ao protocolo NFS e pontos de montagem no nível de pasta para o CPFS. Você não precisa configurar um gerenciamento de cluster de clientes POSIX. Este recurso é gratuito.
- Cache: Fornece armazenamento em cache na memória no lado do servidor com base na política LRU, além dos recursos do tipo General. Quando os dados são armazenados em cache na memória, o CPFS pode fornecer uma largura de banda de rede interna maior. O serviço de protocolo do tipo Cache está disponível em duas especificações: Cache L1 e Cache L2, que diferem na largura de banda da rede interna e no tamanho do cache de memória.
Nota
O serviço de protocolo do tipo Cache é um serviço pago e está em visualização por convite. Para obter informações sobre a cobrança do serviço de protocolo do tipo Cache, consulte Itens cobráveis. Se você tiver algum comentário ou dúvida, participe do grupo de usuários do DingTalk (ID do grupo: 31045006299) para se comunicar com os engenheiros do CPFS.
Tipo de protocolo.

Somente o NFSv3 é suportado.
Pré-requisitos.

O sistema de arquivos CPFS deve ser criado e estar no estado Running.
Outras informações.
- Apenas um serviço de protocolo pode ser criado para cada sistema de arquivos CPFS.
- A criação de um serviço de protocolo consome endereços IP no vSwitch especificado (até 32 endereços IP). Certifique-se de que o vSwitch de destino tenha recursos de endereço IP suficientes.

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

create

*FileSystem

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-099394bd928c****
ProtocolSpec	string	Sim	A especificação do serviço de protocolo. Valores válidos: General (padrão). Valores válidos: CL2 : Cache L2. General : General. CL1 : Cache L1.	General
Throughput	integer	Não	A largura de banda do serviço de protocolo. Unidade: MB/s.	8000
ProtocolType	string	Sim	O tipo de protocolo do serviço de protocolo. Valores válidos: NFS (padrão). Somente o acesso NFSv3 é suportado.	NFS
Description	string	Não	A descrição do serviço de protocolo. Este valor é exibido como "Nome do serviço de protocolo" no console. Limites: A descrição deve ter de 2 a 128 caracteres. A descrição deve começar com uma letra ou caractere chinês e não pode começar com `http://` ou `https://`. A descrição pode conter dígitos, dois-pontos (:), sublinhados (_) e hifens (-).	此协议服务的描述。
VpcId	string	Não	O ID da VPC do serviço de protocolo. A VPC deve ser a mesma VPC do sistema de arquivos. Se o tipo de redundância de armazenamento do sistema de arquivos for armazenamento com redundância de zona (ZRS), não defina este parâmetro. Caso contrário, este parâmetro é obrigatório.	vpc-2vct297b8157bth9z****
VSwitchId	string	Não	O ID do vSwitch do serviço de protocolo. Se o tipo de redundância de armazenamento do sistema de arquivos for armazenamento com redundância de zona (ZRS), não defina este parâmetro. Caso contrário, este parâmetro é obrigatório.	vsw-2vc3c2lybvdllxyq4****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run para esta solicitação. Um dry run verifica a validade e as dependências dos parâmetros sem criar a instância ou gerar cobranças. Valores válidos: true: Envia uma solicitação de verificação sem criar o serviço de protocolo. Os itens de verificação incluem se os parâmetros obrigatórios foram especificados, o formato da solicitação e as dependências de limites de negócios. 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 ProtocolServiceId estará vazio. false (padrão): Envia uma solicitação normal. Após a aprovação na verificação, a instância é criada diretamente.	false
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas certifique-se de que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para obter 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 pode ser diferente para cada solicitação de API.	123e4567-e89b-12d3-a456-42665544****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	98696EF0-1607-4E9D-B01D-F20930B6****
ProtocolServiceId	string	O ID do cluster do serviço de protocolo.	ptc-197ed6a00f2b****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "ProtocolServiceId": "ptc-197ed6a00f2b****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingFileSystemId	FileSystemId is mandatory for this action.
400	MissingVpcId	VpcId is mandatory for this action.
400	MissingVSwitchId	VSwitchId is mandatory for this action.
403	InvalidProtocolSpec.NotSupported	The specified protocol spec does not supported.
403	InvalidNetworkType.NotSupported	The specified network type does not supported.
403	Instance.IncorrectStatus	The specified instance is in an incorrect status.
403	OperationDenied.ProtocolServiceExceedLimit	The protocol service amount exceed file system limit.
403	PermissionDenied.CapacityTooLow	Capacity of file system too low to subscribe protocol service.
403	PermissionDenied.ThroughputInvalid	Standard protocol service should not specified throughput.
403	PermissionDenied.ThroughputTooSmall	Throughput of protocol service too small.
403	PermissionDenied.ThroughputExceed	Throughput of protocol service must less than throughput of file system.
403	InvalidProtocolType.NotSupported	The specified protocol type does not supported.
403	InvalidVSwitchId.IpShortage	The specified vswitch ip shortage.
403	InvalidFset.InUse	Fset already used by other export.
403	InvalidFileSystemPath.InvalidCharacters	The specified filesystem path contains invalid characters.
403	MntPathConflict.InvalidParam	FilesetId and Path must and can only be specified one.
403	OperationDenied.TooManyDepth	The operation is denied due to Fsets path too deep.
403	OperationDenied.InvalidState	The operation is denied due to invalid file system state.
403	OperationDenied.NoProtocolServiceQuota	No protocol service quota.
403	OperationDenied.NotSupported	The operation is denied due to not supported.
403	PermissionDenied.CLThroughputInvalid	Throughput of caching protocol service is invalid.
403	InvalidVpcId.CrossVpcNotSupport.	Cross VPC not support.
404	InvalidParameter.VpcNotFound	The specified VPC does not exist.	The specified VPC does not exist.
404	InvalidParameter.VswNotFound	The specified VSwitch does not exist.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	The specified file system does not exist.
404	InvalidDescription.InvalidFormat	Description format is invalid.
404	InvalidVpcId.ConflictVpcCidr	Vpc cidr conflict with file system
404	InvalidAccessGroupName.NotFound	The specified access group does not exist.
404	InvalidAccessGroupName.NotAccessRule	There has no rule in access group.
404	OperationDenied.NoStock	The operation is denied due to no stock.
404	PathNotExistInFileSystem.InvalidParam	Given path does not exist in file system.
404	InvalidFsetId.NotFound	The specified Fileset ID does not exist.
404	InvalidParameter.VpcVswitchMismatch	Given vSwitch mismatch with given VPC.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.