AWS CLI를 사용한 AWS Budgets 예제 - AWS Command Line Interface
작업

AWS CLI를 사용한 AWS Budgets 예제

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

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

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

주제

작업

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

AWS CLI

비용 및 사용량 예산을 생성하는 방법

다음 create-budget 명령은 비용 및 사용 예산을 생성합니다.

aws budgets create-budget \
    --account-id 111122223333 \
    --budget file://budget.json \
    --notifications-with-subscribers file://notifications-with-subscribers.json

budget.json의 콘텐츠:

{
    "BudgetLimit": {
        "Amount": "100",
        "Unit": "USD"
    },
    "BudgetName": "Example Tag Budget",
    "BudgetType": "COST",
    "CostFilters": {
        "TagKeyValue": [
            "user:Key$value1",
            "user:Key$value2"
        ]
    },
    "CostTypes": {
        "IncludeCredit": true,
        "IncludeDiscount": true,
        "IncludeOtherSubscription": true,
        "IncludeRecurring": true,
        "IncludeRefund": true,
        "IncludeSubscription": true,
        "IncludeSupport": true,
        "IncludeTax": true,
        "IncludeUpfront": true,
        "UseBlended": false
    },
    "TimePeriod": {
        "Start": 1477958399,
        "End": 3706473600
    },
    "TimeUnit": "MONTHLY"
}

notifications-with-subscribers.json의 콘텐츠:

[
    {
        "Notification": {
            "ComparisonOperator": "GREATER_THAN",
            "NotificationType": "ACTUAL",
            "Threshold": 80,
            "ThresholdType": "PERCENTAGE"
        },
        "Subscribers": [
            {
                "Address": "example@example.com",
                "SubscriptionType": "EMAIL"
            }
        ]
    }
]

  • API 세부 정보는 AWS CLI 명령 참조의 CreateBudget을 참조하세요.

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

AWS CLI

지정된 비용 및 사용량 예산에 대한 알림을 생성하는 방법

이 예제에서는 지정된 비용 및 사용량 예산에 대한 알림을 생성합니다.

명령:

aws budgets create-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com

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

AWS CLI

비용 및 사용량 예산과 연결된 알림에 대한 구독자를 생성하는 방법

이 예제에서는 지정된 알림에 대한 구독자를 생성합니다.

명령:

aws budgets create-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com

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

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

AWS CLI

비용 및 사용량 예산을 삭제하는 방법

이 예제에서는 지정된 비용 및 사용량 예산을 삭제합니다.

명령:

aws budgets delete-budget --account-id 111122223333 --budget-name "Example Budget"

  • API 세부 정보는 AWS CLI 명령 참조의 DeleteBudget을 참조하세요.

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

AWS CLI

예산에서 알림을 삭제하는 방법

이 예제에서는 지정된 예산에서 지정된 알림을 삭제합니다.

명령:

aws budgets delete-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE

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

AWS CLI

알림에서 구독자를 삭제하는 방법

이 예제에서는 지정된 알림에서 지정된 구독자를 삭제합니다.

명령:

aws budgets delete-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com

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

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

AWS CLI

계정과 연결된 예산을 검색하는 방법

이 예제에서는 지정된 비용 및 사용량 예산을 검색합니다.

명령:

aws budgets describe-budget --account-id 111122223333 --budget-name "Example Budget"

출력:

{
   "Budget": {
       "CalculatedSpend": {
           "ForecastedSpend": {
               "Amount": "2641.54800000000022919266484677791595458984375",
               "Unit": "USD"
           },
           "ActualSpend": {
               "Amount": "604.4560000000000172803993336856365203857421875",
               "Unit": "USD"
           }
       },
       "BudgetType": "COST",
       "BudgetLimit": {
           "Amount": "100",
           "Unit": "USD"
       },
       "BudgetName": "Example Budget",
       "CostTypes": {
           "IncludeOtherSubscription": true,
           "IncludeUpfront": true,
           "IncludeRefund": true,
           "UseBlended": false,
           "IncludeDiscount": true,
           "UseAmortized": false,
           "IncludeTax": true,
           "IncludeCredit": true,
           "IncludeSupport": true,
           "IncludeRecurring": true,
           "IncludeSubscription": true
       },
       "TimeUnit": "MONTHLY",
       "TimePeriod": {
           "Start": 1477958399.0,
           "End": 3706473600.0
       },
       "CostFilters": {
           "AZ": [
               "us-east-1"
           ]
       }
   }
}

  • API 세부 정보는 AWS CLI 명령 참조의 DescribeBudget을 참조하세요.

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

