Spec-Zone.ru › AWS CLI v2

[ aws . budgets ]

create-budget

Описание

Создает бюджет и, при необходимости, уведомления и подписчиков.

Предупреждение

В синтаксисе может присутствовать только один из BudgetLimit или PlannedBudgetLimits. Используйте синтаксис, соответствующий вашему случаю использования. Раздел Синтаксис запроса демонстрирует синтаксис BudgetLimit. Для PlannedBudgetLimits, см. раздел Примеры.

Аналогично, в синтаксисе может присутствовать только один набор фильтров и метрик. Либо FilterExpression и Metrics, либо CostFilters и CostTypes, но не оба одновременно или иная комбинация. Рекомендуется использовать FilterExpression и Metrics, так как они обеспечивают более гибкие и мощные возможности фильтрации. Раздел Синтаксис запроса демонстрирует синтаксис FilterExpression /Metrics.

См. также: AWS Документация API

Синтаксис

  create-budget
--account-id <value>
--budget <value>
[--notifications-with-subscribers <value>]
[--resource-tags <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--account-id (строка)

Ассоциированный с бюджетом accountId.

--budget (структура)

Объект бюджета, который вы хотите создать.

BudgetName -> (строка)

Название бюджета. Название должно быть уникальным в рамках учетной записи. В названии запрещены символы : и \, а также подстрока «/action/» в BudgetName.

BudgetLimit -> (структура)

Общая сумма затрат, использования, использования RI, покрытия RI, использования планов экономии или покрытия планов экономии, которую вы хотите отслеживать с помощью вашего бюджета.

BudgetLimit требуется для бюджетов затрат или использования, но необязательно для бюджетов использования или покрытия RI или планов экономии. Бюджеты использования или покрытия RI или планов экономии по умолчанию устанавливаются в 100. Это единственное допустимое значение для бюджетов использования или покрытия RI или планов экономии. Вы не можете использовать BudgetLimit с PlannedBudgetLimits для действий CreateBudget и UpdateBudget.

Amount -> (строка)

Сумма затрат или использования, связанная с прогнозом бюджета, фактическими расходами или порогом бюджета.

Unit -> (строка)

Единица измерения, используемая для прогноза бюджета, фактических расходов или порога бюджета.

PlannedBudgetLimits -> (карта)

Карта, содержащая несколько BudgetLimit, включая текущие или будущие лимиты.

PlannedBudgetLimits доступен для бюджетов затрат или использования и поддерживает как ежемесячные, так и квартальные TimeUnit.

Для ежемесячных бюджетов предоставьте значения на 12 месяцев PlannedBudgetLimits. Начало должно быть с текущего месяца и включать следующие 11 месяцев. key — это начало месяца, представленное UTC в секундах эпохи.

Для квартальных бюджетов предоставьте значения на четыре квартала PlannedBudgetLimits в стандартных квартальных интервалах календаря. Начало должно быть с текущего квартала и включать следующие три квартала. key — это начало квартала, представленное UTC в секундах эпохи.

Если срок действия планируемого бюджета истекает менее чем за 12 месяцев для ежемесячных бюджетов или за четыре квартала для квартальных, укажите значения PlannedBudgetLimits только для оставшихся периодов.

Если бюджет начинается в будущем, предоставьте значения PlannedBudgetLimits с даты начала бюджета.

После использования всех значений BudgetLimit в PlannedBudgetLimits бюджет продолжает использовать последний лимит как BudgetLimit. В этот момент планируемый бюджет предоставляет тот же опыт, что и фиксированный бюджет.

DescribeBudget и DescribeBudgets ответ вместе с PlannedBudgetLimits также содержат BudgetLimit, представляющие текущий месячный или квартальный лимит, присутствующий в PlannedBudgetLimits. Это относится только к бюджетам, созданным с использованием PlannedBudgetLimits. Бюджеты, созданные без PlannedBudgetLimits, содержат только BudgetLimit. Они не содержат PlannedBudgetLimits.

key -> (строка)

Общее строковое значение.

value -> (структура)

Сумма затрат или использования, измеренная для бюджета.

Пример затрат: Spend для 3 USD затрат имеет следующие параметры:
  • Amount из 3
  • Unit из USD
Пример использования: Spend для 3 GB использования S3 имеет следующие параметры:
  • Amount из 3
  • Unit из GB

Amount -> (строка)

Сумма затрат или использования, связанная с прогнозом бюджета, фактическими расходами или порогом бюджета.

Unit -> (строка)

Единица измерения, используемая для прогноза бюджета, фактических расходов или порога бюджета.

CostFilters -> (карта)

Фильтры затрат, такие как Region, Service, LinkedAccount, Tag или CostCategory, применяемые к бюджету.

Amazon Web Services Budgets поддерживает следующие сервисы в качестве фильтра Service для бюджетов RI:

  • Amazon EC2
  • Amazon Redshift
  • Amazon Relational Database Service
  • Amazon ElastiCache
  • Amazon OpenSearch Service

key -> (строка)

Общее строковое значение.

value -> (список)

(строка)

CostTypes -> (структура)

Типы затрат, включенные в этот бюджет COST.

Бюджеты USAGE, RI_UTILIZATION, RI_COVERAGE, SAVINGS_PLANS_UTILIZATION и SAVINGS_PLANS_COVERAGE не содержат CostTypes.

IncludeTax -> (булево)

Указывает, включает ли бюджет налоги.

Значение по умолчанию — true.

IncludeSubscription -> (булево)

Указывает, включает ли бюджет подписки.

Значение по умолчанию — true.

UseBlended -> (булево)

Указывает, использует ли бюджет смешанную ставку.

Значение по умолчанию — false.

IncludeRefund -> (булево)

Указывает, включает ли бюджет возвраты.

Значение по умолчанию — true.

IncludeCredit -> (булево)

Указывает, включает ли бюджет кредиты.

Значение по умолчанию — true.

IncludeUpfront -> (булево)

Указывает, включает ли бюджет первоначальные затраты RI.

Значение по умолчанию — true.

IncludeRecurring -> (булево)

Указывает, включает ли бюджет повторяющиеся платежи, такие как ежемесячные платежи за RI.

Значение по умолчанию — true.

IncludeOtherSubscription -> (булево)

Указывает, включает ли бюджет затраты на подписки, не связанные с RI.

Значение по умолчанию — true.

IncludeSupport -> (булево)

Указывает, включает ли бюджет платы за поддержку.

Значение по умолчанию — true.

IncludeDiscount -> (булево)

Указывает, включает ли бюджет скидки.

Значение по умолчанию — true.

UseAmortized -> (булево)

Указывает, использует ли бюджет амортизированную ставку.

Значение по умолчанию — false.

TimeUnit -> (строка)

Продолжительность времени, в течение которого бюджет сбрасывает фактические и прогнозируемые затраты.

TimePeriod -> (структура)

Период времени, охватываемый бюджетом. Вы задаете начальную и конечную даты. Начальная дата должна быть раньше конечной. Конечная дата должна быть раньше 06/15/87 00:00 UTC.

Если вы создали бюджет и не указали начальную дату, Amazon Web Services по умолчанию устанавливает начало выбранного периода (DAILY, MONTHLY, QUARTERLY или ANNUALLY). Например, если вы создали бюджет 24 января 2018 года, выбрали DAILY и не задали начальную дату, Amazon Web Services установили начальную дату на 01/24/18 00:00 UTC. Если вы выбрали MONTHLY, Amazon Web Services установили начальную дату на 01/01/18 00:00 UTC. Если вы не указали конечную дату, Amazon Web Services установили конечную дату на 06/15/87 00:00 UTC. Значения по умолчанию одинаковы для консоли Billing and Cost Management и API.

Вы можете изменить любую из дат с помощью операции UpdateBudget.

После конечной даты Amazon Web Services удаляет бюджет и все связанные уведомления и подписчиков.

Start -> (временная метка)

Дата начала бюджета. Если вы создали бюджет и не указали начальную дату, Amazon Web Services по умолчанию устанавливает начало выбранного периода (DAILY, MONTHLY, QUARTERLY или ANNUALLY). Например, если вы создали бюджет 24 января 2018 года, выбрали DAILY и не задали начальную дату, Amazon Web Services установили начальную дату на 01/24/18 00:00 UTC. Если вы выбрали MONTHLY, Amazon Web Services установили начальную дату на 01/01/18 00:00 UTC. Значения по умолчанию одинаковы для консоли Billing and Cost Management и API.

Вы можете изменить начальную дату с помощью операции UpdateBudget.

End -> (временная метка)

Дата окончания бюджета. Если вы не указали конечную дату, Amazon Web Services установили конечную дату на 06/15/87 00:00 UTC. Значения по умолчанию одинаковы для консоли Billing and Cost Management и API.

После конечной даты Amazon Web Services удаляет бюджет и все связанные уведомления и подписчиков. Вы можете изменить конечную дату с помощью операции UpdateBudget.

CalculatedSpend -> (структура)

Фактические и прогнозируемые затраты или использование, отслеживаемые бюджетом.

ActualSpend -> (структура)

Сумма затрат, использования, единиц RI или единиц планов экономии, которые вы использовали.

Amount -> (строка)

Сумма затрат или использования, связанная с прогнозом бюджета, фактическими расходами или порогом бюджета.

Unit -> (строка)

Единица измерения, используемая для прогноза бюджета, фактических расходов или порога бюджета.

ForecastedSpend -> (структура)

Сумма затрат, использования, единиц RI или единиц планов экономии, которые, как прогнозируется, вы будете использовать.

Amount -> (строка)

Сумма затрат или использования, связанная с прогнозом бюджета, фактическими расходами или порогом бюджета.

Unit -> (строка)

Единица измерения, используемая для прогноза бюджета, фактических расходов или порога бюджета.

BudgetType -> (строка)

Указывает, отслеживает ли этот бюджет затраты, использование, использование RI, покрытие RI, использование планов экономии или покрытие планов экономии.

LastUpdatedTime -> (временная метка)

Последнее время обновления этого бюджета.

AutoAdjustData -> (структура)

Параметры, определяющие сумму бюджета для автоматического регулирования.

AutoAdjustType -> (строка)

Строка, определяющая, регулируется ли ваш бюджет автоматически на основе исторических или прогнозируемых данных.

HistoricalOptions -> (структура)

Параметры, определяющие или описывающие исторические данные, на основе которых регулируется ваш бюджет.

BudgetAdjustmentPeriod -> (целое число)

Количество периодов бюджета, включенных в расчет скользящего среднего, который определяет сумму вашего автоматически отрегулированного бюджета. Максимальное значение зависит от гранулярности бюджета:

  • Для гранулярности DAILY максимальное значение равно 60.
  • Для гранулярности MONTHLY максимальное значение равно 12.
  • Для гранулярности QUARTERLY максимальное значение равно 4.
  • Для гранулярности ANNUALLY максимальное значение равно 1.

LookBackAvailablePeriods -> (целое число)

Целое число, описывающее количество периодов бюджета в вашем BudgetAdjustmentPeriod, включенных в расчет вашего текущего BudgetLimit. Если в первом периоде бюджета в вашем BudgetAdjustmentPeriod нет данных о расходах, то этот период не включается в среднее значение, определяющее ваш бюджетный лимит.

Например, если вы установили BudgetAdjustmentPeriod как 4 квартала, но в вашем аккаунте не было данных о расходах в первом квартале, то в расчет включаются только последние три квартала. В этом случае LookBackAvailablePeriods возвращает 3.

Вы не можете установить собственное значение LookBackAvailablePeriods. Значение автоматически рассчитывается на основе BudgetAdjustmentPeriod и ваших исторических данных о расходах.

LastAutoAdjustTime -> (отметка времени)

Последнее время автоматической корректировки вашего бюджета.

FilterExpression -> (структура)

Фильтровальные измерения для бюджета и их соответствующие значения.

Or -> (список)

Возвращает результаты, соответствующие любому объекту измерения.

(структура)

Используйте выражение для фильтрации в различных API бюджетов.

Or -> (список)

Возвращает результаты, соответствующие любому объекту измерения.

(… рекурсивно …)

And -> (список)

Возвращает результаты, соответствующие обоим объектам измерения.

(… рекурсивно …)

(… рекурсивно …)Dimensions -> (структура)

Конкретное измерение для использования в выражении.

Key -> (строка)

Название измерения, по которому вы хотите отфильтровать.

Values -> (список)

Значения метаданных, которые вы можете указать для фильтрации, так что результаты будут соответствовать хотя бы одному из указанных значений.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов. Вы можете указать только одно из этих значений в массиве.

(строка)

Tags -> (структура)

Конкретная метка для использования в выражении.

Key -> (строка)

Ключ для метки.

Values -> (список)

Конкретное значение метки.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов.

(строка)

CostCategories -> (структура)

Фильтр, основанный на CostCategoryValues.

Key -> (строка)

Уникальное имя категории расходов.

Values -> (список)

Конкретное значение категории расходов.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов.

(строка)

And -> (список)

Возвращает результаты, соответствующие обоим объектам измерения.

(структура)

Используйте выражение для фильтрации в различных API бюджетов.

Or -> (список)

Возвращает результаты, соответствующие любому объекту измерения.

(… рекурсивно …)

And -> (список)

Возвращает результаты, соответствующие обоим объектам измерения.

(… рекурсивно …)

(… рекурсивно …)Dimensions -> (структура)

Конкретное измерение для использования в выражении.

Key -> (строка)

Название измерения, по которому вы хотите отфильтровать.

Values -> (список)

Значения метаданных, которые вы можете указать для фильтрации, так что результаты будут соответствовать хотя бы одному из указанных значений.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов. Вы можете указать только одно из этих значений в массиве.

(строка)

Tags -> (структура)

Конкретная метка для использования в выражении.

Key -> (строка)

Ключ для метки.

Values -> (список)

Конкретное значение метки.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов.

(строка)

CostCategories -> (структура)

Фильтр, основанный на CostCategoryValues.

Key -> (строка)

Уникальное имя категории расходов.

Values -> (список)

Конкретное значение категории расходов.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов.

(строка)

Not -> (структура)

Возвращает результаты, не соответствующие объекту измерения.

Or -> (список)

Возвращает результаты, соответствующие любому объекту измерения.

(… рекурсивно …)

And -> (список)

Возвращает результаты, соответствующие обоим объектам измерения.

(… рекурсивно …)

(… рекурсивно …)Dimensions -> (структура)

Конкретное измерение для использования в выражении.

Key -> (строка)

Название измерения, по которому вы хотите отфильтровать.

Values -> (список)

Значения метаданных, которые вы можете указать для фильтрации, так что результаты будут соответствовать хотя бы одному из указанных значений.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов. Вы можете указать только одно из этих значений в массиве.

(строка)

Tags -> (структура)

Конкретная метка для использования в выражении.

Key -> (строка)

Ключ для метки.

Values -> (список)

Конкретное значение метки.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов.

(строка)

CostCategories -> (структура)

Фильтр, основанный на CostCategoryValues.

Key -> (строка)

Уникальное имя категории расходов.

Values -> (список)

Конкретное значение категории расходов.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов.

(строка)

Dimensions -> (структура)

Конкретное измерение для использования в выражении.

Key -> (строка)

Название измерения, по которому вы хотите отфильтровать.

Values -> (список)

Значения метаданных, которые вы можете указать для фильтрации, так что результаты будут соответствовать хотя бы одному из указанных значений.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов. Вы можете указать только одно из этих значений в массиве.

(строка)

Tags -> (структура)

Конкретная метка для использования в выражении.

Key -> (строка)

Ключ для метки.

Values -> (список)

Конкретное значение метки.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов.

(строка)

CostCategories -> (структура)

Фильтр, основанный на CostCategoryValues.

Key -> (строка)

Уникальное имя категории расходов.

Values -> (список)

Конкретное значение категории расходов.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые вы можете использовать для фильтрации результатов.

(строка)

Metrics -> (список)

Определение того, как агрегируются данные бюджета.

(строка)

JSON Синтаксис:

{
  "BudgetName": "string",
  "BudgetLimit": {
    "Amount": "string",
    "Unit": "string"
  },
  "PlannedBudgetLimits": {"string": {
        "Amount": "string",
        "Unit": "string"
      }
    ...},
  "CostFilters": {"string": ["string", ...]
    ...},
  "CostTypes": {
    "IncludeTax": true|false,
    "IncludeSubscription": true|false,
    "UseBlended": true|false,
    "IncludeRefund": true|false,
    "IncludeCredit": true|false,
    "IncludeUpfront": true|false,
    "IncludeRecurring": true|false,
    "IncludeOtherSubscription": true|false,
    "IncludeSupport": true|false,
    "IncludeDiscount": true|false,
    "UseAmortized": true|false
  },
  "TimeUnit": "DAILY"|"MONTHLY"|"QUARTERLY"|"ANNUALLY",
  "TimePeriod": {
    "Start": timestamp,
    "End": timestamp
  },
  "CalculatedSpend": {
    "ActualSpend": {
      "Amount": "string",
      "Unit": "string"
    },
    "ForecastedSpend": {
      "Amount": "string",
      "Unit": "string"
    }
  },
  "BudgetType": "USAGE"|"COST"|"RI_UTILIZATION"|"RI_COVERAGE"|"SAVINGS_PLANS_UTILIZATION"|"SAVINGS_PLANS_COVERAGE",
  "LastUpdatedTime": timestamp,
  "AutoAdjustData": {
    "AutoAdjustType": "HISTORICAL"|"FORECAST",
    "HistoricalOptions": {
      "BudgetAdjustmentPeriod": integer,
      "LookBackAvailablePeriods": integer
    },
    "LastAutoAdjustTime": timestamp
  },
  "FilterExpression": {
    "Or": [
      {
        "Or": [
          { ... recursive ... }
          ...
        ],
        "And": [
          { ... recursive ... }
          ...
        ],
        "Not": { ... recursive ... },
        "Dimensions": {
          "Key": "AZ"|"INSTANCE_TYPE"|"LINKED_ACCOUNT"|"LINKED_ACCOUNT_NAME"|"OPERATION"|"PURCHASE_TYPE"|"REGION"|"SERVICE"|"SERVICE_CODE"|"USAGE_TYPE"|"USAGE_TYPE_GROUP"|"RECORD_TYPE"|"OPERATING_SYSTEM"|"TENANCY"|"SCOPE"|"PLATFORM"|"SUBSCRIPTION_ID"|"LEGAL_ENTITY_NAME"|"INVOICING_ENTITY"|"DEPLOYMENT_OPTION"|"DATABASE_ENGINE"|"CACHE_ENGINE"|"INSTANCE_TYPE_FAMILY"|"BILLING_ENTITY"|"RESERVATION_ID"|"RESOURCE_ID"|"RIGHTSIZING_TYPE"|"SAVINGS_PLANS_TYPE"|"SAVINGS_PLAN_ARN"|"PAYMENT_OPTION"|"RESERVATION_MODIFIED"|"TAG_KEY"|"COST_CATEGORY_NAME",
          "Values": ["string", ...],
          "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
        },
        "Tags": {
          "Key": "string",
          "Values": ["string", ...],
          "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
        },
        "CostCategories": {
          "Key": "string",
          "Values": ["string", ...],
          "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
        }
      }
      ...
    ],
    "And": [
      {
        "Or": [
          { ... recursive ... }
          ...
        ],
        "And": [
          { ... recursive ... }
          ...
        ],
        "Not": { ... recursive ... },
        "Dimensions": {
          "Key": "AZ"|"INSTANCE_TYPE"|"LINKED_ACCOUNT"|"LINKED_ACCOUNT_NAME"|"OPERATION"|"PURCHASE_TYPE"|"REGION"|"SERVICE"|"SERVICE_CODE"|"USAGE_TYPE"|"USAGE_TYPE_GROUP"|"RECORD_TYPE"|"OPERATING_SYSTEM"|"TENANCY"|"SCOPE"|"PLATFORM"|"SUBSCRIPTION_ID"|"LEGAL_ENTITY_NAME"|"INVOICING_ENTITY"|"DEPLOYMENT_OPTION"|"DATABASE_ENGINE"|"CACHE_ENGINE"|"INSTANCE_TYPE_FAMILY"|"BILLING_ENTITY"|"RESERVATION_ID"|"RESOURCE_ID"|"RIGHTSIZING_TYPE"|"SAVINGS_PLANS_TYPE"|"SAVINGS_PLAN_ARN"|"PAYMENT_OPTION"|"RESERVATION_MODIFIED"|"TAG_KEY"|"COST_CATEGORY_NAME",
          "Values": ["string", ...],
          "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
        },
        "Tags": {
          "Key": "string",
          "Values": ["string", ...],
          "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
        },
        "CostCategories": {
          "Key": "string",
          "Values": ["string", ...],
          "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
        }
      }
      ...
    ],
    "Not": {
      "Or": [
        { ... recursive ... }
        ...
      ],
      "And": [
        { ... recursive ... }
        ...
      ],
      "Not": { ... recursive ... },
      "Dimensions": {
        "Key": "AZ"|"INSTANCE_TYPE"|"LINKED_ACCOUNT"|"LINKED_ACCOUNT_NAME"|"OPERATION"|"PURCHASE_TYPE"|"REGION"|"SERVICE"|"SERVICE_CODE"|"USAGE_TYPE"|"USAGE_TYPE_GROUP"|"RECORD_TYPE"|"OPERATING_SYSTEM"|"TENANCY"|"SCOPE"|"PLATFORM"|"SUBSCRIPTION_ID"|"LEGAL_ENTITY_NAME"|"INVOICING_ENTITY"|"DEPLOYMENT_OPTION"|"DATABASE_ENGINE"|"CACHE_ENGINE"|"INSTANCE_TYPE_FAMILY"|"BILLING_ENTITY"|"RESERVATION_ID"|"RESOURCE_ID"|"RIGHTSIZING_TYPE"|"SAVINGS_PLANS_TYPE"|"SAVINGS_PLAN_ARN"|"PAYMENT_OPTION"|"RESERVATION_MODIFIED"|"TAG_KEY"|"COST_CATEGORY_NAME",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
      },
      "Tags": {
        "Key": "string",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
      },
      "CostCategories": {
        "Key": "string",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
      }
    },
    "Dimensions": {
      "Key": "AZ"|"INSTANCE_TYPE"|"LINKED_ACCOUNT"|"LINKED_ACCOUNT_NAME"|"OPERATION"|"PURCHASE_TYPE"|"REGION"|"SERVICE"|"SERVICE_CODE"|"USAGE_TYPE"|"USAGE_TYPE_GROUP"|"RECORD_TYPE"|"OPERATING_SYSTEM"|"TENANCY"|"SCOPE"|"PLATFORM"|"SUBSCRIPTION_ID"|"LEGAL_ENTITY_NAME"|"INVOICING_ENTITY"|"DEPLOYMENT_OPTION"|"DATABASE_ENGINE"|"CACHE_ENGINE"|"INSTANCE_TYPE_FAMILY"|"BILLING_ENTITY"|"RESERVATION_ID"|"RESOURCE_ID"|"RIGHTSIZING_TYPE"|"SAVINGS_PLANS_TYPE"|"SAVINGS_PLAN_ARN"|"PAYMENT_OPTION"|"RESERVATION_MODIFIED"|"TAG_KEY"|"COST_CATEGORY_NAME",
      "Values": ["string", ...],
      "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
    },
    "Tags": {
      "Key": "string",
      "Values": ["string", ...],
      "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
    },
    "CostCategories": {
      "Key": "string",
      "Values": ["string", ...],
      "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"GREATER_THAN_OR_EQUAL"|"CASE_SENSITIVE"|"CASE_INSENSITIVE", ...]
    }
  },
  "Metrics": ["BlendedCost"|"UnblendedCost"|"AmortizedCost"|"NetUnblendedCost"|"NetAmortizedCost"|"UsageQuantity"|"NormalizedUsageAmount"|"Hours", ...]
}

--notifications-with-subscribers (список)

Уведомление, которое вы хотите связать с бюджетом. Бюджет может иметь до пяти уведомлений, а каждое уведомление может иметь одного подписчика SNS и до 10 подписчиков по электронной почте. Если вы включите уведомления и подписчиков в свой CreateBudget вызов, Amazon Web Services создаст для вас уведомления и подписчиков.

(структура)

Уведомление с подписчиками. Уведомление может иметь одного подписчика SNS и до 10 подписчиков по электронной почте, всего 11 подписчиков.

Уведомление -> (структура)

Уведомление, связанное с бюджетом.

ТипУведомления -> (строка)

Указывает, является ли уведомление о потраченных средствах (ACTUAL) или о прогнозируемых расходах (FORECASTED).

ОператорСравнения -> (строка)

Сравнение, используемое для этого уведомления.

Порог -> (двойное)

Порог, связанный с уведомлением. Пороги всегда выражены в процентах, и многие клиенты считают полезным получать уведомления при превышении 50% - 200% от запланированной суммы. Максимальное значение порога составляет 1 000 000% выше запланированной суммы.

ТипПорога -> (строка)

Тип порога для уведомления. Для порогов ABSOLUTE_VALUE Amazon Web Services уведомляет вас, когда вы превышаете или прогнозируется превышение общего порога затрат. Для порогов PERCENTAGE Amazon Web Services уведомляет вас, когда вы превышаете или прогнозируется превышение определенного процента от прогнозируемых расходов. Например, если у вас бюджет на 200 долларов и у вас порог PERCENTAGE 80%, Amazon Web Services уведомляет вас, когда вы превышаете 160 долларов.

СостояниеУведомления -> (строка)

Указывает, находится ли это уведомление в состоянии тревоги. Если уведомление о бюджете находится в состоянии ALARM, вы превысили установленный порог для бюджета.

Подписчики -> (список)

Список подписчиков, подписанных на это уведомление.

(структура)

Подписчик уведомления о бюджете. Подписчик состоит из типа подписки и либо темы Amazon SNS, либо адреса электронной почты.

Например, подписчик по электронной почте имеет следующие параметры:

  • Тип subscriptionType EMAIL
  • Адрес address example@example.com

ТипПодписки -> (строка)

Тип уведомления, которое Amazon Web Services отправляет подписчику.

Адрес -> (строка)

Адрес, которому Amazon Web Services отправляет уведомления о бюджете, либо тема SNS, либо электронная почта.

При создании подписчика значение Address не должно содержать символов перевода строки.

Сокращенная синтаксическая запись:

Notification={NotificationType=string,ComparisonOperator=string,Threshold=double,ThresholdType=string,NotificationState=string},Subscribers=[{SubscriptionType=string,Address=string},{SubscriptionType=string,Address=string}] ...

Синтаксис JSON:

[
  {
    "Notification": {
      "NotificationType": "ACTUAL"|"FORECASTED",
      "ComparisonOperator": "GREATER_THAN"|"LESS_THAN"|"EQUAL_TO",
      "Threshold": double,
      "ThresholdType": "PERCENTAGE"|"ABSOLUTE_VALUE",
      "NotificationState": "OK"|"ALARM"
    },
    "Subscribers": [
      {
        "SubscriptionType": "SNS"|"EMAIL",
        "Address": "string"
      }
      ...
    ]
  }
  ...
]

--resource-tags (список)

Необязательный список тегов для привязки к указанному бюджету. Каждый тег состоит из ключа и значения, а каждый ключ должен быть уникальным для ресурса.

(структура)

Структура тега, содержащая ключ и значение тега.

Ключ -> (строка)

Ключ, связанный с тегом.

Значение -> (строка)

Значение, связанное с тегом.

Сокращенная синтаксическая запись:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределяют значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с использованием значения, предоставленного JSON, поскольку строка будет интерпретироваться буквально. Это может не быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено без значения или значение input, выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое)

Включить отладочную запись.

--endpoint-url (строка)

Переопределить стандартный URL команды на указанный URL.

--no-verify-ssl (логическое)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.

--no-paginate (логическое)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

  • json
  • text
  • таблица
  • yaml
  • yaml-поток

--query (строка)

Запрос JMESPath для использования при фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • вкл
  • выкл
  • авто

--no-sign-request (логическое)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл сертификатов CA для использования при проверке сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут представлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, а двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет рассматриваться как двоичный и использовать содержимое файла непосредственно независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (логическое)

Автоматически запрашивать параметры входных данных CLI.

--no-cli-auto-prompt (логическое)

Отключить автоматическое запроса параметров входных данных CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, похожие на Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя 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"
            }
        ]
    }
]

Вывод

Нет

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API