Tüm Ürünler
Search

Bu Ürün

    :DescribeTrails

    Belge Merkezi

    :DescribeTrails

    Son Güncelleme:Sep 30, 2026

    Oluşturulan izlerin listesini sorgular.

    Operation description

    Bu konu, mevcut hesabın tek hesaplı iz listesinin nasıl sorgulanacağına dair bir örnek sunar. Yanıt, yalnızca test-4 adında bir iz olduğunu gösterir.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    actiontrail:DescribeTrails

    get

    *Trail

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

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    IncludeShadowTrails

    boolean

    No

    Gölge izlerin gösterilip gösterilmeyeceğini belirtir. Geçerli değerler:

    • false (varsayılan): Gölge izler gösterilmez.

    • true: Gölge izler gösterilir.

    false
    NameList

    string

    No

    Sorgulanacak iz adlarının listesi. Birden fazla adı virgül (,) ile ayırın.

    abc,def
    IncludeOrganizationTrail

    boolean

    No

    Çoklu hesap izlerinin sorgulanıp sorgulanmayacağını belirtir. Geçerli değerler:

    • true: Çoklu hesap izlerini sorgular.

    • false (varsayılan): Tek hesaplı izleri sorgular.

    false

    Ortak istek parametreleri hakkında daha fazla bilgi için Ortak parametreler konusuna bakın.

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    İstek kimliği.

    ED8BC689-69DA-42AC-855E-3B06C1271194
    TrailList

    array<object>

    İz listesi.

    object

    CreateTime

    string

    İzin oluşturulma zamanı. Zaman, UTC saat diliminde ISO 8601 standardına uygundur. Biçim: yyyy-MM-dd'T'HH:mm:ss'Z'.

    2021-03-01T06:27:28Z
    EventRW

    string

    Teslim edilen olayların okuma/yazma türü. Geçerli değerler:

    • Write (varsayılan): Yazma olayları.

    • Read: Okuma olayları.

    • All: Okuma ve yazma olayları.

    All
    HomeRegion

    string

    İzin ana bölgesi.

    cn-hangzhou
    IsOrganizationTrail

    boolean

    İzin çoklu hesap izi olup olmadığını gösterir. Geçerli değerler:

    • false (varsayılan): Hayır.

    • true: Evet.

    false
    MaxComputeProjectArn

    string

    İzin olayları teslim ettiği MaxCompute projesinin ARN'si.

    acs:odps:cn-hangzhou:141266687691****:project/actiontrail_****
    MaxComputeWriteRoleArn

    string

    ActionTrail'in olayları MaxCompute projesine teslim etmek için üstlendiği rolün ARN'si.

    acs:ram::141266687691****:role/aliyunserviceroleforactiontrail
    Name

    string

    İz adı.

    test-4
    OrganizationId

    string

    Kaynak dizini kimliği.

    Not

    Bu parametre yalnızca çoklu hesap izleri için döndürülür.

    rd-EV****
    OssBucketLocation

    string

    OSS kovasının bulunduğu bölge.

    oss-cn-hangzhou
    OssBucketName

    string

    OSS kovasının adı.

    secloud
    OssKeyPrefix

    string

    OSS kovasındaki dosya adının ön eki.

    trail1
    OssWriteRoleArn

    string

    ActionTrail'in olayları OSS kovasına teslim etmek için üstlendiği rolün ARN'si.

    acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
    Region

    string

    İzin bulunduğu bölge.

    cn-hangzhou
    SlsProjectArn

    string

    İzin olayları teslim ettiği Simple Log Service projesinin ARN'si.

    acs:log:cn-qingdao:159498693826****:project/zhengze-audit-log
    SlsWriteRoleArn

    string

    ActionTrail'in olayları Simple Log Service projesine teslim etmek için üstlendiği rolün ARN'si.

    acs:ram::159498693826****:role/aliyunserviceroleforactiontrail
    StartLoggingTime

    string

    İzin olayları günlüğe kaydetmeye başladığı en son zaman. Zaman, UTC saat diliminde ISO 8601 standardına uygundur. Biçim: yyyy-MM-dd'T'HH:mm:ss'Z'.

    2021-04-06T02:08:38Z
    Status

    string

    İzin durumu. Geçerli değerler:

    • Disable: Durduruldu.

    • Enable: Etkin.

    • Fresh: İz oluşturulmuş ancak etkinleştirilmemiş.

    Enable
    StopLoggingTime

    string

    İzin olayları günlüğe kaydetmeyi durdurduğu en son zaman. Zaman, UTC saat diliminde ISO 8601 standardına uygundur. Biçim: yyyy-MM-dd'T'HH:mm:ss'Z'.

    2021-04-06T02:09:04Z
    TrailArn

    string

    İzin ARN'si.

    acs:actiontrail:cn-hangzhou:159498693826****:trail/test-delivery-other
    TrailRegion

    string

    İzin bölgesi.

    All
    UpdateTime

    string

    İzin güncellendiği en son zaman. Zaman, UTC saat diliminde ISO 8601 standardına uygundur. Biçim: yyyy-MM-dd'T'HH:mm:ss'Z'.

    2021-04-06T02:16:24Z

    Examples

    Success response

    JSON format

    {
  "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"
    }
  ]
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidTrailNameException The specified Trail name is invalid.
    400 InvalidQueryParameter The specified query parameter is invalid.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.