Support-Beispiele zur Verwendung von AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit Support nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Aktionen

Das folgende Codebeispiel zeigt, wie add-attachments-to-set verwendet wird.

AWS CLI

So fügen Sie einen Anhang zu einem Satz hinzu

Im folgenden Beispiel für add-attachments-to-set wird einem Satz ein Bild hinzugefügt, das Sie dann für einen Supportfall in Ihrem AWS-Konto angeben können.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Fallmanagement im AWS-Benutzerhandbuch.

API-Details finden Sie unter AddAttachmentsToSet in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie add-communication-to-case verwendet wird.

AWS CLI

So fügen Sie Kommunikation zu einem Fall hinzu

Im folgenden Beispiel für add-communication-to-case werden verschiedene Kommunikationen zu einem Supportfall in Ihrem AWS-Konto hinzugefügt.


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"

Ausgabe:


{
    "result": true
}

Weitere Informationen finden Sie unter Fallmanagement im AWS-Benutzerhandbuch.

API-Details finden Sie unter AddCommunicationToCase in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-case verwendet wird.

AWS CLI

So erstellen Sie einen Fall

Im folgenden Beispiel für create-case wird ein Supportfall für Ihr AWS-Konto erstellt.


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"

Ausgabe:


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

Weitere Informationen finden Sie unter Fallmanagement im AWS-Benutzerhandbuch.

API-Details finden Sie unter CreateCase in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-attachment verwendet wird.

AWS CLI

So beschreiben Sie einen Anhang

Das folgende Beispiel für describe-attachment gibt Informationen zum Anhang mit der angegebenen ID zurück.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Fallmanagement im AWS-Benutzerhandbuch.

API-Details finden Sie unter DescribeAttachment in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-cases verwendet wird.

AWS CLI

So beschreiben Sie einen Fall

Im folgenden Beispiel für describe-cases werden Informationen zum angegebenen Supportfall in Ihrem AWS-Konto zurückgegeben.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Fallmanagement im AWS-Benutzerhandbuch.

API-Details finden Sie unter DescribeCases in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-communications verwendet wird.

AWS CLI

So beschreiben Sie die neueste Kommunikation für einen Fall

Im folgenden Beispiel für describe-communications wird die neueste Kommunikation für den angegebenen Supportfall in Ihrem AWS-Konto zurückgegeben.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Fallmanagement im AWS-Benutzerhandbuch.

API-Details finden Sie unter DescribeCommunications in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-services verwendet wird.

AWS CLI

So listen Sie AWS-Services und Servicekategorien auf

Im folgenden Beispiel für describe-services werden die verfügbaren Servicekategorien für die Anforderung allgemeiner Informationen aufgelistet.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Fallmanagement im AWS-Benutzerhandbuch.

API-Details finden Sie unter DescribeServices in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-severity-levels verwendet wird.

AWS CLI

So listen Sie die verfügbaren Schweregrade auf

Im folgenden Beispiel für describe-severity-levels werden die verfügbaren Schweregrade für einen Supportfall aufgelistet.


aws support describe-severity-levels

Ausgabe:


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

Weitere Informationen finden Sie unter Auswählen eines Schweregrads im AWS-Benutzerhandbuch.

API-Details finden Sie unter DescribeSeverityLevels in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-trusted-advisor-check-refresh-statuses verwendet wird.

AWS CLI

So listen Sie den Aktualisierungsstatus von AWS-Trusted-Advisor-Prüfungen auf

Im folgenden Beispiel für describe-trusted-advisor-check-refresh-statuses wird der Aktualisierungsstatus für zwei Trusted-Advisor-Prüfungen aufgelistet: Amazon-S3-Bucket-Berechtigungen und Verwendung von IAM.


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

Ausgabe:


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

Weitere Informationen finden Sie unter AWS-Trusted Advisor im AWS-Benutzerhandbuch.

API-Details finden Sie unter DescribeTrustedAdvisorCheckRefreshStatuses in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-trusted-advisor-check-result verwendet wird.

AWS CLI

So listen Sie die Ergebnisse einer AWS-Trusted-Advisor-Prüfung auf

Im folgenden Beispiel für describe-trusted-advisor-check-result werden die Ergebnisse der IAM-Nutzungsprüfung aufgelistet.


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

Ausgabe:


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

Weitere Informationen finden Sie unter AWS-Trusted Advisor im AWS-Benutzerhandbuch.

API-Details finden Sie unter DescribeTrustedAdvisorCheckResult in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-trusted-advisor-check-summaries verwendet wird.

AWS CLI

So listen Sie die Zusammenfassungen der AWS-Trusted-Advisor-Prüfungen auf

Im folgenden Beispiel für describe-trusted-advisor-check-summaries werden die Ergebnisse von zwei Trusted-Advisor-Prüfungen aufgelistet: Amazon-S3-Bucket-Berechtigungen und Verwendung von IAM.


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

Ausgabe:


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

Weitere Informationen finden Sie unter AWS-Trusted Advisor im AWS-Benutzerhandbuch.

API-Details finden Sie unter DescribeTrustedAdvisorCheckSummaries in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-trusted-advisor-checks verwendet wird.

AWS CLI

So listen Sie die verfügbaren AWS-Trusted-Advisor-Prüfungen auf

Im folgenden Beispiel für describe-trusted-advisor-checks werden die verfügbaren Trusted-Advisor-Prüfungen in Ihrem AWS-Konto aufgelistet. Zu diesen Informationen gehören der Name, die ID, die Beschreibung, die Kategorie und die Metadaten der Prüfung. Beachten Sie, dass die Ausgabe aus Gründen der Lesbarkeit gekürzt ist.


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

Ausgabe:


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

Weitere Informationen finden Sie unter AWS-Trusted Advisor im AWS-Benutzerhandbuch.

API-Details finden Sie unter DescribeTrustedAdvisorChecks in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie refresh-trusted-advisor-check verwendet wird.

AWS CLI

So aktualisieren Sie eine AWS-Trusted-Advisor-Prüfung

Im folgenden Beispiel für refresh-trusted-advisor-check wird der Trusted-Advisor-Prüfung für Amazon-S3-Bucket-Berechtigungen in Ihrem AWS-Konto aktualisiert.


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

Ausgabe:


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

Weitere Informationen finden Sie unter AWS-Trusted Advisor im AWS-Benutzerhandbuch.

API-Details finden Sie unter RefreshTrustedAdvisorCheck in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie resolve-case verwendet wird.

AWS CLI

So lösen Sie einen Supportfall

Im folgenden Beispiel für resolve-case wird ein Supportfall in Ihrem AWS-Konto gelöst.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Fallmanagement im AWS-Benutzerhandbuch.

API-Details finden Sie unter ResolveCase in der AWS CLI-Befehlsreferenz.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

AWS STS

Amazon SWF