UpdateTrail - ActionTrail - Centre de documentation Alibaba Cloud

Cette rubrique explique comment modifier le compartiment Object Storage Service (OSS) de destination d'une piste d'audit exemple nommée trail-test en audit-log.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	UpdateTrail	Opération à effectuer. Définissez la valeur sur UpdateTrail.
Name	String	Oui	trail-test	Nom de la piste d'audit dont vous souhaitez mettre à jour la configuration. 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 underscores (_). 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 sont livré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 Assurez-vous que le compartiment existe avant de mettre à jour la configuration de la piste d'audit.
OssKeyPrefix	String	Non	at-product-account-audit-B	Préfixe des fichiers journaux stockés 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 underscores (_).
RoleName	String	Non	aliyunserviceroleforactiontrail	Rôle RAM qu'ActionTrail est autorisé à endosser. Valeur par défaut : `aliyunserviceroleforactiontrail`.
SlsProjectArn	String	Non	acs:log:cn-hangzhou:159498693826****:project/trail-test	Nom de ressource Alibaba Cloud (ARN) du projet Log Service vers lequel les événements sont livrés.
SlsWriteRoleArn	String	Non	acs:ram::159498693826****:role/aliyunserviceroleforactiontrail	ARN du rôle lié au service qu'ActionTrail endosse pour livrer les événements au projet Log Service de destination. Si vous ne spécifiez pas ce paramètre, ActionTrail crée un rôle lié au service pour créer la ressource correspondante. Pour plus d'informations, consultez Gérer le rôle lié au service. Si vous spécifiez ce paramètre, vous devez accorder les autorisations du rôle lié au service endossé par ActionTrail au rôle RAM avant de pouvoir livrer les événements à votre compte Alibaba Cloud. Si vous devez livrer les événements à d'autres comptes Alibaba Cloud, vous devez joindre la stratégie d'autorisation utilisée pour accorder les autorisations liées à la livraison des événements au rôle RAM. Pour plus d'informations sur la livraison des événements entre les comptes Alibaba Cloud, consultez Agréger les événements entre les comptes Alibaba Cloud.
EventRW	String	Non	All	Type de lecture/écriture des événements à livrer. 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(s) à partir desquelles la piste d'audit livre les événements. La valeur par défaut est All, ce qui indique que la piste d'audit livre les événements depuis toutes les régions. Vous pouvez également spécifier des régions spécifiques. Appelez l'opération DescribeRegions pour interroger toutes les régions prises en charge.
MnsTopicArn	String	Non	acs:mns:cn-hangzhou:1111:/topics/your-topic-name	ARN de la rubrique Message Service (MNS) vers laquelle ActionTrail envoie des messages. L'ARN est au format `acs:mns:<Region>:<Account ID>:/topics/<Topic name>`. Si l'ARN est spécifié, un message est généré et livré à la rubrique MNS chaque fois qu'un événement est livré à OSS.

Paramètres de réponse

Paramètre	Type	Exemple	Description
MnsTopicArn	String	acs:mns:cn-hangzhou:1111:/topics/your-topic-name	ARN de la rubrique MNS vers laquelle ActionTrail envoie des messages.
SlsProjectArn	String	acs:log:cn-hangzhou:159498693826****:project/trail-test	ARN du projet Log Service vers lequel les événements sont livrés.
RoleName	String	aliyunserviceroleforactiontrail	Rôle RAM qu'ActionTrail est autorisé à endosser.
EventRW	String	All	Type de lecture/écriture des événements à livrer.
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 stockés dans le compartiment OSS de destination.
OssBucketName	String	audit-log	Nom du compartiment OSS vers lequel les événements sont livrés.
SlsWriteRoleArn	String	acs:ram::159498693826****:role/aliyunserviceroleforactiontrail	ARN du rôle lié au service qu'ActionTrail endosse pour livrer les événements au projet Log Service de destination.
TrailRegion	String	All	Région(s) à partir desquelles la piste d'audit livre les événements.
Name	String	trail-test	Nom de la piste d'audit.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format JSON

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

{
  "SlsProjectArn" : "acs:log:cn-hangzhou:159498693826****:project/trail-test",
  "RoleName" : "aliyunserviceroleforactiontrail",
  "EventRW" : "All",
  "RequestId" : "145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0",
  "HomeRegion" : "cn-hangzhou",
  "OssBucketName" : "audit-log",
  "SlsWriteRoleArn" : "acs:ram::159498693826****:role/aliyunserviceroleforactiontrail",
  "TrailRegion" : "All",
  "Name" : "trail-test"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	IncompleteSignature	The request signature does not conform to Alibaba Cloud standards.	Le message d'erreur renvoyé indique que la signature de requête calculée par Alibaba Cloud ne correspond pas à la signature que vous avez fournie. Vérifiez si l'AccessKey ID et l'AccessKey secret sont valides et si la méthode de signature est appropriée. Pour plus d'informations, consultez Méthode de signature.
400	InvalidPrefixException	The specified OSS bucket prefix is invalid.	Le message d'erreur renvoyé indique que le préfixe de fichier journal spécifié pour le compartiment OSS de destination n'est pas valide.
403	InsufficientSlsPolicyException	Access to the specified Log Service project was denied.	Le message d'erreur renvoyé indique que vous n'êtes pas autorisé à accéder au projet Log Service spécifié.
404	TrailNotFoundException	The specified Trail does not exist.	Le message d'erreur renvoyé indique que la piste d'audit spécifiée n'existe pas.

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs de l'API.