AWS Support exemples utilisant AWS CLI - AWS Command Line Interface
Actions

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

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.

AWS Support exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with AWS Support.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Les actions vous indiquent comment appeler des fonctions de service individuelles, mais vous pouvez les visualiser dans leur contexte dans les scénarios correspondants.

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-attachments-to-set.

AWS CLI

Pour ajouter une pièce jointe à un ensemble

L'add-attachments-to-setexemple suivant ajoute une image à un ensemble que vous pouvez ensuite spécifier pour un dossier d'assistance dans votre AWS compte.

aws support add-attachments-to-set \
    --attachment-set-id "as-2f5a6faa2a4a1e600-mu-nk5xQlBr70-G1cUos5LZkd38KOAHZa9BMDVzNEXAMPLE" \
    --attachments fileName=troubleshoot-screenshot.png,data=base64-encoded-string

Sortie :

{
    "attachmentSetId": "as-2f5a6faa2a4a1e600-mu-nk5xQlBr70-G1cUos5LZkd38KOAHZa9BMDVzNEXAMPLE",
    "expiryTime": "2020-05-14T17:04:40.790+0000"
}

Pour plus d'informations, consultez la section Gestion des dossiers dans le Guide de l'utilisateur du AWS Support.

  • Pour API plus de détails, voir AddAttachmentsToSetla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseradd-communication-to-case.

AWS CLI

Pour ajouter une communication à un dossier

L'add-communication-to-caseexemple suivant ajoute des communications à une demande d'assistance dans votre AWS compte.

aws support add-communication-to-case \
    --case-id "case-12345678910-2013-c4c1d2bf33c5cf47" \
    --communication-body "I'm attaching a set of images to this case." \
    --cc-email-addresses "myemail@example.com" \
    --attachment-set-id "as-2f5a6faa2a4a1e600-mu-nk5xQlBr70-G1cUos5LZkd38KOAHZa9BMDVzNEXAMPLE"

Sortie :

{
    "result": true
}

Pour plus d'informations, consultez la section Gestion des dossiers dans le Guide de l'utilisateur du AWS Support.

L'exemple de code suivant montre comment utilisercreate-case.

AWS CLI

Pour créer un dossier

L'create-caseexemple suivant crée une demande d'assistance pour votre AWS compte.

aws support create-case \
    --category-code "using-aws" \
    --cc-email-addresses "myemail@example.com" \
    --communication-body "I want to learn more about an AWS service." \
    --issue-type "technical" \
    --language "en" \
    --service-code "general-info" \
    --severity-code "low" \
    --subject "Question about my account"

Sortie :

{
    "caseId": "case-12345678910-2013-c4c1d2bf33c5cf47"
}

Pour plus d'informations, consultez la section Gestion des dossiers dans le Guide de l'utilisateur du AWS Support.

  • Pour API plus de détails, voir CreateCasela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-attachment.

AWS CLI

Pour décrire une pièce jointe

L'describe-attachmentexemple suivant renvoie des informations sur la pièce jointe avec l'ID spécifié.

aws support describe-attachment \
    --attachment-id "attachment-KBnjRNrePd9D6Jx0-Mm00xZuDEaL2JAj_0-gJv9qqDooTipsz3V1Nb19rCfkZneeQeDPgp8X1iVJyHH7UuhZDdNeqGoduZsPrAhyMakqlc60-iJjL5HqyYGiT1FG8EXAMPLE"

Sortie :

{
    "attachment": {
        "fileName": "troubleshoot-screenshot.png",
        "data": "base64-blob"
    }
}

Pour plus d'informations, consultez la section Gestion des dossiers dans le Guide de l'utilisateur du AWS Support.

  • Pour API plus de détails, voir DescribeAttachmentla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-cases.

AWS CLI

Pour décrire un cas

L'describe-casesexemple suivant renvoie des informations sur le dossier d'assistance spécifié dans votre AWS compte.

aws support describe-cases \
    --display-id "1234567890" \
    --after-time "2020-03-23T21:31:47.774Z" \
    --include-resolved-cases \
    --language "en" \
    --no-include-communications \
    --max-item 1

Sortie :

{
    "cases": [
        {
            "status": "resolved",
            "ccEmailAddresses": [],
            "timeCreated": "2020-03-23T21:31:47.774Z",
            "caseId": "case-12345678910-2013-c4c1d2bf33c5cf47",
            "severityCode": "low",
            "language": "en",
            "categoryCode": "using-aws",
            "serviceCode": "general-info",
            "submittedBy": "myemail@example.com",
            "displayId": "1234567890",
            "subject": "Question about my account"
        }
    ]
}

Pour plus d'informations, consultez la section Gestion des dossiers dans le Guide de l'utilisateur du AWS Support.

  • Pour API plus de détails, voir DescribeCasesla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-communications.

AWS CLI

Pour décrire la dernière communication concernant un dossier

