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.
Exemples d'utilisation d'Amazon Inspector AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide d'Amazon Inspector.
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 façon de configurer et d'exécuter le code en contexte.
Rubriques
Actions
L'exemple de code suivant montre comment utiliseradd-attributes-to-findings.
- AWS CLI
-
Pour ajouter des attributs aux résultats
La
add-attribute-to-findingcommande suivante affecte un attribut avec la cléExampleet la valeur deexampleà la recherche avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU:aws inspector add-attributes-to-findings --finding-arnsarn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU--attributeskey=Example,value=exampleSortie :
{ "failedItems": {} }Pour plus d'informations, consultez les conclusions d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous AddAttributesToFindings
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserassociate-member.
- AWS CLI
-
Exemple : pour associer un AWS compte à un administrateur délégué Amazon Inspector
L'
associate-memberexemple suivant associe un AWS compte à un administrateur délégué Amazon Inspector.aws inspector2 associate-member \ --account-id123456789012Sortie :
{ "accountId": "123456789012" }Pour plus d'informations, consultez la section Gestion de plusieurs comptes dans Amazon Inspector with AWS Organizations dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous AssociateMember
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-assessment-target.
- AWS CLI
-
Pour créer un objectif d'évaluation
La
create-assessment-targetcommande suivante crée une cible d'évaluation nomméeExampleAssessmentTargetà l'aide du groupe de ressources dont l'ARN estarn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnv:aws inspector create-assessment-target --assessment-target-nameExampleAssessmentTarget--resource-group-arnarn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnvSortie :
{ "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX" }Pour plus d'informations, consultez les cibles d'évaluation d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous CreateAssessmentTarget
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-assessment-template.
- AWS CLI
-
Pour créer un modèle d'évaluation
La
create-assessment-templatecommande suivante crée un modèle d'évaluation appeléExampleAssessmentTemplatepour la cible d'évaluation avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX:aws inspector create-assessment-template --assessment-target-arnarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX--assessment-template-nameExampleAssessmentTemplate--duration-in-seconds180--rules-package-arnsarn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p--user-attributes-for-findingskey=ExampleTag,value=examplevalueSortie :
{ "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T" }Pour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous CreateAssessmentTemplate
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-filter.
- AWS CLI
-
Pour créer un filtre
L'
create-filterexemple suivant crée une règle de suppression qui omet les résultats relatifs au type d'instance ECR.aws inspector2 create-filter \ --name"ExampleSuppressionRuleECR"\ --description"This suppression rule omits ECR instance type findings"\ --actionSUPPRESS\ --filter-criteria 'resourceType=[{comparison="EQUALS", value="AWS_ECR_INSTANCE"}]'Sortie :
{ "arn": "arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444" }Pour plus d'informations, consultez Filtrer les résultats d'Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous CreateFilter
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-findings-report.
- AWS CLI
-
Pour créer un rapport de conclusions
L'
create-findings-reportexemple suivant crée un rapport de recherche.aws inspector2 create-findings-report \ --report-formatCSV\ --s3-destinationbucketName=inspector-sbom-123456789012,keyPrefix=sbom-key,kmsKeyArn=arn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333\ --filter-criteria '{"ecrImageRepositoryName":[{"comparison":"EQUALS","value":"debian"}]}'Sortie :
{ "reportId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333" }Pour plus d'informations, consultez la section Gestion des résultats dans Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous CreateFindingsReport
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-resource-group.
- AWS CLI
-
Pour créer un groupe de ressources
La
create-resource-groupcommande suivante crée un groupe de ressources à l'aide de la clé de baliseNameet de la valeur deexample:aws inspector create-resource-group --resource-group-tagskey=Name,value=exampleSortie :
{ "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnv" }Pour plus d'informations, consultez les cibles d'évaluation d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous CreateResourceGroup
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-sbom-export.
- AWS CLI
-
Pour créer un rapport de nomenclature logicielle (SBOM)
L'
create-sbom-exportexemple suivant crée un rapport de nomenclature logicielle (SBOM).aws inspector2 create-sbom-export \ --report-formatSPDX_2_3\ --resource-filter-criteria 'ecrRepositoryName=[{comparison="EQUALS",value="debian"}]' \ --s3-destinationbucketName=inspector-sbom-123456789012,keyPrefix=sbom-key,kmsKeyArn=arn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333Sortie :
{ "reportId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333" }Pour plus d'informations, consultez Exporter SBOMs avec Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous CreateSbomExport
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-assessment-run.
- AWS CLI
-
Pour supprimer un cycle d'évaluation
La
delete-assessment-runcommande suivante supprime l'évaluation exécutée avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-11LMTAVe:aws inspector delete-assessment-run --assessment-run-arnarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-11LMTAVePour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DeleteAssessmentRun
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-assessment-target.
- AWS CLI
-
Pour supprimer un objectif d'évaluation
La
delete-assessment-targetcommande suivante supprime la cible d'évaluation dont l'ARN est :arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusqaws inspector delete-assessment-target --assessment-target-arnarn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusqPour plus d'informations, consultez les cibles d'évaluation d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DeleteAssessmentTarget
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-assessment-template.
- AWS CLI
-
Pour supprimer un modèle d'évaluation
La
delete-assessment-templatecommande suivante supprime le modèle d'évaluation dont l'ARN est :arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4Taws inspector delete-assessment-template --assessment-template-arnarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4TPour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DeleteAssessmentTemplate
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-filter.
- AWS CLI
-
Pour supprimer un filtre
L'
delete-filterexemple suivant supprime un filtre.aws inspector2 delete-filter \ --arn"arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444"Sortie :
{ "arn": "arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444" }Pour plus d'informations, consultez Filtrer les résultats d'Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DeleteFilter
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-assessment-runs.
- AWS CLI
-
Pour décrire les cycles d'évaluation
La
describe-assessment-runcommande suivante décrit une évaluation exécutée avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE:aws inspector describe-assessment-runs --assessment-run-arnsarn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPESortie :
{ "assessmentRuns": [ { "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw", "completedAt": 1458680301.4, "createdAt": 1458680170.035, "dataCollected": true, "durationInSeconds": 3600, "name": "Run 1 for ExampleAssessmentTemplate", "notifications": [], "rulesPackageArns": [ "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP" ], "startedAt": 1458680170.161, "state": "COMPLETED", "stateChangedAt": 1458680301.4, "stateChanges": [ { "state": "CREATED", "stateChangedAt": 1458680170.035 }, { "state": "START_DATA_COLLECTION_PENDING", "stateChangedAt": 1458680170.065 }, { "state": "START_DATA_COLLECTION_IN_PROGRESS", "stateChangedAt": 1458680170.096 }, { "state": "COLLECTING_DATA", "stateChangedAt": 1458680170.161 }, { "state": "STOP_DATA_COLLECTION_PENDING", "stateChangedAt": 1458680239.883 }, { "state": "DATA_COLLECTED", "stateChangedAt": 1458680299.847 }, { "state": "EVALUATING_RULES", "stateChangedAt": 1458680300.099 }, { "state": "COMPLETED", "stateChangedAt": 1458680301.4 } ], "userAttributesForFindings": [] } ], "failedItems": {} }Pour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DescribeAssessmentRuns
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-assessment-targets.
- AWS CLI
-
Pour décrire les objectifs d'évaluation
La
describe-assessment-targetscommande suivante décrit la cible d'évaluation avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq:aws inspector describe-assessment-targets --assessment-target-arnsarn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusqSortie :
{ "assessmentTargets": [ { "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq", "createdAt": 1458074191.459, "name": "ExampleAssessmentTarget", "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI", "updatedAt": 1458074191.459 } ], "failedItems": {} }Pour plus d'informations, consultez les cibles d'évaluation d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DescribeAssessmentTargets
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-assessment-templates.
- AWS CLI
-
Pour décrire les modèles d'évaluation
La
describe-assessment-templatescommande suivante décrit le modèle d'évaluation avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw:aws inspector describe-assessment-templates --assessment-template-arnsarn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAwSortie :
{ "assessmentTemplates": [ { "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw", "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq", "createdAt": 1458074191.844, "durationInSeconds": 3600, "name": "ExampleAssessmentTemplate", "rulesPackageArns": [ "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP" ], "userAttributesForFindings": [] } ], "failedItems": {} }Pour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DescribeAssessmentTemplates
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-cross-account-access-role.
- AWS CLI
-
Pour décrire le rôle d'accès entre comptes
La
describe-cross-account-access-rolecommande suivante décrit le rôle IAM qui permet à Amazon Inspector d'accéder à votre AWS compte :aws inspector describe-cross-account-access-roleSortie :
{ "registeredAt": 1458069182.826, "roleArn": "arn:aws:iam::123456789012:role/inspector", "valid": true }Pour plus d'informations, consultez la section Configuration d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DescribeCrossAccountAccessRole
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-findings.
- AWS CLI
-
Pour décrire les résultats
La
describe-findingscommande suivante décrit le résultat obtenu avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4:aws inspector describe-findings --finding-arnsarn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4Sortie :
{ "failedItems": {}, "findings": [ { "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4", "assetAttributes": { "ipv4Addresses": [], "schemaVersion": 1 }, "assetType": "ec2-instance", "attributes": [], "confidence": 10, "createdAt": 1458680301.37, "description": "Amazon Inspector did not find any potential security issues during this assessment.", "indicatorOfCompromise": false, "numericSeverity": 0, "recommendation": "No remediation needed.", "schemaVersion": 1, "service": "Inspector", "serviceAttributes": { "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", "rulesPackageArn": "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP", "schemaVersion": 1 }, "severity": "Informational", "title": "No potential security issues found", "updatedAt": 1458680301.37, "userAttributes": [] } ] }Pour plus d'informations, consultez les conclusions d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DescribeFindings
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-resource-groups.
- AWS CLI
-
Pour décrire les groupes de ressources
La
describe-resource-groupscommande suivante décrit le groupe de ressources dont l'ARN estarn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI:aws inspector describe-resource-groups --resource-group-arnsarn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAISortie :
{ "failedItems": {}, "resourceGroups": [ { "arn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI", "createdAt": 1458074191.098, "tags": [ { "key": "Name", "value": "example" } ] } ] }Pour plus d'informations, consultez les cibles d'évaluation d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DescribeResourceGroups
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-rules-packages.
- AWS CLI
-
Pour décrire les packages de règles
La
describe-rules-packagescommande suivante décrit le package de règles avec l'ARN dearn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p:aws inspector describe-rules-packages --rules-package-arnsarn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516pSortie :
{ "failedItems": {}, "rulesPackages": [ { "arn": "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p", "description": "The rules in this package help verify whether the EC2 instances in your application are exposed to Common Vulnerabilities and Exposures (CVEs). Attacks can exploit unpatched vulnerabilities to compromise the confidentiality, integrity, or availability of your service or data. The CVE system provides a reference for publicly known information security vulnerabilities and exposures. For more information, see [https://cve.mitre.org/](https://cve.mitre.org/). If a particular CVE appears in one of the produced Findings at the end of a completed Inspector assessment, you can search [https://cve.mitre.org/](https://cve.mitre.org/) using the CVE's ID (for example, \"CVE-2009-0021\") to find detailed information about this CVE, its severity, and how to mitigate it. ", "name": "Common Vulnerabilities and Exposures", "provider": "Amazon Web Services, Inc.", "version": "1.1" } ] }Pour plus d'informations, consultez Amazon Inspector Rules Packages and Rules dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DescribeRulesPackages
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdisassociate-member.
- AWS CLI
-
Exemple : pour dissocier un compte membre d'un administrateur délégué Amazon Inspector
L'
disassociate-memberexemple suivant dissocie un AWS compte d'un administrateur délégué Amazon Inspector.aws inspector2 disassociate-member \ --account-id123456789012Sortie :
{ "accountId": "123456789012" }Pour plus d'informations, consultez la section Gestion de plusieurs comptes dans Amazon Inspector with AWS Organizations dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous DisassociateMember
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-configuration.
- AWS CLI
-
Pour obtenir la configuration des paramètres pour les scans Inspector
L'
get-configurationexemple suivant permet d'obtenir la configuration des paramètres pour les scans Inspector.aws inspector2 get-configurationSortie :
{ "ec2Configuration": { "scanModeState": { "scanMode": "EC2_HYBRID", "scanModeStatus": "SUCCESS" } }, "ecrConfiguration": { "rescanDurationState": { "pullDateRescanDuration": "DAYS_90", "rescanDuration": "DAYS_30", "status": "SUCCESS", "updatedAt": "2024-05-14T21:16:20.237000+00:00" } } }Pour plus d'informations, consultez la section Analyse automatisée des ressources avec Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous GetConfiguration
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-member.
- AWS CLI
-
Exemple : pour obtenir des informations sur les membres de votre organisation
aws inspector2 get-member --account-id 123456789012
Sortie :
{ "member": { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2023-09-11T09:57:20.520000-07:00" } }Pour plus d'informations, consultez la section Gestion de plusieurs comptes dans Amazon Inspector with AWS Organizations dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous GetMember
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-telemetry-metadata.
- AWS CLI
-
Pour obtenir les métadonnées de télémétrie
La
get-telemetry-metadatacommande suivante génère des informations sur les données collectées pour l'évaluation exécutée avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE:aws inspector get-telemetry-metadata --assessment-run-arnarn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPESortie :
{ "telemetryMetadata": [ { "count": 2, "dataSize": 345, "messageType": "InspectorDuplicateProcess" }, { "count": 3, "dataSize": 255, "messageType": "InspectorTimeEventMsg" }, { "count": 4, "dataSize": 1082, "messageType": "InspectorNetworkInterface" }, { "count": 2, "dataSize": 349, "messageType": "InspectorDnsEntry" }, { "count": 11, "dataSize": 2514, "messageType": "InspectorDirectoryInfoMsg" }, { "count": 1, "dataSize": 179, "messageType": "InspectorTcpV6ListeningPort" }, { "count": 101, "dataSize": 10949, "messageType": "InspectorTerminal" }, { "count": 26, "dataSize": 5916, "messageType": "InspectorUser" }, { "count": 282, "dataSize": 32148, "messageType": "InspectorDynamicallyLoadedCodeModule" }, { "count": 18, "dataSize": 10172, "messageType": "InspectorCreateProcess" }, { "count": 3, "dataSize": 8001, "messageType": "InspectorProcessPerformance" }, { "count": 1, "dataSize": 360, "messageType": "InspectorOperatingSystem" }, { "count": 6, "dataSize": 546, "messageType": "InspectorStopProcess" }, { "count": 1, "dataSize": 1553, "messageType": "InspectorInstanceMetaData" }, { "count": 2, "dataSize": 434, "messageType": "InspectorTcpV4Connection" }, { "count": 474, "dataSize": 2960322, "messageType": "InspectorPackageInfo" }, { "count": 3, "dataSize": 2235, "messageType": "InspectorSystemPerformance" }, { "count": 105, "dataSize": 46048, "messageType": "InspectorCodeModule" }, { "count": 1, "dataSize": 182, "messageType": "InspectorUdpV6ListeningPort" }, { "count": 2, "dataSize": 371, "messageType": "InspectorUdpV4ListeningPort" }, { "count": 18, "dataSize": 8362, "messageType": "InspectorKernelModule" }, { "count": 29, "dataSize": 48788, "messageType": "InspectorConfigurationInfo" }, { "count": 1, "dataSize": 79, "messageType": "InspectorMonitoringStart" }, { "count": 5, "dataSize": 0, "messageType": "InspectorSplitMsgBegin" }, { "count": 51, "dataSize": 4593, "messageType": "InspectorGroup" }, { "count": 1, "dataSize": 184, "messageType": "InspectorTcpV4ListeningPort" }, { "count": 1159, "dataSize": 3146579, "messageType": "Total" }, { "count": 5, "dataSize": 0, "messageType": "InspectorSplitMsgEnd" }, { "count": 1, "dataSize": 612, "messageType": "InspectorLoadImageInProcess" } ] }-
Pour plus de détails sur l'API, reportez-vous GetTelemetryMetadata
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-account-permissions.
- AWS CLI
-
Pour répertorier les autorisations du compte
L'
list-account-permissionsexemple suivant répertorie les autorisations de votre compte.aws inspector2 list-account-permissionsSortie :
{ "permissions": [ { "operation": "ENABLE_SCANNING", "service": "ECR" }, { "operation": "DISABLE_SCANNING", "service": "ECR" }, { "operation": "ENABLE_REPOSITORY", "service": "ECR" }, { "operation": "DISABLE_REPOSITORY", "service": "ECR" }, { "operation": "ENABLE_SCANNING", "service": "EC2" }, { "operation": "DISABLE_SCANNING", "service": "EC2" }, { "operation": "ENABLE_SCANNING", "service": "LAMBDA" }, { "operation": "DISABLE_SCANNING", "service": "LAMBDA" } ] }Pour plus d'informations, consultez Identity and Access Management for Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListAccountPermissions
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-assessment-run-agents.
- AWS CLI
-
Pour répertorier les agents d'évaluation, exécutez
La
list-assessment-run-agentscommande suivante répertorie les agents de l'évaluation exécutée avec l'ARN spécifié.aws inspector list-assessment-run-agents \ --assessment-run-arnarn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPESortie :
{ "assessmentRunAgents": [ { "agentHealth": "HEALTHY", "agentHealthCode": "HEALTHY", "agentId": "i-49113b93", "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", "telemetryMetadata": [ { "count": 2, "dataSize": 345, "messageType": "InspectorDuplicateProcess" }, { "count": 3, "dataSize": 255, "messageType": "InspectorTimeEventMsg" }, { "count": 4, "dataSize": 1082, "messageType": "InspectorNetworkInterface" }, { "count": 2, "dataSize": 349, "messageType": "InspectorDnsEntry" }, { "count": 11, "dataSize": 2514, "messageType": "InspectorDirectoryInfoMsg" }, { "count": 1, "dataSize": 179, "messageType": "InspectorTcpV6ListeningPort" }, { "count": 101, "dataSize": 10949, "messageType": "InspectorTerminal" }, { "count": 26, "dataSize": 5916, "messageType": "InspectorUser" }, { "count": 282, "dataSize": 32148, "messageType": "InspectorDynamicallyLoadedCodeModule" }, { "count": 18, "dataSize": 10172, "messageType": "InspectorCreateProcess" }, { "count": 3, "dataSize": 8001, "messageType": "InspectorProcessPerformance" }, { "count": 1, "dataSize": 360, "messageType": "InspectorOperatingSystem" }, { "count": 6, "dataSize": 546, "messageType": "InspectorStopProcess" }, { "count": 1, "dataSize": 1553, "messageType": "InspectorInstanceMetaData" }, { "count": 2, "dataSize": 434, "messageType": "InspectorTcpV4Connection" }, { "count": 474, "dataSize": 2960322, "messageType": "InspectorPackageInfo" }, { "count": 3, "dataSize": 2235, "messageType": "InspectorSystemPerformance" }, { "count": 105, "dataSize": 46048, "messageType": "InspectorCodeModule" }, { "count": 1, "dataSize": 182, "messageType": "InspectorUdpV6ListeningPort" }, { "count": 2, "dataSize": 371, "messageType": "InspectorUdpV4ListeningPort" }, { "count": 18, "dataSize": 8362, "messageType": "InspectorKernelModule" }, { "count": 29, "dataSize": 48788, "messageType": "InspectorConfigurationInfo" }, { "count": 1, "dataSize": 79, "messageType": "InspectorMonitoringStart" }, { "count": 5, "dataSize": 0, "messageType": "InspectorSplitMsgBegin" }, { "count": 51, "dataSize": 4593, "messageType": "InspectorGroup" }, { "count": 1, "dataSize": 184, "messageType": "InspectorTcpV4ListeningPort" }, { "count": 1159, "dataSize": 3146579, "messageType": "Total" }, { "count": 5, "dataSize": 0, "messageType": "InspectorSplitMsgEnd" }, { "count": 1, "dataSize": 612, "messageType": "InspectorLoadImageInProcess" } ] } ] }Pour plus d'informations, consultez la section AWS Agents dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListAssessmentRunAgents
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-assessment-runs.
- AWS CLI
-
Pour répertorier les cycles d'évaluation
La
list-assessment-runscommande suivante répertorie toutes les séries d'évaluation existantes.aws inspector list-assessment-runsSortie :
{ "assessmentRunArns": [ "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE", "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-v5D6fI3v" ] }Pour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListAssessmentRuns
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-assessment-targets.
- AWS CLI
-
Pour répertorier les cibles d'évaluation
La
list-assessment-targetscommande suivante répertorie toutes les cibles d'évaluation existantes :aws inspector list-assessment-targetsSortie :
{ "assessmentTargetArns": [ "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq" ] }Pour plus d'informations, consultez les cibles d'évaluation d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListAssessmentTargets
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-assessment-templates.
- AWS CLI
-
Pour répertorier les modèles d'évaluation
La
list-assessment-templatescommande suivante répertorie tous les modèles d'évaluation existants :aws inspector list-assessment-templatesSortie :
{ "assessmentTemplateArns": [ "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw", "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-Uza6ihLh" ] }Pour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListAssessmentTemplates
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-coverage-statistics.
- AWS CLI
-
Exemple 1 : pour répertorier les statistiques de couverture par groupes
L'
list-coverage-statisticsexemple suivant répertorie les statistiques de couverture de votre AWS environnement par groupes.aws inspector2 list-coverage-statistics \ --group-byRESOURCE_TYPESortie :
{ "countsByGroup": [ { "count": 56, "groupKey": "AWS_LAMBDA_FUNCTION" }, { "count": 27, "groupKey": "AWS_ECR_REPOSITORY" }, { "count": 18, "groupKey": "AWS_EC2_INSTANCE" }, { "count": 3, "groupKey": "AWS_ECR_CONTAINER_IMAGE" }, { "count": 1, "groupKey": "AWS_ACCOUNT" } ], "totalCounts": 105 }Pour plus d'informations, consultez la section Évaluation de la couverture de votre AWS environnement par Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
Exemple 2 : pour répertorier les statistiques de couverture par type de ressource
L'
list-coverage-statisticsexemple suivant répertorie les statistiques de couverture de votre AWS environnement par type de ressource.aws inspector2 list-coverage-statistics --filter-criteria '{"resourceType":[{"comparison":"EQUALS","value":"AWS_ECR_REPOSITORY"}]}' --group-bySCAN_STATUS_REASONSortie :
{ "countsByGroup": [ { "count": 27, "groupKey": "SUCCESSFUL" } ], "totalCounts": 27 }Pour plus d'informations, consultez la section Évaluation de la couverture de votre AWS environnement par Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
Exemple 3 : pour répertorier les statistiques de couverture par nom de référentiel ECR
L'
list-coverage-statisticsexemple suivant répertorie les statistiques de couverture de votre AWS environnement par nom de référentiel ECR.aws inspector2 list-coverage-statistics --filter-criteria '{"ecrRepositoryName":[{"comparison":"EQUALS","value":"debian"}]}' --group-bySCAN_STATUS_REASONSortie :
{ "countsByGroup": [ { "count": 3, "groupKey": "SUCCESSFUL" } ], "totalCounts": 3 }Pour plus d'informations, consultez la section Évaluation de la couverture de votre AWS environnement par Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListCoverageStatistics
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-coverage.
- AWS CLI
-
Exemple 1 : pour répertorier les détails de couverture relatifs à votre environnement
L'
list-coverageexemple suivant répertorie les détails de couverture de votre environnement.aws inspector2 list-coverageSortie :
{ "coveredResources": [ { "accountId": "123456789012", "lastScannedAt": "2024-05-20T16:23:20-07:00", "resourceId": "i-EXAMPLE55555555555", "resourceMetadata": { "ec2": { "amiId": "ami-EXAMPLE6666666666", "platform": "LINUX" } }, "resourceType": "AWS_EC2_INSTANCE", "scanStatus": { "reason": "SUCCESSFUL", "statusCode": "ACTIVE" }, "scanType": "PACKAGE" } ] }Exemple 2 : pour répertorier les détails de couverture relatifs au type de ressource de la fonction Lambda
L'
list-coverageexemple suivant répertorie les détails du type de ressource de votre fonction Lamda.aws inspector2 list-coverage --filter-criteria '{"resourceType":[{"comparison":"EQUALS","value":"AWS_LAMBDA_FUNCTION"}]}'Sortie :
{ "coveredResources": [ { "accountId": "123456789012", "resourceId": "arn:aws:lambda:us-west-2:123456789012:function:Eval-container-scan-results:$LATEST", "resourceMetadata": { "lambdaFunction": { "functionName": "Eval-container-scan-results", "functionTags": {}, "layers": [], "runtime": "PYTHON_3_7" } }, "resourceType": "AWS_LAMBDA_FUNCTION", "scanStatus": { "reason": "SUCCESSFUL", "statusCode": "ACTIVE" }, "scanType": "CODE" } ] }-
Pour plus de détails sur l'API, reportez-vous ListCoverage
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-delegated-admin-accounts.
- AWS CLI
-
Pour répertorier les informations relatives au compte d'administrateur délégué de votre organisation
L'
list-delegated-admin-accountsexemple suivant répertorie les informations relatives au compte d'administrateur délégué de votre organisation.aws inspector2 list-delegated-admin-accountsSortie :
{ "delegatedAdminAccounts": [ { "accountId": "123456789012", "status": "ENABLED" } ] }Pour plus d'informations, consultez la section Désignation d'un administrateur délégué pour Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListDelegatedAdminAccounts
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-event-subscriptions.
- AWS CLI
-
Pour répertorier les abonnements aux événements
La
list-event-subscriptionscommande suivante répertorie tous les abonnements aux événements pour le modèle d'évaluation avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0:aws inspector list-event-subscriptions --resource-arnarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0Sortie :
{ "subscriptions": [ { "eventSubscriptions": [ { "event": "ASSESSMENT_RUN_COMPLETED", "subscribedAt": 1459455440.867 } ], "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0", "topicArn": "arn:aws:sns:us-west-2:123456789012:exampletopic" } ] }Pour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListEventSubscriptions
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-filters.
- AWS CLI
-
Pour répertorier les filtres associés au compte que vous avez utilisé pour activer Amazon Inspector
Les
list-filtersexemples suivants répertorient les filtres associés au compte que vous avez utilisé pour activer Amazon Inspector.aws inspector2 list-filtersSortie :
{ "filters": [ { "action": "SUPPRESS", "arn": "arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444", "createdAt": "2024-05-15T21:11:08.602000+00:00", "criteria": { "resourceType": [ { "comparison": "EQUALS", "value": "AWS_EC2_INSTANCE" }, ] }, "description": "This suppression rule omits EC2 instance type findings", "name": "ExampleSuppressionRuleEC2", "ownerId": "o-EXAMPLE222", "tags": {}, "updatedAt": "2024-05-15T21:11:08.602000+00:00" }, { "action": "SUPPRESS", "arn": "arn:aws:inspector2:us-east-1:813737243517:owner/o-EXAMPLE222/filter/EXAMPLE444444444", "createdAt": "2024-05-15T21:28:27.054000+00:00", "criteria": { "resourceType": [ { "comparison": "EQUALS", "value": "AWS_ECR_INSTANCE" } ] }, "description": "This suppression rule omits ECR instance type findings", "name": "ExampleSuppressionRuleECR", "ownerId": "o-EXAMPLE222", "tags": {}, "updatedAt": "2024-05-15T21:28:27.054000+00:00" } ] }Pour plus d'informations, consultez Filtrer les résultats d'Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListFilters
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-findings.
- AWS CLI
-
Pour répertorier les résultats
La
list-findingscommande suivante répertorie tous les résultats générés :aws inspector list-findingsSortie :
{ "findingArns": [ "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4", "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-v5D6fI3v/finding/0-tyvmqBLy" ] }Pour plus d'informations, consultez les conclusions d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListFindings
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-members.
- AWS CLI
-
Exemple 1 : pour répertorier tous les comptes membres associés à l'administrateur délégué Amazon Inspector de votre organisation
aws inspector2 list-members --only-associated
Sortie :
{ { "members": [ { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2023-09-11T09:57:20.520000-07:00" }, { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2024-08-12T10:13:01.472000-07:00" }, { "accountId": "625032911453", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2023-09-11T09:57:20.438000-07:00" }, { "accountId": "715411239211", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2024-04-24T09:14:57.471000-07:00" } ] }Pour plus d'informations, consultez la section Gestion de plusieurs comptes dans Amazon Inspector with AWS Organizations dans le guide de l'utilisateur d'Amazon Inspector.
Exemple 2 : pour répertorier tous les comptes membres associés et dissociés de l'administrateur délégué Amazon Inspector de votre organisation
membres de la liste des membres d'AWS Inspector2 -- no-only-associated
Sortie :
{ { "members": [ { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "REMOVED", "updatedAt": "2024-05-15T11:34:53.326000-07:00" }, { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2023-09-11T09:57:20.520000-07:00" }, { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2024-08-12T10:13:01.472000-07:00" }, { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2023-09-11T09:57:20.438000-07:00" }, { "accountId": "123456789012", "delegatedAdminAccountId": "123456789012", "relationshipStatus": "ENABLED", "updatedAt": "2024-04-24T09:14:57.471000-07:00" } ] }Pour plus d'informations, consultez la section Gestion de plusieurs comptes dans Amazon Inspector with AWS Organizations dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListMembers
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-rules-packages.
- AWS CLI
-
Pour répertorier les packages de règles
La
list-rules-packagescommande suivante répertorie tous les packages de règles Inspector disponibles :aws inspector list-rules-packagesSortie :
{ "rulesPackageArns": [ "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p", "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-H5hpSawc", "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-JJOtZiqQ", "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-vg5GGHSD" ] }Pour plus d'informations, consultez Amazon Inspector Rules Packages and Rules dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListRulesPackages
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-tags-for-resource.
- AWS CLI
-
Pour répertorier les balises d'une ressource
La
list-tags-for-resourcecommande suivante répertorie toutes les balises associées au modèle d'évaluation avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-gcwFliYu:aws inspector list-tags-for-resource --resource-arnarn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-gcwFliYuSortie :
{ "tags": [ { "key": "Name", "value": "Example" } ] }Pour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListTagsForResource
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-usage-totals.
- AWS CLI
-
Pour répertorier les totaux d'utilisation au cours des 30 derniers jours
Les
list-usage-totalsexemples suivants répertorient les totaux d'utilisation au cours des 30 derniers jours.aws inspector2 list-usage-totalsSortie :
{ "totals": [ { "accountId": "123456789012", "usage": [ { "currency": "USD", "estimatedMonthlyCost": 4.6022044647, "total": 1893.4784083333334, "type": "EC2_AGENTLESS_INSTANCE_HOURS" }, { "currency": "USD", "estimatedMonthlyCost": 18.892449279, "total": 10882.050784722222, "type": "EC2_INSTANCE_HOURS" }, { "currency": "USD", "estimatedMonthlyCost": 5.4525363736, "total": 6543.043648333333, "type": "LAMBDA_FUNCTION_CODE_HOURS" }, { "currency": "USD", "estimatedMonthlyCost": 3.9064080309, "total": 9375.379274166668, "type": "LAMBDA_FUNCTION_HOURS" }, { "currency": "USD", "estimatedMonthlyCost": 0.06, "total": 6.0, "type": "ECR_RESCAN" }, { "currency": "USD", "estimatedMonthlyCost": 0.09, "total": 1.0, "type": "ECR_INITIAL_SCAN" } ] } ] }Pour plus d'informations, consultez la section Surveillance de l'utilisation et des coûts dans Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous ListUsageTotals
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserpreview-agents.
- AWS CLI
-
Pour prévisualiser les agents
La
preview-agentscommande suivante affiche un aperçu des agents installés sur les EC2 instances faisant partie de la cible d'évaluation avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq:aws inspector preview-agents --preview-agents-arnarn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusqSortie :
{ "agentPreviews": [ { "agentId": "i-49113b93" } ] }Pour plus d'informations, consultez les cibles d'évaluation d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous PreviewAgents
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserregister-cross-account-access-role.
- AWS CLI
-
Pour enregistrer le rôle d'accès multicompte
La
register-cross-account-access-rolecommande suivante enregistre le rôle IAM auprès dearn:aws:iam::123456789012:role/inspectorl'ARN utilisé par Amazon Inspector pour répertorier vos EC2 instances au début de l'exécution de l'évaluation ou lorsque vous appelez la commande preview-agents :aws inspector register-cross-account-access-role --role-arnarn:aws:iam::123456789012:role/inspectorPour plus d'informations, consultez la section Configuration d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous RegisterCrossAccountAccessRole
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserremove-attributes-from-findings.
- AWS CLI
-
Pour supprimer des attributs des résultats
La
remove-attributes-from-findingcommande suivante supprime l'attribut avec la cléExampleet la valeur de deexamplede la recherche avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU:aws inspector remove-attributes-from-findings --finding-arnsarn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU--attribute-keyskey=Example,value=exampleSortie :
{ "failedItems": {} }Pour plus d'informations, consultez les conclusions d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous RemoveAttributesFromFindings
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserset-tags-for-resource.
- AWS CLI
-
Pour définir des balises pour une ressource
La
set-tags-for-resourcecommande suivante définit la balise avec la cléExampleet la valeurexamplede sur le modèle d'évaluation dont l'ARN estarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0:aws inspector set-tags-for-resource --resource-arnarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0--tagskey=Example,value=examplePour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous SetTagsForResource
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserstart-assessment-run.
- AWS CLI
-
Pour démarrer un cycle d'évaluation
La
start-assessment-runcommande suivante lance l'exécution d'évaluation nomméeexamplerunà l'aide du modèle d'évaluation avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T:aws inspector start-assessment-run --assessment-run-nameexamplerun--assessment-template-arnarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4TSortie :
{ "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-jOoroxyY" }Pour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous StartAssessmentRun
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserstop-assessment-run.
- AWS CLI
-
Pour arrêter un cycle d'évaluation
La
stop-assessment-runcommande suivante arrête l'exécution de l'évaluation avec l'ARN dearn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-jOoroxyY:aws inspector stop-assessment-run --assessment-run-arnarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-jOoroxyYPour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous StopAssessmentRun
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisersubscribe-to-event.
- AWS CLI
-
Pour s'abonner à un événement
L'exemple suivant permet d'envoyer des notifications Amazon SNS concernant l'
ASSESSMENT_RUN_COMPLETEDévénement au sujet avec l'ARN dearn:aws:sns:us-west-2:123456789012:exampletopicaws inspector subscribe-to-event \ --eventASSESSMENT_RUN_COMPLETED\ --resource-arnarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0\ --topic-arnarn:aws:sns:us-west-2:123456789012:exampletopicCette commande ne produit aucun résultat.
Pour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous SubscribeToEvent
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserunsubscribe-from-event.
- AWS CLI
-
Pour se désinscrire d'un événement
La
unsubscribe-from-eventcommande suivante désactive le processus d'envoi de notifications Amazon SNS concernantASSESSMENT_RUN_COMPLETEDl'événement au sujet avec l'ARN suivant :arn:aws:sns:us-west-2:123456789012:exampletopicaws inspector unsubscribe-from-event --eventASSESSMENT_RUN_COMPLETED--resource-arnarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0--topicarn:aws:sns:us-west-2:123456789012:exampletopicPour plus d'informations, consultez les modèles d'évaluation et les cycles d'évaluation Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous UnsubscribeFromEvent
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-assessment-target.
- AWS CLI
-
Pour mettre à jour un objectif d'évaluation
La
update-assessment-targetcommande suivante met à jour la cible d'évaluation avec l'ARNarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxXet le nom deExample, et le groupe de ressources avec l'ARN dearn:aws:inspector:us-west-2:123456789012:resourcegroup/0-yNbgL5Pt:aws inspector update-assessment-target --assessment-target-arnarn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX--assessment-target-nameExample--resource-group-arnarn:aws:inspector:us-west-2:123456789012:resourcegroup/0-yNbgL5PtPour plus d'informations, consultez les cibles d'évaluation d'Amazon Inspector dans le guide Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous UpdateAssessmentTarget
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-filter.
- AWS CLI
-
Pour mettre à jour un filtre
L'
update-filterexemple suivant met à jour un filtre pour omettre les résultats Lambda au lieu des résultats de l'instance ECR.aws inspector2 update-filter \ --filter-arn"arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444"\ --name"ExampleSuppressionRuleLambda"\ --description"This suppression rule omits Lambda instance findings"\ --reason"Updating filter to omit Lambda instance findings instead of ECR instance findings"Sortie :
{ "filters": [ { "action": "SUPPRESS", "arn": "arn:aws:inspector2:us-west-2:123456789012:owner/o-EXAMPLE222/filter/EXAMPLE444444444", "createdAt": "2024-05-15T21:28:27.054000+00:00", "criteria": { "resourceType": [ { "comparison": "EQUALS", "value": "AWS_ECR_INSTANCE" } ] }, "description": "This suppression rule omits Lambda instance findings", "name": "ExampleSuppressionRuleLambda", "ownerId": "o-EXAMPLE222", "reason": "Updating filter to omit Lambda instance findings instead of ECR instance findings", "tags": {}, "updatedAt": "2024-05-15T22:23:13.665000+00:00" } ] }Pour plus d'informations, consultez la section Gestion des résultats dans Amazon Inspector dans le guide de l'utilisateur d'Amazon Inspector.
-
Pour plus de détails sur l'API, reportez-vous UpdateFilter
à la section Référence des AWS CLI commandes.
-