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

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

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

AWS Budgets 사용 예제 AWS CLI

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

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

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

주제

작업

다음 코드 예시에서는 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 내용은 명령 참조CreateBudget의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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

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

다음 코드 예시에서는 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 내용은 명령 참조CreateSubscriber의 섹션을 참조하세요. AWS CLI

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

AWS CLI

비용 및 사용 예산을 삭제하려면

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

명령:

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

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

다음 코드 예시에서는 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

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

다음 코드 예시에서는 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 내용은 명령 참조DeleteSubscriber의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조DescribeBudget의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조DescribeBudgets의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조UpdateBudget의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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

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

다음 코드 예시에서는 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 내용은 명령 참조UpdateSubscriber의 섹션을 참조하세요. AWS CLI