

Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples) 

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

# AWS Budgets 를 사용한 예제 AWS CLI
<a name="cli_2_budgets_code_examples"></a>

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

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

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

**Topics**
+ [작업](#actions)

## 작업
<a name="actions"></a>

### `create-budget`
<a name="budgets_CreateBudget_cli_2_topic"></a>

다음 코드 예시는 `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-budget.html)을 참조하세요.

### `create-notification`
<a name="budgets_CreateNotification_cli_2_topic"></a>

다음 코드 예시는 `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 세부 정보는 *AWS CLI 명령 참조*의[CreateNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-notification.html)을 참조하세요.

### `create-subscriber`
<a name="budgets_CreateSubscriber_cli_2_topic"></a>

다음 코드 예시는 `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-subscriber.html)를 참조하세요.

### `delete-budget`
<a name="budgets_DeleteBudget_cli_2_topic"></a>

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

**AWS CLI**  
**비용 및 사용량 예산을 삭제하는 방법**  
이 예제에서는 지정된 비용 및 사용량 예산을 삭제합니다.  
명령:  

```
aws budgets delete-budget --account-id 111122223333 --budget-name "Example Budget"
```
+  API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-budget.html)을 참조하세요.

### `delete-notification`
<a name="budgets_DeleteNotification_cli_2_topic"></a>

다음 코드 예시는 `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 세부 정보는 *AWS CLI 명령 참조*의 [DeleteNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-notification.html)을 참조하세요.

### `delete-subscriber`
<a name="budgets_DeleteSubscriber_cli_2_topic"></a>

다음 코드 예시는 `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-subscriber.html)를 참조하세요.

### `describe-budget`
<a name="budgets_DescribeBudget_cli_2_topic"></a>

다음 코드 예시는 `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-budget.html)을 참조하세요.

### `describe-budgets`
<a name="budgets_DescribeBudgets_cli_2_topic"></a>

다음 코드 예시는 `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-budgets.html)를 참조하세요.

### `describe-notifications-for-budget`
<a name="budgets_DescribeNotificationsForBudget_cli_2_topic"></a>

다음 코드 예시는 `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"
       }
   ]
}
```
+  API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeNotificationsForBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-notifications-for-budget.html)을 참조하세요.

### `describe-subscribers-for-notification`
<a name="budgets_DescribeSubscribersForNotification_cli_2_topic"></a>

다음 코드 예시는 `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"
       }
   ]
}
```
+  API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeSubscribersForNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-subscribers-for-notification.html)을 참조하세요.

### `update-budget`
<a name="budgets_UpdateBudget_cli_2_topic"></a>

다음 코드 예시는 `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-budget.html)을 참조하세요.

### `update-notification`
<a name="budgets_UpdateNotification_cli_2_topic"></a>

다음 코드 예시는 `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 세부 정보는 *AWS CLI 명령 참조*의 [UpdateNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-notification.html)을 참조하세요.

### `update-subscriber`
<a name="budgets_UpdateSubscriber_cli_2_topic"></a>

다음 코드 예시는 `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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-subscriber.html)를 참조하세요.