Supporto esempi utilizzando AWS CLI - AWS Command Line Interface
Azioni

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Supporto esempi utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with Supporto.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzareadd-attachments-to-set.

AWS CLI

Come aggiungere un allegato a un set

L'add-attachments-to-setesempio seguente aggiunge un'immagine a un set che potete quindi specificare per un caso di supporto nel vostro AWS account.

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

Output:

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

Per ulteriori informazioni, consulta Gestione dei casi nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzareadd-communication-to-case.

AWS CLI

Come aggiungere una comunicazione a un caso

L'add-communication-to-caseesempio seguente aggiunge comunicazioni a una richiesta di supporto nel tuo AWS account.

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"

Output:

{
    "result": true
}

Per ulteriori informazioni, consulta Gestione dei casi nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzarecreate-case.

AWS CLI

Come creare un caso

L'create-caseesempio seguente crea una richiesta di supporto per il tuo AWS account.

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"

Output:

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

Per ulteriori informazioni, consulta Gestione dei casi nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-attachment.

AWS CLI

Come descrivere un allegato

L’esempio describe-attachment seguente restituisce le informazioni sull’allegato con l’ID specificato.

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

Output:

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

Per ulteriori informazioni, consulta Gestione dei casi nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-cases.

AWS CLI

Come descrivere un caso

L'describe-casesesempio seguente restituisce informazioni sulla richiesta di supporto specificata nell' AWS account.

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

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Gestione dei casi nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-communications.

AWS CLI

Come descrivere la comunicazione più recente relativa a un caso

L'describe-communicationsesempio seguente restituisce la comunicazione più recente per il caso di supporto specificato nel tuo AWS account.

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

Output:

{
    "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=="
}

Per ulteriori informazioni, consulta Gestione dei casi nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-services.

AWS CLI

Per elencare AWS i servizi e le categorie di servizi

L’esempio describe-services seguente elenca le categorie dei servizi disponibili per la richiesta di informazioni generali.

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

Output:

{
    "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"
                }
            ]
        }
    ]
}

Per ulteriori informazioni, consulta Gestione dei casi nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-severity-levels.

AWS CLI

Come elencare i livelli di gravità disponibili

L’esempio describe-severity-levels seguente elenca i livelli di gravità disponibili per un caso di supporto.

aws support describe-severity-levels

Output:

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

Per ulteriori informazioni, consulta Selezione di una gravità nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-trusted-advisor-check-refresh-statuses.

AWS CLI

Per elencare gli stati di aggiornamento dei controlli di AWS Trusted Advisor

L’esempio describe-trusted-advisor-check-refresh-statuses seguente elenca gli stati di aggiornamento per due controlli di Trusted Advisor, ovvero Autorizzazioni bucket di Amazon S3 e Uso IAM.

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

Output:

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

Per ulteriori informazioni, consulta AWS Trusted Advisor nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-trusted-advisor-check-result.

AWS CLI

Per elencare i risultati di un controllo di AWS Trusted Advisor

L’esempio describe-trusted-advisor-check-result seguente elenca i risultati del controllo Uso IAM.

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

Output:

{
    "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
            }
        ]
    }
}

Per ulteriori informazioni, consulta AWS Trusted Advisor nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-trusted-advisor-check-summaries.

AWS CLI

Per elencare i riepiloghi dei controlli di AWS Trusted Advisor

L’esempio describe-trusted-advisor-check-summaries seguente elenca i risultati di due controlli di Trusted Advisor, ovvero Autorizzazioni bucket di Amazon S3 e Uso IAM.

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

Output:

{
    "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
                }
            }
        }
    ]
}

Per ulteriori informazioni, consulta AWS Trusted Advisor nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-trusted-advisor-checks.

AWS CLI

Per elencare i controlli AWS Trusted Advisor disponibili

L'describe-trusted-advisor-checksesempio seguente elenca gli assegni Trusted Advisor disponibili nel tuo AWS account. Queste informazioni includono il nome, l’ID, la descrizione, la categoria e i metadati del controllo. Nota che l’output è abbreviato per motivi di leggibilità.

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

Output:

{
    "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": []
        }
    ]
}

Per ulteriori informazioni, consulta AWS Trusted Advisor nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzarerefresh-trusted-advisor-check.

AWS CLI

Per aggiornare un controllo di AWS Trusted Advisor

L'refresh-trusted-advisor-checkesempio seguente aggiorna il check di Amazon S3 Bucket Permissions Trusted Advisor nel tuo account. AWS 

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

Output:

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

Per ulteriori informazioni, consulta AWS Trusted Advisor nella Guida per l’utente del Supporto AWS .

Il seguente esempio di codice mostra come utilizzareresolve-case.

AWS CLI

Come risolvere un caso di supporto

L'resolve-caseesempio seguente risolve un caso di assistenza nel tuo AWS account.

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

Output:

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

Per ulteriori informazioni, consulta Gestione dei casi nella Guida per l’utente del Supporto AWS .

  • Per i dettagli sull'API, consulta AWS CLI Command ResolveCaseReference.