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

Modifica os parâmetros do diretório de exportação de um serviço de protocolo. Você pode modificar apenas o grupo de permissões e a descrição. O ID da VPC e o ID do vSwitch não podem ser modificados. Para alterá-los, exclua o diretório de exportação e crie um novo.

Descrição da operação

Antes de começar: Esta operação aplica-se apenas a sistemas de arquivos Cloud Parallel File Storage (CPFS).
Pré-requisito de status: Antes de chamar esta operação, o diretório de exportação correspondente ao ExportId deve estar no estado AVAILABLE. Chame DescribeProtocolMountTarget para consultar o status e aguarde até que a criação seja concluída antes de tentar novamente.
Cadeia de dependências:
1. Chame DescribeFileSystems (com FileSystemType definido como cpfs) para obter o sistema de arquivos CPFS.
2. Chame DescribeProtocolService para verificar se o serviço de protocolo está no estado Running.
3. Chame DescribeProtocolMountTarget para verificar se o diretório de exportação está no estado AVAILABLE.
4. Se nenhum diretório de exportação existir, chame CreateProtocolMountTarget para criar um primeiro.

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. Chame DescribeProtocolService para obter as informações do serviço de protocolo.	ptc-197ed6a00f2b****
ExportId	string	Sim	O ID do diretório de exportação do serviço de protocolo. Chame DescribeProtocolMountTarget para obter as informações do diretório de exportação.	exp-19abf5beab8d****
FileSystemId	string	Sim	O ID do sistema de arquivos. Chame DescribeFileSystems (com FileSystemType definido como cpfs) para obter as informações do sistema de arquivos.	cpfs-099394bd928c****
Description	string	Não	A descrição do diretório de exportação do serviço de protocolo. Limites: A descrição deve ter de 2 a 128 caracteres de comprimento. 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 (-).	Descrição deste diretório de exportação
DryRun	boolean	Não	Especifica se deve ser realizado um dry run para esta solicitação de modificação. Um dry run verifica a validade dos parâmetros e as condições de dependência sem realmente modificar o diretório de exportação ou gerar cobranças. Valores válidos: true: Envia uma solicitação de dry run sem modificar o diretório de exportação. Os itens de verificação incluem parâmetros obrigatórios, formato da solicitação e condições de dependência de negócios. DryRun=true também realiza verificações de status do recurso (incluindo o requisito de que o diretório de exportação esteja no estado AVAILABLE). Se o status do diretório de exportação não atender aos requisitos (como CREATING), o erro correspondente será retornado. O DryRun não ignora as verificações de status. Ele valida apenas a validade dos parâmetros da solicitação e as dependências básicas. 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. false (padrão): Envia uma solicitação normal. Após a verificação ser bem-sucedida, os parâmetros do diretório de exportação são modificados diretamente.	true
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Gere um valor único a partir do seu cliente para garantir que solicitações diferentes tenham valores ClientToken únicos. 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 usará o RequestId da solicitação de API como o ClientToken. O RequestId pode variar para cada solicitação de API.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

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	MissingExportId	ExportId is mandatory for this action.	O parâmetro ExportId não foi especificado.
400	MissingAccessGroupName	AccessGroupName is mandatory for this action.	Nenhum grupo de permissões 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	OperationDenied.InvalidMntStatus	The operation is denied due to invalid protocol mount targte status.
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.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	InvalidExportId.NotFound	The specified ExportId does not exist.	O diretório de exportação do serviço de protocolo especificado não existe.
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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.