Supporto esempi di utilizzo 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

Azioni

L’esempio di codice seguente mostra come utilizzare add-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 puoi quindi specificare per un caso di supporto nel tuo account. AWS


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 i dettagli sull'API, vedi 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'add-communication-to-caseesempio seguente aggiunge comunicazioni a una richiesta di assistenza nel tuo account. AWS


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 i dettagli sull'API, vedi AddCommunicationToCase in AWS CLI Command Reference.

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

AWS CLI

Come creare un caso

L'create-caseesempio seguente crea una richiesta di assistenza 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 .

Per i dettagli sull'API, vedi 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 i dettagli sull'API, vedi DescribeAttachment in AWS CLI Command Reference.

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

AWS CLI

Come descrivere un caso

L'describe-casesesempio seguente restituisce informazioni sul caso di supporto specificato nel tuo account. AWS


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 i dettagli sull'API, vedi 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'describe-communicationsesempio seguente restituisce l'ultima comunicazione per il caso di supporto specificato nel tuo account. AWS


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 i dettagli sull'API, vedi DescribeCommunications in AWS CLI Command Reference.

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

AWS CLI

Per elencare i servizi e le categorie AWS 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 .

Per i dettagli sull'API, vedi 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 Selezione di una gravità nella Guida per l’utente del Supporto AWS .

Per i dettagli sull'API, vedi in Command Reference. DescribeSeverityLevels AWS CLI

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

AWS CLI

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

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 i dettagli sull'API, vedi DescribeTrustedAdvisorCheckRefreshStatuses in AWS CLI Command Reference.

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

AWS CLI

Per elencare i risultati di un controllo di Trusted Advisor AWS

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 i dettagli sull'API, consulta la sezione DescribeTrustedAdvisorCheckResult AWS CLI Command Reference.

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

AWS CLI

Per elencare i riepiloghi dei controlli di Trusted Advisor AWS

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 i dettagli sulle API, consulta la sezione DescribeTrustedAdvisorCheckSummaries AWS CLI Command Reference.

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

AWS CLI

Per elencare i controlli Trusted Advisor disponibili AWS

L'describe-trusted-advisor-checksesempio seguente elenca i controlli 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 .

Per i dettagli sull'API, vedi DescribeTrustedAdvisorChecks in AWS CLI Command Reference.

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

AWS CLI

Per aggiornare un controllo di Trusted Advisor AWS

L'refresh-trusted-advisor-checkesempio seguente aggiorna il controllo 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 .

Per i dettagli sulle API, consulta RefreshTrustedAdvisorCheck la sezione Command Reference. AWS CLI

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

AWS CLI

Come risolvere un caso di supporto

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


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, vedi 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