AWS Support 사용 예제 AWS CLI - AWS Command Line Interface
작업

이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS Support 사용 예제 AWS CLI

다음 코드 예제에서는 AWS Command Line Interface 와 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다 AWS Support.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

다음 코드 예시에서는 add-attachments-to-set을 사용하는 방법을 보여 줍니다.

AWS CLI

세트에 첨부 파일을 추가하려면

다음 add-attachments-to-set 예제에서는 AWS 계정의 지원 사례에 대해 지정할 수 있는 이미지를 세트에 추가합니다.

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

출력:

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

자세한 내용은 AWS Support 사용 설명서의 사례 관리를 참조하세요.

  • 자세한 API 내용은 명령 참조AddAttachmentsToSet의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 add-communication-to-case을 사용하는 방법을 보여 줍니다.

AWS CLI

사례에 통신을 추가하려면

다음 add-communication-to-case 예제에서는 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"

출력:

{
    "result": true
}

자세한 내용은 AWS Support 사용 설명서의 사례 관리를 참조하세요.

다음 코드 예시에서는 create-case을 사용하는 방법을 보여 줍니다.

AWS CLI

사례를 생성하는 방법

다음 create-case 예제에서는 AWS 계정에 대한 지원 사례를 생성합니다.

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"

출력:

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

자세한 내용은 AWS Support 사용 설명서의 사례 관리를 참조하세요.

  • 자세한 API 내용은 명령 참조CreateCase의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-attachment을 사용하는 방법을 보여 줍니다.

AWS CLI

첨부 파일을 설명하는 방법

다음 describe-attachment 예시에서는 지정된 ID를 가진 첨부 파일에 대한 정보를 반환합니다.

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

출력:

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

자세한 내용은 AWS Support 사용 설명서의 사례 관리를 참조하세요.

  • 자세한 API 내용은 명령 참조DescribeAttachment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-cases을 사용하는 방법을 보여 줍니다.

AWS CLI

사례를 설명하는 방법

다음 describe-cases 예제에서는 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

출력:

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

자세한 내용은 AWS Support 사용 설명서의 사례 관리를 참조하세요.

  • 자세한 API 내용은 명령 참조DescribeCases의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-communications을 사용하는 방법을 보여 줍니다.

AWS CLI

사례에 대한 최신 커뮤니케이션을 설명하는 방법

다음 describe-communications 예제는 AWS 계정에서 지정된 지원 사례에 대한 최신 통신을 반환합니다.

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

출력:

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

자세한 내용은 AWS Support 사용 설명서의 사례 관리를 참조하세요.

다음 코드 예시에서는 describe-services을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS 서비스 및 서비스 범주를 나열하려면

다음 describe-services 예시에서는 일반 정보를 요청하는 데 사용할 수 있는 서비스 범주를 나열합니다.

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

출력:

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

자세한 내용은 AWS Support 사용 설명서의 사례 관리를 참조하세요.

  • 자세한 API 내용은 명령 참조DescribeServices의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-severity-levels을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 심각도 수준을 나열하는 방법

다음 describe-severity-levels 예시에서는 지원 사례에 사용할 수 있는 심각도 수준을 나열합니다.

aws support describe-severity-levels

출력:

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

자세한 내용은 AWS Support 사용 설명서의 심각도 선택을 참조하세요.

다음 코드 예시에서는 describe-trusted-advisor-check-refresh-statuses을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS Trusted Advisor 검사의 새로 고침 상태를 나열하려면

다음 describe-trusted-advisor-check-refresh-statuses 예제에서는 Amazon S3 버킷 권한 및 IAM 사용이라는 두 가지 Trusted Advisor 확인에 대한 새로 고침 상태를 나열합니다.

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

출력:

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

자세한 내용은 AWS 지원 사용 설명서의 AWS Trusted Advisor를 참조하세요.

다음 코드 예시에서는 describe-trusted-advisor-check-result을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS Trusted Advisor 검사 결과를 나열하려면

다음 describe-trusted-advisor-check-result 예제에서는 IAM 사용 확인의 결과를 나열합니다.

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

출력:

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

자세한 내용은 AWS 지원 사용 설명서의 AWS Trusted Advisor를 참조하세요.

다음 코드 예시에서는 describe-trusted-advisor-check-summaries을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS Trusted Advisor 검사 요약을 나열하려면

다음 describe-trusted-advisor-check-summaries 예제에서는 Amazon S3 버킷 권한 및 IAM 사용이라는 두 가지 Trusted Advisor 확인에 대한 결과를 나열합니다.

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

출력:

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

자세한 내용은 AWS 지원 사용 설명서의 AWS Trusted Advisor를 참조하세요.

다음 코드 예시에서는 describe-trusted-advisor-checks을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 AWS Trusted Advisor 검사를 나열하려면

다음 describe-trusted-advisor-checks 예제에서는 AWS 계정에서 사용 가능한 Trusted Advisor 검사를 나열합니다. 이 정보에는 수표 이름, ID, 설명, 범주 및 메타데이터가 포함됩니다. 가독성을 위해 출력이 단축됩니다.

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

출력:

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

자세한 내용은 AWS 지원 사용 설명서의 AWS Trusted Advisor를 참조하세요.

다음 코드 예시에서는 refresh-trusted-advisor-check을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS Trusted Advisor 확인을 새로 고치려면

다음 refresh-trusted-advisor-check 예제에서는 AWS 계정의 Amazon S3 버킷 권한 Trusted Advisor 확인을 새로 고칩니다.

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

출력:

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

자세한 내용은 AWS 지원 사용 설명서의 AWS Trusted Advisor를 참조하세요.

다음 코드 예시에서는 resolve-case을 사용하는 방법을 보여 줍니다.

AWS CLI

지원 사례를 해결하는 방법

다음 resolve-case 예제에서는 AWS 계정의 지원 사례를 해결합니다.

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

출력:

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

자세한 내용은 AWS Support 사용 설명서의 사례 관리를 참조하세요.

  • 자세한 API 내용은 명령 참조ResolveCase의 섹션을 참조하세요. AWS CLI