Spec-Zone.ru › AWS CLI v2

[ aws . budgets ]

update-budget

Описание

Обновляет бюджет. Вы можете изменить любую часть бюджета, кроме budgetName и calculatedSpend. При изменении бюджета calculatedSpend обнуляется до тех пор, пока Amazon Web Services не получит новые данные использования для прогнозирования.

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

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

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

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

Синопсис

  update-budget
--account-id <value>
--new-budget <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 (строка)

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

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

Бюджет, на который требуется обновить ваш бюджет.

BudgetName -> (строка)

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

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

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

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

Amount -> (строка)

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

Unit -> (строка)

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

PlannedBudgetLimits -> (карта)

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

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

Для ежемесячных бюджетов предоставьте значения PlannedBudgetLimits на 12 месяцев. Это должно начинаться с текущего месяца и включать следующие 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 -> (список)

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

(структура)

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

Or -> (список)

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

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

And -> (список)

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

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

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

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

Key -> (строка)

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

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

Key -> (строка)

Ключ метки.

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

Key -> (строка)

Уникальное имя категории затрат.

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

And -> (список)

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

(структура)

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

Or -> (список)

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

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

And -> (список)

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

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

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

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

Key -> (строка)

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

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

Key -> (строка)

Ключ метки.

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

Key -> (строка)

Уникальное имя категории затрат.

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

Or -> (список)

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

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

And -> (список)

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

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

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

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

Key -> (строка)

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

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

Key -> (строка)

Ключ метки.

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

Key -> (строка)

Уникальное имя категории затрат.

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

Key -> (строка)

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

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

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", ...]
}

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

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

Общие параметры

--debug (boolean)

Включить отладку.

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

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

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Отключить пагинатор CLI для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

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

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

Вывод

Нет

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

Spec-Zone.ru

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