L'describe-communicationsexemple suivant renvoie la dernière communication concernant le dossier d'assistance spécifié dans votre AWS compte.

aws support describe-communications \
    --case-id "case-12345678910-2013-c4c1d2bf33c5cf47" \
    --after-time "2020-03-23T21:31:47.774Z" \
    --max-item 1

Sortie :

{
    "communications": [
        {
            "body": "I want to learn more about an AWS service.",
            "attachmentSet": [],
            "caseId": "case-12345678910-2013-c4c1d2bf33c5cf47",
            "timeCreated": "2020-05-12T23:12:35.000Z",
            "submittedBy": "Amazon Web Services"
        }
    ],
    "NextToken": "eyJuZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQEXAMPLE=="
}

Pour plus d'informations, consultez la section Gestion des dossiers dans le Guide de l'utilisateur du AWS Support.

L'exemple de code suivant montre comment utiliserdescribe-services.

AWS CLI

Pour répertorier AWS les services et les catégories de services

L'describe-servicesexemple suivant répertorie les catégories de services disponibles pour demander des informations générales.

aws support describe-services \
    --service-code-list "general-info"

Sortie :

{
    "services": [
        {
            "code": "general-info",
            "name": "General Info and Getting Started",
            "categories": [
                {
                    "code": "charges",
                    "name": "How Will I Be Charged?"
                },
                {
                    "code": "gdpr-queries",
                    "name": "Data Privacy Query"
                },
                {
                    "code": "reserved-instances",
                    "name": "Reserved Instances"
                },
                {
                    "code": "resource",
                    "name": "Where is my Resource?"
                },
                {
                    "code": "using-aws",
                    "name": "Using AWS & Services"
                },
                {
                    "code": "free-tier",
                    "name": "Free Tier"
                },
                {
                    "code": "security-and-compliance",
                    "name": "Security & Compliance"
                },
                {
                    "code": "account-structure",
                    "name": "Account Structure"
                }
            ]
        }
    ]
}

Pour plus d'informations, consultez la section Gestion des dossiers dans le Guide de l'utilisateur du AWS Support.

  • Pour API plus de détails, voir DescribeServicesla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-severity-levels.

AWS CLI

Pour répertorier les niveaux de gravité disponibles

L'describe-severity-levelsexemple suivant répertorie les niveaux de gravité disponibles pour un dossier de support.

aws support describe-severity-levels

Sortie :

{
    "severityLevels": [
        {
            "code": "low",
            "name": "Low"
        },
        {
            "code": "normal",
            "name": "Normal"
        },
        {
            "code": "high",
            "name": "High"
        },
        {
            "code": "urgent",
            "name": "Urgent"
        },
        {
            "code": "critical",
            "name": "Critical"
        }
    ]
}

Pour plus d'informations, consultez la section Choix d'une sévérité dans le Guide de l'utilisateur du AWS Support.

L'exemple de code suivant montre comment utiliserdescribe-trusted-advisor-check-refresh-statuses.

AWS CLI

Pour répertorier les statuts d'actualisation des chèques AWS Trusted Advisor

L'describe-trusted-advisor-check-refresh-statusesexemple suivant répertorie les statuts d'actualisation de deux contrôles Trusted Advisor : Amazon S3 Bucket Permissions and IAM Use.

aws support describe-trusted-advisor-check-refresh-statuses \
    --check-id "Pfx0RwqBli" "zXCkfM1nI3"

Sortie :

{
    "statuses": [
        {
            "checkId": "Pfx0RwqBli",
            "status": "none",
            "millisUntilNextRefreshable": 0
        },
        {
            "checkId": "zXCkfM1nI3",
            "status": "none",
            "millisUntilNextRefreshable": 0
        }
    ]
}

Pour plus d'informations, consultez AWS Trusted Advisor dans le Guide de l'utilisateur du AWS Support.

L'exemple de code suivant montre comment utiliserdescribe-trusted-advisor-check-result.

AWS CLI

Pour répertorier les résultats d'un check AWS Trusted Advisor

L'describe-trusted-advisor-check-resultexemple suivant répertorie les résultats du contrôle IAM d'utilisation.

aws support describe-trusted-advisor-check-result \
    --check-id "zXCkfM1nI3"

Sortie :

{
    "result": {
        "checkId": "zXCkfM1nI3",
        "timestamp": "2020-05-13T21:38:05Z",
        "status": "ok",
        "resourcesSummary": {
            "resourcesProcessed": 1,
            "resourcesFlagged": 0,
            "resourcesIgnored": 0,
            "resourcesSuppressed": 0
        },
        "categorySpecificSummary": {
            "costOptimizing": {
                "estimatedMonthlySavings": 0.0,
                "estimatedPercentMonthlySavings": 0.0
            }
        },
        "flaggedResources": [
            {
                "status": "ok",
                "resourceId": "47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZEXAMPLE",
                "isSuppressed": false
            }
        ]
    }
}

