D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# CloudTrail exemples d'utilisation du SDK pour Ruby
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS SDK pour Ruby with CloudTrail.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `CreateTrail`
L'exemple de code suivant montre comment utiliser`CreateTrail`.
**Kit SDK pour Ruby**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby/example_code/cloudtrail#code-examples).
```
require 'aws-sdk-cloudtrail' # v2: require 'aws-sdk'
require 'aws-sdk-s3'
require 'aws-sdk-sts'
def create_trail_example(s3_client, sts_client, cloudtrail_client, trail_name, bucket_name)
resp = sts_client.get_caller_identity({})
account_id = resp.account
# Attach policy to an Amazon Simple Storage Service (S3) bucket.
s3_client.create_bucket(bucket: bucket_name)
begin
policy = {
'Version' => '2012-10-17',
'Statement' => [
{
'Sid' => 'AWSCloudTrailAclCheck20150319',
'Effect' => 'Allow',
'Principal' => {
'Service' => 'cloudtrail.amazonaws.com'
},
'Action' => 's3:GetBucketAcl',
'Resource' => "arn:aws:s3:::#{bucket_name}"
},
{
'Sid' => 'AWSCloudTrailWrite20150319',
'Effect' => 'Allow',
'Principal' => {
'Service' => 'cloudtrail.amazonaws.com'
},
'Action' => 's3:PutObject',
'Resource' => "arn:aws:s3:::#{bucket_name}/AWSLogs/#{account_id}/*",
'Condition' => {
'StringEquals' => {
's3:x-amz-acl' => 'bucket-owner-full-control'
}
}
}
]
}.to_json
s3_client.put_bucket_policy(
bucket: bucket_name,
policy: policy
)
puts "Successfully added policy to bucket #{bucket_name}"
end
begin
cloudtrail_client.create_trail({
name: trail_name, # required
s3_bucket_name: bucket_name # required
})
puts "Successfully created trail: #{trail_name}."
rescue StandardError => e
puts "Got error trying to create trail #{trail_name}:\n #{e}"
puts e
exit 1
end
```
+ Pour plus de détails sur l'API, reportez-vous [CreateTrail](https://docs.aws.amazon.com/goto/SdkForRubyV3/cloudtrail-2013-11-01/CreateTrail)à la section *Référence des AWS SDK pour Ruby API*.
### `DeleteTrail`
L'exemple de code suivant montre comment utiliser`DeleteTrail`.
**Kit SDK pour Ruby**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby/example_code/cloudtrail#code-examples).
```
client.delete_trail({
name: trail_name # required
})
puts "Successfully deleted trail: #{trail_name}"
rescue StandardError => e
puts "Got error trying to delete trail: #{trail_name}:"
puts e
exit 1
end
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteTrail](https://docs.aws.amazon.com/goto/SdkForRubyV3/cloudtrail-2013-11-01/DeleteTrail)à la section *Référence des AWS SDK pour Ruby API*.
### `ListTrails`
L'exemple de code suivant montre comment utiliser`ListTrails`.
**Kit SDK pour Ruby**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby/example_code/cloudtrail#code-examples).
```
require 'aws-sdk-cloudtrail' # v2: require 'aws-sdk'
def describe_trails_example(client)
resp = client.describe_trails({})
puts "Found #{resp.trail_list.count} trail(s)."
resp.trail_list.each do |trail|
puts "Name: #{trail.name}"
puts "S3 bucket name: #{trail.s3_bucket_name}"
puts
end
```
+ Pour plus de détails sur l'API, reportez-vous [ListTrails](https://docs.aws.amazon.com/goto/SdkForRubyV3/cloudtrail-2013-11-01/ListTrails)à la section *Référence des AWS SDK pour Ruby API*.
### `LookupEvents`
L'exemple de code suivant montre comment utiliser`LookupEvents`.
**Kit SDK pour Ruby**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby/example_code/cloudtrail#code-examples).
```
require 'aws-sdk-cloudtrail' # v2: require 'aws-sdk'
# @param [Object] client
def lookup_events_example(client)
resp = client.lookup_events
puts "Found #{resp.events.count} events:"
resp.events.each do |e|
puts "Event name: #{e.event_name}"
puts "Event ID: #{e.event_id}"
puts "Event time: #{e.event_time}"
puts 'Resources:'
e.resources.each do |r|
puts " Name: #{r.resource_name}"
puts " Type: #{r.resource_type}"
puts ''
end
end
end
```
+ Pour plus de détails sur l'API, reportez-vous [LookupEvents](https://docs.aws.amazon.com/goto/SdkForRubyV3/cloudtrail-2013-11-01/LookupEvents)à la section *Référence des AWS SDK pour Ruby API*.