DescribeTrails - Query trails in a region - ActionTrail - Centre de documentation Alibaba Cloud

L'exemple suivant interroge les trails à compte unique du compte Alibaba Cloud actuel. La réponse affiche un trail nommé test-4.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Exécutez cette opération dans OpenAPI Explorer pour générer automatiquement des exemples de code SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeTrails	Opération à effectuer. Définissez ce paramètre sur DescribeTrails.
IncludeShadowTrails	Boolean	No	true	Indique s'il faut renvoyer les shadow trails. Valeurs possibles : false (par défaut) : ne renvoie pas les shadow trails. true : renvoie les shadow trails.
NameList	String	No	audit-log,trail-test2	Noms des trails à interroger. Séparez plusieurs noms par des virgules (,).
IncludeOrganizationTrail	Boolean	No	false	Indique s'il faut interroger les trails multi-comptes. Valeurs possibles : true : interroge les trails multi-comptes. false (par défaut) : interroge uniquement les trails à compte unique.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	10313D41-C40A-4D53-ACA0-0190334DF81C	ID de la requête.
TrailList	Array of TrailList		Liste des trails renvoyés.
TrailRegion	String	All	Région où le trail distribue les événements. Valeurs possibles : All (par défaut) : toutes les régions. cn-hangzhou : Chine (Hangzhou) uniquement. cn-beijing : Chine (Pékin) uniquement.
Status	String	Enable	État du trail. Valeurs possibles : Disable : désactivé. Enable : activé. Fresh : créé mais pas encore activé.
UpdateTime	String	1619407012000	Dernière mise à jour de la configuration du trail.
HomeRegion	String	cn-hangzhou	Région d'origine du trail.
CreateTime	String	1614580048000	Date de création du trail.
OssKeyPrefix	String	trail1	Préfixe des fichiers journaux stockés dans le bucket OSS.
EventRW	String	Write	Type d'événements distribués. Valeurs possibles : Write (par défaut) : événements d'écriture. Read : événements de lecture. All : événements de lecture et d'écriture.
StartLoggingTime	String	1619407012000	Dernière activation du trail.
MnsTopicArn	String	acs:mns:cn-hangzhou:1111:/topics/your-topic-name	ARN du topic Message Service (MNS) qui reçoit les notifications ActionTrail. Format : `acs:mns:<Region>:<Account ID>:/topics/<Topic name>`. Si spécifié, un message est envoyé à ce topic MNS chaque fois qu'un événement est distribué vers OSS.
RoleName	String	aliyunactiontraildefaultrole	Rôle RAM assumé par ActionTrail.
SlsProjectArn	String	acs:log:cn-hangzhou:159498693826****:project/alice-audit-log	ARN du projet Log Service vers lequel les événements sont distribués.
IsOrganizationTrail	Boolean	false	Indique si le trail est un trail multi-comptes. Valeurs possibles : false (par défaut) : trail à compte unique. true : trail multi-comptes.
SlsWriteRoleArn	String	acs:ram::159498693826****:role/aliyunserviceroleforactiontrail	ARN du rôle assumé par ActionTrail pour distribuer les journaux vers le projet Log Service.
StopLoggingTime	String	1617674944000	Dernière désactivation du trail.
Name	String	test-4	Nom du trail.
OssBucketName	String	secloud	Bucket OSS vers lequel les événements sont distribués.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=DescribeTrails
&<Common request parameters>

Exemples de réponses réussies

Format XML

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

<DescribeTrailsResponse>
    <RequestId>10313D41-C40A-4D53-ACA0-0190334DF81C</RequestId>
    <TrailList>
        <Status>Enable</Status>
        <MnsTopicArn>acs:mns:cn-hangzhou:1111:/topics/your-topic-name</MnsTopicArn>
        <HomeRegion>cn-hangzhou</HomeRegion>
        <StartLoggingTime>1619407012000</StartLoggingTime>
        <CreateTime>1614580048000</CreateTime>
        <StopLoggingTime>1617674944000</StopLoggingTime>
        <SlsWriteRoleArn>acs:ram::159498693826****:role/aliyunserviceroleforactiontrail</SlsWriteRoleArn>
        <TrailRegion>All</TrailRegion>
        <Name>test-4</Name>
        <IsOrganizationTrail>false</IsOrganizationTrail>
        <SlsProjectArn>acs:log:cn-hangzhou:159498693826****:project/alice-audit-log</SlsProjectArn>
        <RoleName>aliyunactiontraildefaultrole</RoleName>
        <EventRW>Write</EventRW>
        <UpdateTime>1619407012000</UpdateTime>
        <OssKeyPrefix>trail1</OssKeyPrefix>
        <OssBucketName>secloud</OssBucketName>
    </TrailList>
</DescribeTrailsResponse>

Format JSON

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

{
  "RequestId" : "10313D41-C40A-4D53-ACA0-0190334DF81C",
  "TrailList" : [ {
    "Status" : "Enable",
    "MnsTopicArn" : "acs:mns:cn-hangzhou:1111:/topics/your-topic-name",
    "HomeRegion" : "cn-hangzhou",
    "StartLoggingTime" : 1619407012000,
    "CreateTime" : 1614580048000,
    "StopLoggingTime" : 1617674944000,
    "SlsWriteRoleArn" : "acs:ram::159498693826****:role/aliyunserviceroleforactiontrail",
    "TrailRegion" : "All",
    "Name" : "test-4",
    "IsOrganizationTrail" : false,
    "SlsProjectArn" : "acs:log:cn-hangzhou:159498693826****:project/alice-audit-log",
    "RoleName" : "aliyunactiontraildefaultrole",
    "EventRW" : "Write",
    "UpdateTime" : 1619407012000,
    "OssKeyPrefix" : "trail1",
    "OssBucketName" : "secloud"
  } ]
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidTrailNameException	The specified Trail name is invalid.	Le nom de trail spécifié n'est pas valide. Utilisez un nom de trail valide.
400	InvalidQueryParameter	The specified query parameter is invalid.	Un ou plusieurs paramètres de requête ne sont pas valides.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.