UpdateTrail - ActionTrail - Centro de documentación de Alibaba Cloud

Actualiza las configuraciones de un trail.

Descripción de la operación

Este tema muestra cómo cambiar el bucket de destino de Object Storage Service (OSS) de un trail de ejemplo llamado trail-test a audit-log.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

actiontrail:UpdateTrail

update

*Trail

acs:actiontrail:{#regionId}:{#accountId}:trail/{#TrailName}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Name	string	Sí	El nombre del trail cuyas configuraciones desea actualizar. El nombre debe tener entre 6 y 36 caracteres de longitud y puede contener letras minúsculas, dígitos, guiones (-) y guiones bajos (_). Debe comenzar con una letra minúscula. Nota El nombre debe ser único dentro de una cuenta de Alibaba Cloud.	trail-test
OssBucketName	string	No	El nombre del bucket de Object Storage Service (OSS) al que desea entregar los eventos. El nombre debe tener entre 3 y 63 caracteres de longitud. El nombre debe comenzar con una letra minúscula o un dígito y puede contener letras minúsculas, dígitos y guiones (-). Nota Asegúrese de que el bucket exista antes de actualizar la configuración del trail.	audit-log
OssKeyPrefix	string	No	El prefijo de los archivos que se almacenan en el bucket de OSS. El prefijo debe tener entre 6 y 32 caracteres de longitud. El prefijo debe comenzar con una letra y puede contener letras, dígitos, guiones (-), barras diagonales (/) y guiones bajos (_).	at-product-account-audit-B
OssWriteRoleArn	string	No	El nombre de recurso de Alibaba Cloud (ARN) del rol de RAM que ActionTrail asume para entregar eventos al bucket de OSS. Si no especifica este parámetro, ActionTrail crea un rol vinculado al servicio para crear los recursos necesarios. Para obtener más información, consulte Gestionar el rol vinculado al servicio. Si especifica este parámetro, debe otorgar los permisos del rol vinculado al servicio que asume ActionTrail al rol de RAM antes de poder entregar eventos a su cuenta de Alibaba Cloud. Si necesita entregar eventos a otras cuentas de Alibaba Cloud, debe adjuntar la política de permisos que se utiliza para otorgar permisos relacionados con la entrega de eventos al rol de RAM. Para obtener más información sobre cómo entregar eventos entre cuentas de Alibaba Cloud, consulte Entregar eventos entre cuentas de Alibaba Cloud.	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
SlsProjectArn	string	No	El ARN del proyecto de Log Service al que desea entregar los eventos.	acs:log:cn-shanghai:151266687691****:project/test-project
SlsWriteRoleArn	string	No	El ARN del rol de RAM que ActionTrail asume para entregar eventos al proyecto de Log Service. Si no especifica este parámetro, ActionTrail crea un rol vinculado al servicio para crear el recurso correspondiente. Para obtener más información, consulte Gestionar el rol vinculado al servicio. Si especifica este parámetro, debe otorgar los permisos del rol vinculado al servicio que asume ActionTrail al rol de RAM antes de poder entregar eventos a su cuenta de Alibaba Cloud. Si necesita entregar eventos a otras cuentas de Alibaba Cloud, debe adjuntar la política de permisos que se utiliza para otorgar permisos relacionados con la entrega de eventos al rol de RAM. Para obtener más información sobre cómo entregar eventos entre cuentas de Alibaba Cloud, consulte Entregar eventos entre cuentas de Alibaba Cloud.	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
EventRW	string	No	El tipo de lectura/escritura de los eventos que se entregarán. Valores válidos: Write: eventos de escritura. Es el valor predeterminado. Read: eventos de lectura. All: eventos de lectura y escritura.	All
TrailRegion	string	No	La región del trail. El valor predeterminado es All, lo que indica que el trail entrega eventos de todas las regiones. También puede especificar regiones específicas. Puede llamar a la operación DescribeRegions para consultar todas las regiones admitidas.	All
MaxComputeProjectArn	string	No	El ARN del proyecto de MaxCompute al que desea entregar los eventos. Nota El nombre del proyecto de MaxCompute debe tener el prefijo actiontrail_.	acs:odps:cn-hangzhou:、151277687691**:project/actiontrail_**
MaxComputeWriteRoleArn	string	No	El ARN del rol que ActionTrail asume para entregar eventos al proyecto de Simple Log Service de destino. Si no especifica este parámetro, ActionTrail crea un rol vinculado al servicio para crear los recursos necesarios. Para obtener más información, consulte Gestionar el rol vinculado al servicio. Si especifica este parámetro y entrega eventos a la cuenta actual, debe otorgar al rol de RAM los permisos sobre el rol vinculado al servicio para ActionTrail. Si desea entregar eventos a otras cuentas, debe adjuntar una política del sistema al rol de RAM. Para obtener más información sobre cómo entregar eventos entre cuentas de Alibaba Cloud, consulte Entregar eventos entre cuentas de Alibaba Cloud.	acs:ram::151277687691****:role/aliyunserviceroleforactiontrail

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
EventRW	string	El tipo de lectura/escritura de los eventos que se entregarán.	Write
HomeRegion	string	La región principal del trail.	cn-hangzhou
MaxComputeProjectArn	string	El ARN del proyecto de Big Data Compute Service para la entrega de seguimiento.	acs:odps:cn-hangzhou:151266687691**:project/actiontrail_**
MaxComputeWriteRoleArn	string	El ARN del rol que Operation Audit asume al entregar eventos de operación al proyecto de Big Data Compute Service.	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
Name	string	El nombre del trail.	trail-test
OssBucketName	string	El nombre del bucket de OSS.	audit-log
OssKeyPrefix	string	El prefijo de los archivos de registro que se almacenarán en el bucket de OSS de destino.	at-product-account-audit-B
OssWriteRoleArn	string	El ARN del rol de RAM que ActionTrail asume para entregar eventos al bucket de OSS.	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
RequestId	string	El ID de la solicitud.	2599A180-5236-44D8-9490-50B6F4F8BA35
SlsProjectArn	string	El ARN del proyecto de Log Service al que se entregarán los eventos.	acs:log:cn-hangzhou:151266687691****:project/test-project
SlsWriteRoleArn	string	El ARN del rol de RAM que ActionTrail asume para entregar eventos al proyecto de Log Service.	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
TrailRegion	string	La región o regiones desde las cuales el trail entrega eventos.	All

Ejemplos

Respuesta exitosa

JSON Formato

{
  "EventRW": "Write",
  "HomeRegion": "cn-hangzhou",
  "MaxComputeProjectArn": "acs:odps:cn-hangzhou:151266687691****:project/actiontrail_****",
  "MaxComputeWriteRoleArn": "acs:ram::151266687691****:role/aliyunserviceroleforactiontrail",
  "Name": "trail-test",
  "OssBucketName": "audit-log",
  "OssKeyPrefix": "at-product-account-audit-B",
  "OssWriteRoleArn": "acs:ram::151266687691****:role/aliyunserviceroleforactiontrail",
  "RequestId": "2599A180-5236-44D8-9490-50B6F4F8BA35",
  "SlsProjectArn": "acs:log:cn-hangzhou:151266687691****:project/test-project",
  "SlsWriteRoleArn": "acs:ram::151266687691****:role/aliyunserviceroleforactiontrail",
  "TrailRegion": "All"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	RepeatOssBucket	The specified OSS bucket is already in use. We recommend that you modify the existing Trail or specify another bucket.
400	SlsProjectDoesNotExistException	The specified Log Service project does not exist.
400	IncompleteSignature	The request signature does not conform to Alibaba Cloud standards.	The request signature does not conform to Alibaba Cloud standards.
400	InvalidDeliveryConfigurationException	You must specify at least one Log Service project or OSS bucket for a Trail.
400	InvalidPrefixException	The specified OSS bucket prefix is invalid.	The specified OSS bucket prefix is not valid.
403	InsufficientBucketPolicyException	Access to the specified OSS bucket was denied.
403	InsufficientSlsPolicyException	Access to the specified Log Service project was denied.	Access SLS Project denied.
404	TrailNotFoundException	The specified Trail does not exist.	The specified Trail is not existed.
404	BucketDoesNotExistException	The specified OSS bucket does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.