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

Modifica um serviço de protocolo. Você pode modificar a descrição de um serviço de protocolo.

Descrição da operação

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

Esta operação permite modificar a descrição de um serviço de protocolo.
Você pode obter o ID do serviço de protocolo (ProtocolServiceId) usando um dos seguintes métodos:
- Chame a operação CreateProtocolService para criar um serviço de protocolo. O ID do serviço de protocolo é retornado na resposta.
- Chame a operação DescribeProtocolService para consultar serviços de protocolo existentes.

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. Você pode obter o ID do serviço de protocolo na resposta da operação CreateProtocolService ou consultá-lo chamando a operação DescribeProtocolService.	ptc-197ed6a00f2b****
FileSystemId	string	Sim	O ID do sistema de arquivos.	cpfs-099394bd928c****
Description	string	Não	A descriçã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 um caractere chinês e não pode começar com `http://` ou `https://`. A descrição pode conter dígitos, dois pontos (:), sublinhados (_) ou hifens (-). Espaços e outros caracteres especiais não são permitidos. Exemplo válido: `My-Protocol-Service_01`.	My-Protocol-Service_01
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 dependências sem realmente modificar a instância ou gerar cobranças. Valores válidos: true: Envia uma solicitação de dry run sem modificar o serviço de protocolo. O dry run verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido e se as restrições de negócios e dependências são atendidas. 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, o serviço de protocolo é modificado diretamente.	false
ClientToken	string	Não	O token de 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 de comprimento. 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 ClientToken. O RequestId pode variar 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****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****"
}

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	InvalidProtocolSpec.NotSupported	The specified protocol spec does not supported.	O ProtocolSpec especificado não é suportado.
403	PermissionDenied.ThroughputInvalid	Standard protocol service should not specified throughput.	O serviço de protocolo de uso geral não permite especificar a largura de banda do serviço.
403	InvalidVSwitchId.IpShortage	The specified vswitch ip shortage.
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.
403	PermissionDenied.CLThroughputInvalid	Throughput of caching protocol service is invalid.	A largura de banda do serviço de protocolo do tipo cache é inválida.
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	InvalidDescription.InvalidFormat	Description format is invalid.	O formato da descrição especificada é inválido.
404	OperationDenied.NoStock	The operation is denied due to no stock.	O sistema de arquivos está sem estoque.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.