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

Cria um diretório de exportação para um serviço de protocolo.

Descrição da operação

Esta operação aplica-se apenas a sistemas de arquivos do Cloud Parallel File Storage (CPFS).
Antes de começar

O sistema de arquivos CPFS de destino deve estar no estado Running e um serviço de protocolo já deve ter sido criado.
Outras informações
- O bloco CIDR da VPC da exportação do serviço de protocolo não deve se sobrepor ao bloco CIDR da VPC do sistema de arquivos.
- Os blocos CIDR da VPC de várias exportações no mesmo serviço de protocolo não devem se sobrepor uns aos outros.
- Você pode criar até 10 diretórios de exportação para um único serviço de protocolo.
- A criação de um diretório de exportação de serviço de protocolo consome endereços IP do 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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ProtocolServiceId	string	Sim	O ID do serviço de protocolo.	ptc-197ed6a00f2b****
FileSystemId	string	Sim	O ID do sistema de arquivos. Nota O sistema de arquivos CPFS de destino deve estar no estado Running antes de você chamar esta operação. Após a criação, leva aproximadamente de 20 a 40 minutos para que o sistema de arquivos atinja o estado Running. Você pode chamar DescribeFileSystems para consultar o campo Status (Running indica que está pronto).	cpfs-099394bd928c****
VpcId	string	Não	O ID da VPC para a exportação do serviço de protocolo. Nota O bloco CIDR da VPC selecionada não deve se sobrepor ao bloco CIDR da VPC do sistema de arquivos CPFS de destino. Você pode chamar a operação DescribeVpcs da VPC para consultar o campo CidrBlock de cada VPC para comparação e selecionar uma VPC que não entre em conflito e que esteja na mesma zona do sistema de arquivos.	vpc-2vct297b8157bth9z****
VSwitchId	string	Não	O ID do vSwitch para a exportação do serviço de protocolo. Se o tipo de redundância de armazenamento do sistema de arquivos não for armazenamento com redundância de zona (ZRS), este parâmetro é obrigatório quando VpcId é especificado. Nota O vSwitch deve estar na mesma zona do sistema de arquivos CPFS de destino (os valores de ZoneId devem corresponder). Você pode chamar DescribeFileSystems para consultar o campo ZoneId do sistema de arquivos e, em seguida, selecionar um vSwitch na mesma zona.	vsw-2vc3c2lybvdllxyq4****
FsetId	string	Não	O ID do fileset a ser exportado. Limites: O fileset já deve existir. Apenas um diretório de exportação pode ser criado para cada fileset. Você deve especificar um e apenas um entre FsetId e Path.	fset-1902718ea0ae****
Path	string	Não	O caminho do diretório CPFS a ser exportado. Limites: O diretório já deve existir no sistema de arquivos CPFS. Apenas uma exportação pode ser criada para o mesmo diretório. Você deve especificar um e apenas um entre FsetId e Path. Formato: O caminho deve ter de 1 a 1.024 caracteres de comprimento. O caminho deve ser codificado em UTF-8. O caminho deve começar e terminar com uma barra (/). O diretório raiz é `/`.	/
AccessGroupName	string	Não	O nome do grupo de permissões. Valor padrão: DEFAULT_VPC_GROUP_NAME.	DEFAULT_VPC_GROUP_NAME
Description	string	Não	A descrição do diretório de exportação do serviço de protocolo. Isso é exibido como Nome do Diretório de Exportação no console. Limites: A descrição deve ter de 2 a 128 caracteres de comprimento e pode conter letras e caracteres chineses. A descrição deve começar com uma letra ou um caractere chinês. Não pode começar com `http://` ou `https://`. A descrição pode conter dígitos, dois pontos (:), sublinhados (_) e hifens (-).	Descrição deste diretório de exportação
ClientToken	string	Não	Garante a idempotência da solicitação. Gere um valor de parâmetro a partir do seu cliente para garantir que o valor seja exclusivo em diferentes solicitações. O 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 usa automaticamente o RequestId da solicitação de API como o ClientToken. O RequestId pode variar para cada solicitação de API.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
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 realmente criar a instância ou gerar cobranças. Valores válidos: true: Envia uma solicitação de dry run sem criar o diretório de exportação. 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 aprovada, o código de status HTTP 200 será retornado, mas o ExportId estará vazio. false (padrão): Envia uma solicitação normal. Após a aprovação na verificação, a instância é criada diretamente.	true
VSwitchIds	array	Não	A lista de IDs de vSwitch para a exportação do serviço de protocolo.
	string	Não	A lista de IDs de vSwitch para a exportação 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), você deve especificar IDs de vSwitch em três zonas diferentes dentro da VPC quando VpcId for especificado.	vsw-123xxx

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
ExportId	string	O ID do diretório de exportação do serviço de protocolo.	exp-19abf5beab8d****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "ExportId": "exp-19abf5beab8d****"
}

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.	O parâmetro FileSystemId não foi especificado.
400	MissingProtocolServiceId	ProtocolServiceId is mandatory for this action.	O parâmetro ProtocolServiceId não foi especificado.
403	Instance.IncorrectStatus	The specified instance is in an incorrect status.	A operação não é permitida no estado atual.
403	InvalidVSwitchId.IpShortage	The specified vswitch ip shortage.
403	InvalidFset.InUse	Fset already used by other export.	O Fileset especificado já está em uso.
403	MntPathConflict.InvalidParam	FilesetId and Path must and can only be specified one.	Exatamente um dos parâmetros Fileset ou Path deve ser especificado.
403	OperationDenied.TooManyDepth	The operation is denied due to Fsets path too deep.	A profundidade do caminho do diretório inteligente excede o limite.
403	OperationDenied.InvalidPtcStatus	The operation is denied due to invalid protocol service status.	O status atual do serviço de protocolo não suporta esta operação.
403	OperationDenied.InvalidState	The operation is denied due to invalid file system state.
403	OperationDenied.CrossVPCExceedLimit	Cross vpc mount exceed limit.	O número de diretórios de exportação entre VPCs excedeu o limite máximo da especificação atual do serviço de protocolo.
403	OperationDenied.NoMountTargetQuota	No mount target quota on this protocol service.	A cota de diretório de exportação do serviço de protocolo foi esgotada.
403	OperationDenied.NotSupported	The operation is denied due to not supported.	O sistema de arquivos não suporta o serviço de protocolo.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	O sistema de arquivos especificado não existe.
404	InvalidProtocolService.NotFound	The specified protocol service does not exist.	O serviço de protocolo especificado não existe.
404	InvalidVpcId.ConflictVpcCidr	Vpc cidr conflict with file system	O bloco CIDR da VPC especificada se sobrepõe ao bloco CIDR da VPC do sistema de arquivos.
404	InvalidFsetId.NotFound	The specified fileset ID does not exist.
404	Fset.IncorrectStatus	The specified fset is in an incorrect status.	O Fileset especificado está indisponível.
404	InvalidFileSystemPath.InvalidCharacters	The specified fileset path contains invalid characters.	O caminho do Fileset especificado contém caracteres inválidos.
404	InvalidAccessGroupName.NotFound	The specified access group does not exist.	O grupo de permissões especificado não existe.
404	InvalidAccessGroupName.NotAccessRule	There has no rule in access group.	O grupo de permissões especificado não contém regras.
404	InvalidDescription.InvalidFormat	Description format is invalid.	O formato da descrição especificada é inválido.
404	InvalidParameter.VpcNotFound	The specified VPC does not exist.	A VPC especificada não existe.
404	InvalidParameter.VswNotFound	The specified VSwitch does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.