CreateTrail - ActionTrail - Centre de documentation Alibaba Cloud

Créez une piste d'audit pour acheminer les événements vers Log Service, Object Storage Service (OSS) ou les deux services simultanément. Avant d'appeler cette opération, vérifiez que les conditions suivantes sont remplies :

Acheminement des événements vers Log Service : un projet doit exister dans Log Service.

Remarque
Lorsque vous créez une piste pour acheminer les événements vers Log Service, le système génère automatiquement un Logstore nommé selon le format :

actiontrail_<Nom de la piste>

Ce Logstore est configuré automatiquement pour l'audit ultérieur. Des index et un tableau de bord sont créés pour faciliter la recherche d'événements. L'écriture manuelle de données dans ce Logstore est interdite afin de garantir l'intégrité des données. Il n'est pas nécessaire de créer un Logstore au préalable.
Acheminement des événements vers OSS : un compartiment (bucket) doit exister dans OSS.

Cette rubrique explique comment créer une piste mono-compte exemple nommée trail-test et la configurer pour acheminer les événements vers un compartiment OSS exemple nommé audit-log.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération via OpenAPI Explorer. Celui-ci génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CreateTrail	Opération à effectuer. Définissez la valeur sur CreateTrail.
Name	String	Oui	trail-test	Nom de la piste d'audit à créer. Le nom doit comporter entre 6 et 36 caractères. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (_). Remarque Le nom doit être unique au sein de votre compte Alibaba Cloud.
OssBucketName	String	Non	audit-log	Nom du compartiment OSS vers lequel les événements doivent être acheminés. Le nom doit comporter entre 3 et 63 caractères. Il doit commencer par une lettre minuscule ou un chiffre et peut contenir des lettres minuscules, des chiffres et des traits d'union (-). Remarque Vous devez spécifier au moins l'un des paramètres OssBucketName ou SlsProjectArn.
OssKeyPrefix	String	Non	at-product-account-audit-B	Préfixe des fichiers journaux à stocker dans le compartiment OSS de destination. Le préfixe doit comporter entre 6 et 32 caractères. Il doit commencer par une lettre et peut contenir des lettres, des chiffres, des traits d'union (-), des barres obliques (/) et des traits de soulignement (_).
RoleName	String	Non	aliyunserviceroleforactiontrail	Rôle lié au service endossé par ActionTrail. Valeur par défaut : aliyunserviceroleforactiontrail.
SlsProjectArn	String	Non	acs:log:cn-shanghai::project/***	ARN (Alibaba Cloud Resource Name) du projet Log Service vers lequel les événements doivent être acheminés. Remarque Vous devez spécifier au moins l'un des paramètres OssBucketName ou SlsProjectArn.
SlsWriteRoleArn	String	Non	acs:ram::***:role/aliyunserviceroleforactiontrail	ARN du rôle lié au service endossé par ActionTrail pour acheminer les événements vers le projet Log Service de destination. Si vous ne spécifiez pas ce paramètre, ActionTrail crée un rôle lié au service pour générer la ressource correspondante. Pour plus d'informations, consultez Gérer le rôle lié au service. Si vous spécifiez ce paramètre, accordez les autorisations du rôle lié au service endossé par ActionTrail au rôle RAM avant d'acheminer les événements vers votre compte Alibaba Cloud. Pour acheminer les événements vers d'autres comptes Alibaba Cloud, joignez la stratégie d'autorisations permettant d'accorder les droits liés à l'acheminement des événements au rôle RAM. Pour savoir comment acheminer les événements entre différents comptes Alibaba Cloud, consultez Agréger les événements entre plusieurs comptes Alibaba Cloud.
EventRW	String	Non	Write	Type de lecture/écriture des événements à acheminer. Valeurs possibles : Write : événements d'écriture. Il s'agit de la valeur par défaut. Read : événements de lecture. All : événements de lecture et d'écriture.
TrailRegion	String	Non	All	Région ou régions depuis lesquelles la piste d'audit achemine les événements. La valeur par défaut est All, ce qui indique que la piste achemine les événements depuis toutes les régions. Vous pouvez également spécifier des régions spécifiques. Appelez l'opération DescribeRegions pour obtenir la liste de toutes les régions prises en charge.
MnsTopicArn	String	Non	acs:mns:cn-hangzhou:1111:/topics/your-topic-name	ARN du topic Message Service (MNS) vers lequel ActionTrail envoie les messages. L'ARN suit le format `acs:mns:<Region>:<Account ID>:/topics/<Topic name>`. Si cet ARN est spécifié, un message est généré et envoyé au topic MNS chaque fois qu'un événement est acheminé vers OSS.
IsOrganizationTrail	Boolean	Non	false	Indique s'il faut créer une piste multi-comptes. Valeurs possibles : true : crée une piste multi-comptes. false : crée une piste mono-compte. Il s'agit de la valeur par défaut.

Pour plus d'informations sur les paramètres de requête communs, consultez la section Paramètres communs.

Paramètres de réponse

Paramètre	Type	Exemple	Description
MnsTopicArn	String	acs:mns:cn-hangzhou:1111:/topics/your-topic-name	ARN du topic MNS vers lequel ActionTrail envoie les messages.
SlsProjectArn	String	acs:log:cn-hangzhou:151266687691****:project/test-project	ARN du projet Log Service vers lequel les événements doivent être acheminés.
RoleName	String	aliyunserviceroleforactiontrail	Rôle lié au service endossé par ActionTrail.
EventRW	String	Write	Type de lecture/écriture des événements à acheminer.
RequestId	String	145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0	ID de la requête.
HomeRegion	String	cn-hangzhou	Région principale de la piste d'audit.
OssKeyPrefix	String	at-product-account-audit-B	Préfixe des fichiers journaux à stocker dans le compartiment OSS de destination.
OssBucketName	String	audit-log	Nom du compartiment OSS vers lequel les événements doivent être acheminés.
SlsWriteRoleArn	String	acs:ram::***:role/aliyunserviceroleforactiontrail	ARN du rôle lié au service endossé par ActionTrail pour acheminer les événements vers le projet Log Service de destination.
TrailRegion	String	All	Région ou régions depuis lesquelles la piste d'audit achemine les événements.
Name	String	trail-test	Nom de la piste d'audit.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format JSON

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

{
  "RoleName" : "aliyunserviceroleforactiontrail",
  "EventRW" : "Write",
  "RequestId" : "AB7A5AE1-EC3C-4C00-91B0-BE7BDEE354AE",
  "HomeRegion" : "cn-hangzhou",
  "OssBucketName" : "audit-log",
  "TrailRegion" : "All",
  "Name" : "trail-test"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidPrefixException	The specified OSS bucket prefix is invalid.	Le préfixe de fichier journal spécifié pour le compartiment OSS de destination n'est pas valide.
400	InvalidQueryParameter	The specified query parameter is invalid.	Un ou plusieurs paramètres de requête spécifiés ne sont pas valides.
400	InvalidTrailNameException	The specified Trail name is invalid.	Le nom de piste spécifié n'est pas valide. Spécifiez un nom de piste valide.
400	TrailAlreadyExistsException	The specified Trail name already exists.	Le nom de piste spécifié existe déjà. Modifiez le nom.
400	MaximumNumberOfOrganizationTrailExceeded	Your account can create only one organization trail.	Une piste multi-comptes existe déjà au sein de votre compte Alibaba Cloud.
400	NotAllowCreateOrganizationTrail	Your account does not allow you to create organization trail. Submit a ticket to get customer support.	Vous ne pouvez pas créer de piste multi-comptes avec votre compte Alibaba Cloud. Pour résoudre ce problème, soumettez un ticket afin de contacter l'équipe du service client.
403	InsufficientSlsPolicyException	Access to the specified Log Service project was denied.	Vous n'êtes pas autorisé à accéder au projet Log Service spécifié.
403	MaximumNumberOfTrailsExceededException	The number of Trails in the same region exceeds the upper limit (5).	Vous ne pouvez pas créer plus de cinq pistes dans une même région.

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