Enregistrement des AWS Elemental MediaConvert API appels à l'aide de AWS CloudTrail - MediaConvert
Trouver des informations MediaConvert sur CloudTrailComprendre les événements CloudTrail de gestion pour MediaConvert

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.

Enregistrement des AWS Elemental MediaConvert API appels à l'aide de AWS CloudTrail

AWS Elemental MediaConvert s'intègre AWS CloudTrailà un service qui fournit un enregistrement des opérations effectuées par un utilisateur, un rôle ou un AWS service. CloudTrail capture toutes les opérations (APIappels) que vous effectuez, y compris celles depuis la MediaConvert console, sous forme d'événements. Les événements contiennent des informations sur les demandes adressées MediaConvert, notamment l'adresse IP, l'auteur de la demande, la date à laquelle elle a été faite, le MediaConvert fonctionnement et des détails supplémentaires. Pour plus d'informations sur CloudTrail les événements, voir Que sont les CloudTrail événements ?

Voici quelques exemples de ce qui CloudTrail peut vous aider à trouver : quand vous avez soumis une demande de création d'emploi, qui a supprimé une file d'attente ou quelles balises ont été ajoutées à une ressource.

Pour une liste complète de toutes les MediaConvert opérations que vous pouvez effectuer, consultez la MediaConvert APIréférence.

Pour en savoir plus CloudTrail, consultez le guide de AWS CloudTrail l'utilisateur.

Trouver des informations MediaConvert sur CloudTrail

Vous pouvez consulter, rechercher et télécharger les événements des 90 derniers jours dans l'historique des événements de la CloudTrail console. Pour plus d'informations, consultez la section Utilisation de l'historique des CloudTrail événements.

Pour un enregistrement continu des CloudTrail événements survenus au-delà des 90 derniers jours, vous devez créer un magasin de données sur les événements relatifs aux CloudTrail sentiers ou aux CloudTrail lacs.

CloudTrail sentiers

Avec les CloudTrail traces, CloudTrail fournit les fichiers journaux des événements à un compartiment Amazon S3. En outre, vous pouvez configurer d'autres AWS services pour analyser plus en détail les données d'événements collectées et agir en fonction de celles-ci. Lorsque vous créez un parcours, chaque événement est CloudTrail également transmis à Amazon EventBridge. Pour plus d'informations sur les CloudTrail sentiers, consultez la section Utilisation des CloudTrail sentiers.

CloudTrail Stockages de données sur les événements du lac

Avec les magasins de données d'événements CloudTrail Lake, CloudTrail fournit un magasin consultable de données d'événements. Pour plus d'informations, consultez la section Travailler avec CloudTrail Lake.

Comprendre les événements CloudTrail de gestion pour MediaConvert

Les événements de gestion fournissent des informations sur les opérations de gestion effectuées sur les ressources de votre Compte AWS. Elles sont également appelées opérations du plan de contrôle, ou MediaConvert opérations. Par défaut, CloudTrail enregistre tous les événements de gestion.

CloudTrail les événements de gestion représentent une demande unique provenant de n'importe quelle source. Ils incluent des informations sur l'origine d'une demande, l'auteur de la demande, la date à laquelle elle a été faite, le MediaConvert fonctionnement et d'autres détails importants.

Pour plus de détails sur le contenu de ces événements, consultez la section Contenu des CloudTrail enregistrements.

Origin

Les événements incluent l'adresse IP source soussourceIPAddress, AWS la région sous awsRegion et l'agent utilisateur (informations sur le navigateur ou le client) sous userAgent pour vous aider à trouver l'origine d'une demande.

Identity

Les événements incluent des informations d'identité, soususerIdentity, pour vous aider à trouver l'auteur de la demande. Ces informations peuvent vous servir à déterminer ce qui suit :

  • Si la demande a été effectuée avec des informations d’identification d’utilisateur root ou d’utilisateur root.

  • Si la demande a été faite au nom d'un utilisateur de IAM l'Identity Center.

  • Si la demande a été effectuée avec les informations d’identification de sécurité temporaires d’un rôle ou d’un utilisateur fédéré.

  • Si la requête a été effectuée par un autre Service AWS.

Pour plus d'informations, y compris une liste des champs pertinents, consultez l'CloudTrail userIdentity élément.

Heure

Les événements incluent un horodatage, souseventTime.

MediaConvert opération

Les événements incluent l' MediaConvert opération ci-dessouseventName. Par exemple, CreateJob lorsque vous soumettez une nouvelle tâche ou CreateQueue lorsque vous demandez une nouvelle file d'attente.

Autres détails importants

Certains événements incluent des détails spécifiques concernant votre MediaConvert demande ci-dessousrequestParameters, ainsi que MediaConvert la réponse de celle-ci sousresponseElements.

Par exemple, si vous soumettez une CreateJob demande, le requestParameters champ inclura JSON les paramètres du travail que vous avez soumis. En cas de succès, l'événement inclut également les paramètres de tâche complets et validésJSON, ainsi que l'identifiant de la tâche, sousresponseElements.

Par exemple, si vous soumettez une CreateQueue demande, le requestParameters champ inclura les paramètres de file d'attente que vous avez soumis. En cas de succès, l'événement inclura également la file d'attente ARN ci-dessousresponseElements.

