UpdateTrail - ActionTrail: Central de Documentação do Alibaba Cloud

Este tópico mostra como alterar o bucket do Object Storage Service (OSS) de destino de uma trilha de exemplo chamada trail-test para audit-log.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UpdateTrail	Operação a ser executada. Defina o valor como UpdateTrail.
Name	String	Sim	trail-test	Nome da trilha cuja configuração você deseja atualizar. O nome deve ter de 6 a 36 caracteres, começar com uma letra minúscula e conter apenas letras minúsculas, dígitos, hifens (-) e sublinhados (_). Nota O nome deve ser exclusivo na sua conta Alibaba Cloud.
OssBucketName	String	Não	audit-log	Nome do bucket OSS que receberá os eventos. O nome deve ter de 3 a 63 caracteres, começar com uma letra minúscula ou dígito e conter apenas letras minúsculas, dígitos e hifens (-). Nota Verifique se o bucket existe antes de atualizar a configuração da trilha.
OssKeyPrefix	String	Não	at-product-account-audit-B	Prefixo dos arquivos de log armazenados no bucket OSS de destino. O prefixo deve ter de 6 a 32 caracteres, começar com uma letra e conter apenas letras, dígitos, hifens (-), barras (/) e sublinhados (_).
RoleName	String	Não	aliyunserviceroleforactiontrail	Função RAM que o ActionTrail pode assumir. Valor padrão: `aliyunserviceroleforactiontrail`.
SlsProjectArn	String	Não	acs:log:cn-hangzhou:159498693826****:project/trail-test	ARN (Alibaba Cloud Resource Name) do projeto do Log Service que receberá os eventos.
SlsWriteRoleArn	String	Não	acs:ram::159498693826****:role/aliyunserviceroleforactiontrail	ARN da função vinculada ao serviço que o ActionTrail assume para entregar eventos ao projeto do Log Service de destino. Se você não especificar este parâmetro, o ActionTrail criará uma função vinculada ao serviço para gerar o recurso correspondente. Para mais informações, consulte Gerenciar a função vinculada ao serviço. Se você especificar este parâmetro, conceda as permissões da função vinculada ao serviço assumida pelo ActionTrail à função RAM antes de entregar eventos na sua conta Alibaba Cloud. Para entregar eventos em outras contas Alibaba Cloud, anexe a política de permissão de entrega de eventos à função RAM. Para mais detalhes sobre como entregar eventos entre contas Alibaba Cloud, consulte Agregar eventos entre contas Alibaba Cloud.
EventRW	String	Não	All	Tipo de leitura/gravação dos eventos entregues. Valores válidos: Write: eventos de gravação. Valor padrão. Read: eventos de leitura. All: eventos de leitura e gravação.
TrailRegion	String	Não	All	Regiões das quais a trilha entrega eventos. O valor padrão é All, indicando que a trilha entrega eventos de todas as regiões. Você também pode especificar regiões específicas. Chame a operação DescribeRegions para consultar todas as regiões suportadas.
MnsTopicArn	String	Não	acs:mns:cn-hangzhou:1111:/topics/your-topic-name	ARN do tópico do Message Service (MNS) para onde o ActionTrail envia mensagens. O ARN segue o formato `acs:mns:<Região>:<ID da Conta>:/topics/<Nome do Tópico>`. Se especificado, o sistema gera e entrega uma mensagem ao tópico MNS sempre que um evento for entregue ao OSS.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
MnsTopicArn	String	acs:mns:cn-hangzhou:1111:/topics/your-topic-name	ARN do tópico MNS para onde o ActionTrail envia mensagens.
SlsProjectArn	String	acs:log:cn-hangzhou:159498693826****:project/trail-test	ARN do projeto do Log Service que receberá os eventos.
RoleName	String	aliyunserviceroleforactiontrail	Função RAM que o ActionTrail pode assumir.
EventRW	String	All	Tipo de leitura/gravação dos eventos entregues.
RequestId	String	145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0	ID da solicitação.
HomeRegion	String	cn-hangzhou	Região de origem da trilha.
OssKeyPrefix	String	at-product-account-audit-B	Prefixo dos arquivos de log armazenados no bucket OSS de destino.
OssBucketName	String	audit-log	Nome do bucket OSS que receberá os eventos.
SlsWriteRoleArn	String	acs:ram::159498693826****:role/aliyunserviceroleforactiontrail	ARN da função vinculada ao serviço que o ActionTrail assume para entregar eventos ao projeto do Log Service de destino.
TrailRegion	String	All	Regiões das quais a trilha entrega eventos.
Name	String	trail-test	Nome da trilha.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=UpdateTrail
&Name=trail-test
&OssBucketName=audit-log
&<Common request parameters>

Exemplos de respostas de sucesso

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "SlsProjectArn" : "acs:log:cn-hangzhou:159498693826****:project/trail-test",
  "RoleName" : "aliyunserviceroleforactiontrail",
  "EventRW" : "All",
  "RequestId" : "145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0",
  "HomeRegion" : "cn-hangzhou",
  "OssBucketName" : "audit-log",
  "SlsWriteRoleArn" : "acs:ram::159498693826****:role/aliyunserviceroleforactiontrail",
  "TrailRegion" : "All",
  "Name" : "trail-test"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IncompleteSignature	The request signature does not conform to Alibaba Cloud standards.	A assinatura da solicitação calculada pela Alibaba Cloud não corresponde à assinatura fornecida. Verifique se o AccessKey ID e o AccessKey secret são válidos e se o método de assinatura está correto. Para mais informações, consulte Método de assinatura.
400	InvalidPrefixException	The specified OSS bucket prefix is invalid.	O prefixo do arquivo de log especificado para o bucket OSS de destino é inválido.
403	InsufficientSlsPolicyException	Access to the specified Log Service project was denied.	Você não tem autorização para acessar o projeto do Log Service especificado.
404	TrailNotFoundException	The specified Trail does not exist.	A trilha especificada não existe.

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.