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

Consulta la lista de trails creados.

Descripción de la operación

Este tema proporciona un ejemplo sobre cómo consultar la lista de trails de cuenta única de la cuenta actual. La respuesta muestra que solo existe un trail llamado test-4.

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:DescribeTrails

get

*Trail

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
IncludeShadowTrails	boolean	No	Especifica si se deben mostrar los trails sombra. Valores válidos: false (predeterminado): Los trails sombra no se muestran. true: Los trails sombra se muestran.	false
NameList	string	No	La lista de nombres de trails a consultar. Separe varios nombres con comas (,).	abc,def
IncludeOrganizationTrail	boolean	No	Especifica si se deben consultar trails de múltiples cuentas. Valores válidos: true: Consulta trails de múltiples cuentas. false (predeterminado): Consulta trails de cuenta única.	false

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
RequestId	string	El ID de la solicitud.	ED8BC689-69DA-42AC-855E-3B06C1271194
TrailList	array<object>	La lista de trails.
	object
CreateTime	string	La hora en que se creó el trail. La hora sigue el estándar ISO 8601 en la zona horaria UTC. Formato: yyyy-MM-dd'T'HH:mm:ss'Z'.	2021-03-01T06:27:28Z
EventRW	string	El tipo de lectura/escritura de los eventos que se entregan. Valores válidos: Write (predeterminado): Eventos de escritura. Read: Eventos de lectura. All: Eventos de lectura y escritura.	All
HomeRegion	string	La región principal del trail.	cn-hangzhou
IsOrganizationTrail	boolean	Indica si el trail es un trail de múltiples cuentas. Valores válidos: false (predeterminado): No. true: Sí.	false
MaxComputeProjectArn	string	El ARN del proyecto de MaxCompute al que el trail entrega eventos.	acs:odps:cn-hangzhou:141266687691**:project/actiontrail_**
MaxComputeWriteRoleArn	string	El ARN del rol asumido por ActionTrail para entregar eventos al proyecto de MaxCompute.	acs:ram::141266687691****:role/aliyunserviceroleforactiontrail
Name	string	El nombre del trail.	test-4
OrganizationId	string	El ID del directorio de recursos. Nota Este parámetro se devuelve solo para trails de múltiples cuentas.	rd-EV****
OssBucketLocation	string	La región donde se encuentra el bucket de OSS.	oss-cn-hangzhou
OssBucketName	string	El nombre del bucket de OSS.	secloud
OssKeyPrefix	string	El prefijo del nombre de archivo en el bucket de OSS.	trail1
OssWriteRoleArn	string	El ARN del rol asumido por ActionTrail para entregar eventos al bucket de OSS.	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
Region	string	La región donde reside el trail.	cn-hangzhou
SlsProjectArn	string	El ARN del proyecto de Simple Log Service al que el trail entrega eventos.	acs:log:cn-qingdao:159498693826****:project/zhengze-audit-log
SlsWriteRoleArn	string	El ARN del rol asumido por ActionTrail para entregar eventos al proyecto de Simple Log Service.	acs:ram::159498693826****:role/aliyunserviceroleforactiontrail
StartLoggingTime	string	La hora más reciente en que el trail comenzó a registrar eventos. La hora sigue el estándar ISO 8601 en la zona horaria UTC. Formato: yyyy-MM-dd'T'HH:mm:ss'Z'.	2021-04-06T02:08:38Z
Status	string	El estado del trail. Valores válidos: Disable: Detenido. Enable: Habilitado. Fresh: El trail está creado pero no habilitado.	Enable
StopLoggingTime	string	La hora más reciente en que el trail dejó de registrar eventos. La hora sigue el estándar ISO 8601 en la zona horaria UTC. Formato: yyyy-MM-dd'T'HH:mm:ss'Z'.	2021-04-06T02:09:04Z
TrailArn	string	El ARN del trail.	acs:actiontrail:cn-hangzhou:159498693826****:trail/test-delivery-other
TrailRegion	string	La región del trail.	All
UpdateTime	string	La hora más reciente en que se actualizó el trail. La hora sigue el estándar ISO 8601 en la zona horaria UTC. Formato: yyyy-MM-dd'T'HH:mm:ss'Z'.	2021-04-06T02:16:24Z

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "ED8BC689-69DA-42AC-855E-3B06C1271194",
  "TrailList": [
    {
      "CreateTime": "2021-03-01T06:27:28Z",
      "EventRW": "All",
      "HomeRegion": "cn-hangzhou",
      "IsOrganizationTrail": false,
      "MaxComputeProjectArn": "acs:odps:cn-hangzhou:141266687691****:project/actiontrail_****",
      "MaxComputeWriteRoleArn": "acs:ram::141266687691****:role/aliyunserviceroleforactiontrail",
      "Name": "test-4",
      "OrganizationId": "rd-EV****",
      "OssBucketLocation": "oss-cn-hangzhou",
      "OssBucketName": "secloud",
      "OssKeyPrefix": "trail1",
      "OssWriteRoleArn": "acs:ram::151266687691****:role/aliyunserviceroleforactiontrail",
      "Region": "cn-hangzhou",
      "SlsProjectArn": "acs:log:cn-qingdao:159498693826****:project/zhengze-audit-log",
      "SlsWriteRoleArn": "acs:ram::159498693826****:role/aliyunserviceroleforactiontrail",
      "StartLoggingTime": "2021-04-06T02:08:38Z",
      "Status": "Enable",
      "StopLoggingTime": "2021-04-06T02:09:04Z",
      "TrailArn": "acs:actiontrail:cn-hangzhou:159498693826****:trail/test-delivery-other",
      "TrailRegion": "All",
      "UpdateTime": "2021-04-06T02:16:24Z"
    }
  ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidTrailNameException	The specified Trail name is invalid.	The specified Trail name is not valid.
400	InvalidQueryParameter	The specified query parameter is invalid.	The specified query parameter is not valid.

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.