Esempi per Supporto con AWS CLI

Gli esempi di codice seguenti mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Command Line Interface con Supporto.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni 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

Azioni

L’esempio di codice seguente mostra come utilizzare add-attachments-to-set.

AWS CLI

Come aggiungere un allegato a un set

L’esempio add-attachments-to-set seguente aggiunge un’immagine a un set che può quindi essere specificato per un caso di supporto nell’AWS account in uso.


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.

Per informazioni dettagliate sull’API, consulta AddAttachmentsToSet nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare add-communication-to-case.

AWS CLI

Come aggiungere una comunicazione a un caso

L’esempio add-communication-to-case seguente aggiunge comunicazioni a un caso di supporto nell’account AWS in uso.


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.

Per informazioni dettagliate sull’API, consulta AddCommunicationToCase nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare create-case.

AWS CLI

Come creare un caso

L’esempio create-case seguente crea un caso di supporto per l’account AWS in uso.


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.

Per informazioni dettagliate sull’API, consulta CreateCase nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare describe-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.

Per informazioni dettagliate sull’API, consulta DescribeAttachment nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare describe-cases.

AWS CLI

Come descrivere un caso

L’esempio describe-cases seguente restituisce le informazioni sul caso di supporto specificato nell’account AWS in uso.


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.

Per informazioni dettagliate sull’API, consulta DescribeCases nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare describe-communications.

AWS CLI

Come descrivere la comunicazione più recente relativa a un caso

L’esempio describe-communications seguente restituisce la comunicazione più recente relativa al caso di supporto specificato nell’account AWS in uso.


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.

Per informazioni dettagliate sull’API, consulta DescribeCommunications nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare describe-services.

AWS CLI

Come elencare i servizi AWS e le relative categorie

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.

Per informazioni dettagliate sull’API, consulta DescribeServices nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare describe-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.

Per informazioni dettagliate sull’API, consulta DescribeSeverityLevels nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare describe-trusted-advisor-check-refresh-statuses.

AWS CLI

Come 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.

Per informazioni dettagliate sull’API, consulta DescribeTrustedAdvisorCheckRefreshStatuses nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare describe-trusted-advisor-check-result.

AWS CLI

Come 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.

Per informazioni dettagliate sull’API, consulta DescribeTrustedAdvisorCheckResult nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare describe-trusted-advisor-check-summaries.

AWS CLI

Come 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.

Per informazioni dettagliate sull’API, consulta DescribeTrustedAdvisorCheckSummaries nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare describe-trusted-advisor-checks.

AWS CLI

Come elencare i controlli di AWS Trusted Advisor disponibili

L’esempio describe-trusted-advisor-checks seguente elenca i controlli di Trusted Advisor disponibili nell’account AWS in uso. 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.

Per informazioni dettagliate sull’API, consulta DescribeTrustedAdvisorChecks nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare refresh-trusted-advisor-check.

AWS CLI

Come aggiornare un controllo di AWS Trusted Advisor

L’esempio refresh-trusted-advisor-check seguente aggiorna il controllo di Trusted Advisor, ovvero Autorizzazioni bucket di Amazon S3, nell’account AWS in uso.


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.

Per informazioni dettagliate sull’API, consulta RefreshTrustedAdvisorCheck nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare resolve-case.

AWS CLI

Come risolvere un caso di supporto

L’esempio resolve-case seguente risolve un caso di supporto nell’account AWS in uso.


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 informazioni dettagliate sull’API, consulta ResolveCase nella documentazione di riferimento dei comandi della AWS CLI.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

AWS STS

Amazon SWF