Note

MediaConvert prend uniquement en charge l'enregistrement des événements de gestion dans CloudTrail, il ne prend pas en charge les événements de données. Pour plus de détails sur ces types d'événements et leurs différences, consultez la section CloudTrailConcepts.

Exemples d’événements

Les exemples suivants montrent un CloudTrail événement pour les TagResource opérations CreateJob CreateQueueDeleteQueue,, et. CloudTrail enregistre également toutes les autres MediaConvert opérations, bien qu'elles ne soient pas affichées ici.

Exemple d'événement : CreateJob

{
    "eventVersion": "1.09",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AKIAIOSFODNN7EXAMPLE:example-admin",
        "arn": "arn:aws:sts::111122223333:assumed-role/admin/example-admin",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "AKIAIOSFODNN7EXAMPLE",
                "arn": "arn:aws:iam::111122223333:role/admin",
                "accountId": "111122223333",
                "userName": "admin"
            },
            "attributes": {
                "creationDate": "2024-04-04T17:30:19Z",
                "mfaAuthenticated": "false"
            }
        }
    },
    "eventTime": "2024-04-04T17:45:26Z",
    "eventSource": "mediaconvert.amazonaws.com",
    "eventName": "CreateJob",
    "awsRegion": "us-west-2",
    "sourceIPAddress": "203.0.113.100",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
    "requestParameters": {
        "settings": {...},
        "accelerationSettings": {
            "mode": "DISABLED"
        },
        "role": "arn:aws:iam::111122223333:role/service-role/MediaConvert_Default_Role",
        "clientRequestToken": "1712252705233-zyxwvut",
        "statusUpdateInterval": "SECONDS_60",
        "billingTagsSource": "JOB",
        "priority": 0,
        "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default"
    },
    "responseElements": {
        "job": {
            "arn": "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1712252725875-defhgi",
            "id": "1712252725875-defhgi",
            "createdAt": 1712252726,
            "queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
            "role": "arn:aws:iam::111122223333:role/service-role/MediaConvert_Default_Role",
            "settings": {...},
            "status": "SUBMITTED",
            "timing": {
                "submitTime": 1712252726
            },
            "billingTagsSource": "JOB",
            "accelerationSettings": {
                "mode": "DISABLED"
            },
            "statusUpdateInterval": "SECONDS_60",
            "priority": 0,
            "accelerationStatus": "NOT_APPLICABLE",
            "messages": {
                "info": [],
                "warning": []
            },
            "clientRequestToken": "1712252705233-abcDEF"
        }
    },
    "requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "111122223333",
    "eventCategory": "Management"
}

Exemple d'événement : CreateQueue

{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AKIAIOSFODNN7EXAMPLE",
        "arn": "arn:aws:iam::111122223333:user/testuser",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "userName": "testUser",
        "sessionContext": {
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2018-07-10T14:01:57Z"
            }
        },
        "invokedBy": "signin.amazonaws.com"
    },
    "eventTime": "2018-07-10T16:49:13Z",
    "eventSource": "mediaconvert.amazonaws.com",
    "eventName": "CreateQueue",
    "awsRegion": "eu-west-1",
    "sourceIPAddress": "203.0.113.100",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
    "requestParameters": {
        "name": "QueueName",
        "description": "Example queue description.",
        "tags": {}
    },
    "responseElements": {
        "queue": {
            "arn": "arn:aws:mediaconvert:eu-west-1:111122223333:queues/QueueName",
            "createdAt": 1531241353,
            "lastUpdated": 1531241353,
            "type": "CUSTOM",
            "status": "ACTIVE",
            "description": "",
            "name": "QueueName",
            "submittedJobsCount": 0,
            "progressingJobsCount": 0
        }
    },
    "requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}

Exemple d'événement : DeleteQueue

{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AKIAIOSFODNN7EXAMPLE",
        "arn": "arn:aws:iam::111122223333:user/testuser",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "userName": "testuser",
        "sessionContext": {
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2018-07-10T14:01:57Z"
            }
        },
        "invokedBy": "signin.amazonaws.com"
    },
    "eventTime": "2018-07-10T15:36:29Z",
    "eventSource": "mediaconvert.amazonaws.com",
    "eventName": "DeleteQueue",
    "awsRegion": "eu-west-1",
    "sourceIPAddress": "203.0.113.100",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
    "requestParameters": {
        "name": "QueueName"
    },
    "responseElements": null,
    "requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}

Exemple d'événement : TagResource

{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AKIAIOSFODNN7EXAMPLE",
        "arn": "arn:aws:iam::111122223333:user/testuser",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "userName": "testuser"
    },
    "eventTime": "2018-07-10T18:44:27Z",
    "eventSource": "mediaconvert.amazonaws.com",
    "eventName": "TagResource",
    "awsRegion": "eu-west-1",
    "sourceIPAddress": "203.0.113.100",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
    "requestParameters": {
        "arn": "arn:aws:mediaconvert:eu-west-1:111122223333:queues/ExampleQueue",
        "Tags": {
            "CostCenter": "Example-Tag"
        }
    },
    "responseElements": null,
    "requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}