AWS CLI

계정과 연결된 예산들을 검색하는 방법

이 예제에서는 계정에 대한 비용 및 사용량 예산들을 검색합니다.

명령:

aws budgets describe-budgets --account-id 111122223333 --max-results 20

출력:

{
   "Budgets": [
       {
           "CalculatedSpend": {
               "ForecastedSpend": {
                   "Amount": "2641.54800000000022919266484677791595458984375",
                   "Unit": "USD"
               },
               "ActualSpend": {
                   "Amount": "604.4560000000000172803993336856365203857421875",
                   "Unit": "USD"
               }
           },
           "BudgetType": "COST",
           "BudgetLimit": {
               "Amount": "100",
               "Unit": "USD"
           },
           "BudgetName": "Example Budget",
           "CostTypes": {
               "IncludeOtherSubscription": true,
               "IncludeUpfront": true,
               "IncludeRefund": true,
               "UseBlended": false,
               "IncludeDiscount": true,
               "UseAmortized": false,
               "IncludeTax": true,
               "IncludeCredit": true,
               "IncludeSupport": true,
               "IncludeRecurring": true,
               "IncludeSubscription": true
           },
           "TimeUnit": "MONTHLY",
           "TimePeriod": {
               "Start": 1477958399.0,
               "End": 3706473600.0
           },
           "CostFilters": {
               "AZ": [
                   "us-east-1"
               ]
           }
       }
   ]
}

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

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

AWS CLI

예산에 대한 알림을 검색하는 방법

이 예제에서는 비용 및 사용량 예산에 대한 알림을 검색합니다.

명령:

aws budgets describe-notifications-for-budget --account-id 111122223333 --budget-name "Example Budget" --max-results 5

출력:

{
   "Notifications": [
       {
           "Threshold": 80.0,
           "ComparisonOperator": "GREATER_THAN",
           "NotificationType": "ACTUAL"
       }
   ]
}

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

AWS CLI

예산 알림에 대한 구독자를 검색하는 방법

이 예제에서는 비용 및 사용량 예산 알림에 대한 구독자를 검색합니다.

명령:

aws budgets describe-subscribers-for-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --max-results 5

출력:

{
   "Subscribers": [
       {
           "SubscriptionType": "EMAIL",
           "Address": "example2@example.com"
       },
       {
           "SubscriptionType": "EMAIL",
           "Address": "example@example.com"
       }
   ]
}

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

AWS CLI

비용 및 사용량 예산에 대한 예산을 교체하는 방법

이 예제에서는 비용 및 사용량 예산을 새 예산으로 교체합니다.

명령:

aws budgets update-budget --account-id 111122223333 --new-budget file://new-budget.json

new-budget.json:

{
    "BudgetLimit": {
       "Amount": "100",
       "Unit": "USD"
    },
    "BudgetName": "Example Budget",
    "BudgetType": "COST",
    "CostFilters": {
       "AZ" : [ "us-east-1" ]
    },
    "CostTypes": {
       "IncludeCredit": false,
       "IncludeDiscount": true,
       "IncludeOtherSubscription": true,
       "IncludeRecurring": true,
       "IncludeRefund": true,
       "IncludeSubscription": true,
       "IncludeSupport": true,
       "IncludeTax": true,
       "IncludeUpfront": true,
       "UseBlended": false,
       "UseAmortized": true
    },
    "TimePeriod": {
       "Start": 1477958399,
       "End": 3706473600
    },
    "TimeUnit": "MONTHLY"
 }

  • API 세부 정보는 AWS CLI 명령 참조의 UpdateBudget을 참조하세요.

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

AWS CLI

비용 및 사용량 예산에 대한 알림을 교체하는 방법

이 예제에서는 비용 및 사용량 예산에 대한 80% 알림을 90% 알림으로 교체합니다.

명령:

aws budgets update-notification --account-id 111122223333 --budget-name "Example Budget" --old-notification  NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --new-notification  NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=90,ThresholdType=PERCENTAGE

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

AWS CLI

비용 및 사용량 예산에 대한 구독자를 교체하는 방법

이 예제에서는 비용 및 사용량 예산에 대한 구독자를 교체합니다.

명령:

aws budgets update-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --old-subscriber SubscriptionType=EMAIL,Address=example@example.com --new-subscriber SubscriptionType=EMAIL,Address=example2@example.com

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