ModifyFlowLogAttribute - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Chama a operação ModifyFlowLogAttribute para modificar o nome e a descrição de um flow log.

Descrição da operação

ModifyFlowLogAttribute é uma operação assíncrona. Após o envio de uma solicitação, o sistema retorna um ID de solicitação. No entanto, o flow log ainda não foi modificado porque a tarefa de modificação ainda está sendo executada em segundo plano. Você pode chamar DescribeFlowLogs para consultar o status de modificação do flow log:
- Se o flow log estiver no estado Modifying, ele está sendo modificado.
- Se o flow log estiver no estado Active ou Inactive, ele já foi modificado.
ModifyFlowLogAttribute não suporta modificações simultâneas no mesmo flow log.

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

vpc:ModifyFlowLogAttribute

update

*FlowLog.

acs:vpc:{#regionId}:{#accountId}:flowlog/{#FlowLogId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do flow log. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-qingdao.
FlowLogId	string	Sim	O ID do flow log.	fl-m5e8vhz2t21sel1nq****
FlowLogName	string	Não	O novo nome do flow log. O nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.	myFlowlog.
Description	string	Não	A nova descrição do flow log. A descrição deve ter de 1 a 256 caracteres e não pode começar com `http://` ou `https://`.	This is my Flowlog.
AggregationInterval	integer	Não	O novo intervalo de amostragem do flow log. Unidade: minutos. Valores válidos: 1, 5 e 10.	1
IpVersion	string	Não	A versão do IP do tráfego capturado pelo flow log.	IPv4
LogFormat	string	Não

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O ID da solicitação.
Success	string	Indica se a operação foi bem-sucedida. Valores válidos: true: A operação foi bem-sucedida. false: A operação falhou.	true.
RequestId	string	O ID da solicitação.	F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1

Exemplos

Resposta de sucesso

JSON formato

{
  "Success": "true.",
  "RequestId": "F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IncorrectBusinessStatus.FlowLog	The business status of flowLog is incorrect.	O status atual do serviço não oferece suporte à criação de uma instância de log de fluxo.
400	InvalidInstanceId	Instance does not exist.	A instância ENI não existe.
400	ProjectOrLogstoreNotExist	The specified project or logstore does not exist.	O projeto ou Logstore especificado não existe.
400	SourceProjectNotExist	The Source Project or logstore does not exist.	O projeto de origem ou Logstore do Simple Log Service especificado não existe.
400	Unauthorized	This api does not support sub user or role.	Esta operação de API não suporta usuários ou funções RAM.
400	InvalidInstanceId.NotFound	The specfied instance is not existed.
400	RuleExist	The rule has already existed.
400	InvalidHdMonitorStatus	Current instance status is not valid for this action.
400	FlowLogNumberOverLimit	This user has reached the maximum instance number of flowlog.
400	InvalidTrafficType.NotFound	Invalid traffic type.
400	IncorrectStatus.flowlog	Invalid flowlog status.	O log de fluxo não pode ser interrompido porque está em um estado inválido.
400	InvalidName.Malformed	The specified name is not valid.
400	IllegalParam.AggregationInterval	The param of aggregationInterval is illegal.	O parâmetro de intervalo de amostragem é inválido.
400	Forbidden.OperateManagedFlowLog	Authentication is failed for operate managed flowlog.	Falha na autenticação ao operar o log de fluxo gerenciado.
400	UnsupportedFeature.IpVersion	The ipversion type is not supported.	O ipVersion especificado não é suportado.
400	IllegalParam.IpVersion	The parameter of IpVersion is illegal.
400	OperationDenied.NisTrafficAnalyzerAggregationIntervalMismatch	The sampling interval of the FlowLog is greater than the sampling interval of the NIS Traffic Analyzer.	O intervalo de amostragem do log de fluxo é maior que o intervalo de amostragem do NIS Traffic Analyzer.
400	OperationDenied.NisTrafficAnalyzerNotActive	The specified NIS Traffic Analyzer is not enabled.	O NIS Traffic Analyzer especificado não está no status de ativação.
400	OperationDenied.NisTrafficAnalyzerNotFound	The specified NIS Traffic Analyzer does not exist.	O NIS Traffic Analyzer especificado não existe.
400	OperationFailed.InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro desconhecido. Tente realizar a operação novamente. Se o erro persistir, abra um ticket.
400	OperationDenied.InvalidInstanceDeliverScope	When modifying the delivery purpose of the FlowLog instance or starting and stopping NIS traffic analysis, you specify the type of delivery that is not allowed.	Um tipo de entrega não suportado foi especificado ao modificar o destino de entrega da instância de log de fluxo ou ao ativar ou desativar o NIS Traffic Analyzer.
400	IllegalParam.LogFormat	The specified parameter of LogFormat is invalid.	O parâmetro LogFormat especificado é inválido.
400	OperationDenied.UnsupportedField	LogFormat contains unsupported fields.	O LogFormat contém campos não suportados.
400	UnsupportedFeature.LogFormat	The ability to customize subscription fields for flow logs is not yet available, so stay tuned.	O recurso de campo de assinatura personalizada para logs de fluxo ainda não está disponível.
400	UnsupportedFeature.LogFormatNisTrafficAnalyze	The flow log for which NIS traffic analysis is enabled does not support custom subscription fields.	Logs de fluxo com o NIS Traffic Analyzer ativado não suportam campos de assinatura personalizados.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.