AWS CLI를 사용한 지원 예제

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

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

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

주제

작업

작업

다음 코드 예제에서는 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 세부 정보는 AWS CLI API 참조의 AddAttachmentsToSet 섹션을 참조하세요.

다음 코드 예제에서는 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 사용 설명서의 사례 관리를 참조하세요.

API 세부 정보는 AWS CLI API 참조의 AddCommunicationToCase 섹션을 참조하세요.

다음 코드 예제에서는 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 세부 정보는 AWS CLI 명령 참조의 CreateCase를 참조하세요.

다음 코드 예제에서는 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 세부 정보는 AWS CLI 명령 참조의 DescribeAttachment를 참조하세요.

다음 코드 예제에서는 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 세부 정보는 AWS CLI 명령 참조의 DescribeCases를 참조하세요.

다음 코드 예제에서는 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 사용 설명서의 사례 관리를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 DescribeCommunications를 참조하세요.

다음 코드 예제에서는 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 세부 정보는 AWS CLI 명령 참조의 DescribeServices를 참조하세요.

다음 코드 예제에서는 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 사용 설명서의 심각도 선택을 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 DescribeSeverityLevels를 참조하세요.

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

AWS CLI

AWS Trusted Advisor 검사의 새로 고침 상태를 나열하는 방법

다음 describe-trusted-advisor-check-refresh-statuses 예제에서는 두 개의 Trusted Advisor 검사(Amazon S3 버킷 권한 및 IAM 사용)에 대한 새로 고침 상태를 나열합니다.


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 Support 사용 설명서의 AWS Trusted Advisor를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 DescribeTrustedAdvisorCheckRefreshStatuses 섹션을 참조하세요.

다음 코드 예제에서는 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 Support 사용 설명서의 AWS Trusted Advisor를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 DescribeTrustedAdvisorCheckResult 섹션을 참조하세요.

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

AWS CLI

AWS Trusted Advisor 검사 요약을 나열하는 방법

다음 describe-trusted-advisor-check-summaries 예제에서는 두 개의 Trusted Advisor 검사(Amazon S3 버킷 권한 및 IAM 사용)에 대한 결과를 나열합니다.


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 Support 사용 설명서의 AWS Trusted Advisor를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 DescribeTrustedAdvisorCheckSummaries 섹션을 참조하세요.

다음 코드 예제에서는 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 Support 사용 설명서의 AWS Trusted Advisor를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 DescribeTrustedAdvisorChecks 섹션을 참조하세요.

다음 코드 예제에서는 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 Support 사용 설명서의 AWS Trusted Advisor를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 RefreshTrustedAdvisorCheck 섹션을 참조하세요.

다음 코드 예제에서는 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 세부 정보는 AWS CLI 명령 참조의 ResolveCase를 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

AWS STS

Amazon SWF