Pour plus d'informations, consultez AWS Trusted Advisor dans le Guide de l'utilisateur du AWS Support.

L'exemple de code suivant montre comment utiliserdescribe-trusted-advisor-check-summaries.

AWS CLI

Pour répertorier les résumés des contrôles effectués par AWS Trusted Advisor

L'describe-trusted-advisor-check-summariesexemple suivant répertorie les résultats de deux contrôles effectués par Trusted Advisor : Amazon S3 Bucket Permissions and IAM Use.

aws support describe-trusted-advisor-check-summaries \
    --check-ids "Pfx0RwqBli" "zXCkfM1nI3"

Sortie :

{
    "summaries": [
        {
            "checkId": "Pfx0RwqBli",
            "timestamp": "2020-05-13T21:38:12Z",
            "status": "ok",
            "hasFlaggedResources": true,
            "resourcesSummary": {
                "resourcesProcessed": 44,
                "resourcesFlagged": 0,
                "resourcesIgnored": 0,
                "resourcesSuppressed": 0
            },
            "categorySpecificSummary": {
                "costOptimizing": {
                    "estimatedMonthlySavings": 0.0,
                    "estimatedPercentMonthlySavings": 0.0
                }
            }
        },
        {
            "checkId": "zXCkfM1nI3",
            "timestamp": "2020-05-13T21:38:05Z",
            "status": "ok",
            "hasFlaggedResources": true,
            "resourcesSummary": {
                "resourcesProcessed": 1,
                "resourcesFlagged": 0,
                "resourcesIgnored": 0,
                "resourcesSuppressed": 0
            },
            "categorySpecificSummary": {
                "costOptimizing": {
                    "estimatedMonthlySavings": 0.0,
                    "estimatedPercentMonthlySavings": 0.0
                }
            }
        }
    ]
}

Pour plus d'informations, consultez AWS Trusted Advisor dans le Guide de l'utilisateur du AWS Support.

L'exemple de code suivant montre comment utiliserdescribe-trusted-advisor-checks.

AWS CLI

Pour répertorier les chèques AWS Trusted Advisor disponibles

L'describe-trusted-advisor-checksexemple suivant répertorie les chèques Trusted Advisor disponibles sur votre AWS compte. Ces informations incluent le nom, l'identifiant, la description, la catégorie et les métadonnées du chèque. Notez que la sortie est raccourcie pour des raisons de lisibilité.

aws support describe-trusted-advisor-checks \
    --language "en"

Sortie :

{
    "checks": [
        {
            "id": "zXCkfM1nI3",
            "name": "IAM Use",
            "description": "Checks for your use of AWS Identity and Access Management (IAM). You can use IAM to create users, groups, and roles in AWS, and you can use permissions to control access to AWS resources. \n<br>\n<br>\n<b>Alert Criteria</b><br>\nYellow: No IAM users have been created for this account.\n<br>\n<br>\n<b>Recommended Action</b><br>\nCreate one or more IAM users and groups in your account. You can then create additional users whose permissions are limited to perform specific tasks in your AWS environment. For more information, see <a href=\"https://docs.aws.amazon.com/IAM/latest/UserGuide/IAMGettingStarted.html\" target=\"_blank\">Getting Started</a>. \n<br><br>\n<b>Additional Resources</b><br>\n<a href=\"https://docs.aws.amazon.com/IAM/latest/UserGuide/IAM_Introduction.html\" target=\"_blank\">What Is IAM?</a>",
            "category": "security",
            "metadata": []
        }
    ]
}

Pour plus d'informations, consultez AWS Trusted Advisor dans le Guide de l'utilisateur du AWS Support.

L'exemple de code suivant montre comment utiliserrefresh-trusted-advisor-check.

AWS CLI

Pour actualiser un check AWS Trusted Advisor

L'refresh-trusted-advisor-checkexemple suivant actualise le check Amazon S3 Bucket Permissions Trusted Advisor dans votre AWS compte.

aws support refresh-trusted-advisor-check \
    --check-id "Pfx0RwqBli"

Sortie :

{
    "status": {
        "checkId": "Pfx0RwqBli",
        "status": "enqueued",
        "millisUntilNextRefreshable": 3599992
    }
}

Pour plus d'informations, consultez AWS Trusted Advisor dans le Guide de l'utilisateur du AWS Support.

L'exemple de code suivant montre comment utiliserresolve-case.

AWS CLI

Pour résoudre un dossier d'assistance

L'resolve-caseexemple suivant résout une demande d'assistance dans votre AWS compte.

aws support resolve-case \
    --case-id "case-12345678910-2013-c4c1d2bf33c5cf47"

Sortie :

{
    "finalCaseStatus": "resolved",
    "initialCaseStatus": "work-in-progress"
}

Pour plus d'informations, consultez la section Gestion des dossiers dans le Guide de l'utilisateur du AWS Support.

  • Pour API plus de détails, voir ResolveCasela section Référence des AWS CLI commandes.