Esempi di Supporto con la AWS CLI

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

Le operazioni 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, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

Operazioni

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’account AWS 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 in AWS CLI Command Reference.

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 in AWS CLI Command Reference.

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 in AWS CLI Command Reference.

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 in AWS CLI Command Reference.

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 in AWS CLI Command Reference.

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 in AWS CLI Command Reference.

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 in AWS CLI Command Reference.

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 Scelta del livello di gravità nella Guida per l’utente del Supporto AWS.

Per informazioni dettagliate sull’API, consulta DescribeSeverityLevels in AWS CLI Command Reference.

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 in AWS CLI Command Reference.

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 in AWS CLI Command Reference.

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 in AWS CLI Command Reference.

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 in AWS CLI Command Reference.

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 in AWS CLI Command Reference.

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

AWS CLI

Risolvere un caso di supporto

L’esempio resolve-case seguente viene risolto 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 in AWS CLI Command Reference.

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