Spec-Zone.ru › AWS CLI v2

[ aws . ce ]

Получение использования планов экономии

Описание

Получает использование планов экономии для вашей учетной записи в диапазонах дат с ежедневной или ежемесячной детализацией. Учетные записи управления в организации имеют доступ к учетным записям участников. Вы можете использовать GetDimensionValues в SAVINGS_PLANS для определения возможных значений измерений.

Примечание

Вы не можете группировать по каким-либо значениям измерений для GetSavingsPlansUtilization .

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

Синтаксис

  get-savings-plans-utilization
--time-period <value>
[--granularity <value>]
[--filter <value>]
[--sort-by <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]

Параметры

--time-period (структура)

Период времени, для которого требуется информация об использовании и затратах. Дата Start должна быть в пределах 13 месяцев. Дата End должна быть после даты Start и до текущей даты. Будущие даты не могут использоваться в качестве даты End .

Start -> (строка)

Начало периода времени. Дата начала включительно. Например, если start равна 2017-01-01, Amazon Web Services извлекает данные о затратах и использовании, начиная с 2017-01-01 и до даты окончания. Дата начала должна быть равна или раньше текущей даты, чтобы избежать ошибки валидации.

End -> (строка)

Конец периода времени. Дата окончания не включительно. Например, если end равна 2017-05-01, Amazon Web Services извлекает данные о затратах и использовании с даты начала до, но не включая, 2017-05-01 .

Сокращенный синтаксис:

Start=string,End=string

Синтаксис JSON:

{
  "Start": "string",
  "End": "string"
}

--granularity (строка)

Детализация данных об использовании Amazon Web Services для ваших планов экономии.

Операция GetSavingsPlansUtilization поддерживает только DAILY и MONTHLY детализации.

Возможные значения:

  • DAILY
  • MONTHLY
  • HOURLY

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

Фильтры данных о покрытии использования планов экономии для активных измерений планов экономии. Вы можете фильтровать данные с помощью следующих измерений:

  • LINKED_ACCOUNT
  • SAVINGS_PLAN_ARN
  • SAVINGS_PLANS_TYPE
  • REGION
  • PAYMENT_OPTION
  • INSTANCE_TYPE_FAMILY
GetSavingsPlansUtilization использует тот же объект Expression, что и другие операции, но среди каждого измерения поддерживается только AND .

Или -> (список)

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

(структура)

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

Не все типы Expression поддерживаются в каждом API. Обратитесь к документации для каждого конкретного API, чтобы увидеть, что поддерживается.

Существует два шаблона:

  • Простые значения измерений.
    • Существует три типа простых значений измерений: CostCategories, Tags и Dimensions.
      • Укажите поле CostCategories, чтобы определить фильтр, который действует на категории затрат.
      • Укажите поле Tags, чтобы определить фильтр, который действует на теги распределения затрат.
      • Укажите поле Dimensions, чтобы определить фильтр, который действует на ` DimensionValues https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html`__.
    • Для каждого типа фильтра вы можете задать имя и значения измерения для фильтров, которые вы планируете использовать.
      • Например, вы можете отфильтровать по REGION==us-east-1 OR REGION==us-west-1. Для GetRightsizingRecommendation регион — это полное имя (например, REGION==US East (N. Virginia)).
      • Соответствующее Expression для этого примера таково: { "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] } }
      • Как показано в предыдущем примере, списки значений измерений объединяются с помощью OR при применении фильтра.
    • Вы также можете задать различные параметры соответствия для дальнейшего управления поведением фильтра. Не все API поддерживают параметры соответствия. Обратитесь к документации для каждого конкретного API, чтобы увидеть, что поддерживается.
      • Например, вы можете отфильтровать имена учетных записей, связанных с учетными записями, начинающимися с «a».
      • Соответствующее Expression для этого примера таково: { "Dimensions": { "Key": "LINKED_ACCOUNT_NAME", "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] } }
  • Составные типы Expression с логическими операциями.
    • Вы можете использовать несколько типов Expression и логические операторы AND/OR/NOT для создания списка одного или нескольких объектов Expression. С помощью этого вы можете фильтровать по более сложным параметрам.
    • Например, вы можете фильтровать по ((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer).
    • Соответствующее Expression для этого примера таково: { "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] }

Примечание

Поскольку каждый Expression может иметь только один оператор, служба возвращает ошибку, если указано более одного. Следующий пример показывает объект Expression, который создает ошибку: { "And": [ ... ], "Dimensions": { "Key": "USAGE_TYPE", "Values": [ "DataTransfer" ] } }

Следующее — пример соответствующего сообщения об ошибке: "Expression has more than one roots. Only one root operator is allowed for each expression: And, Or, Not, Dimensions, Tags, CostCategories"

Примечание

Для действия GetRightsizingRecommendation сочетание OR и NOT не поддерживается. OR не поддерживается между различными измерениями или измерениями и тегами. Операторы NOT не поддерживаются. Измерения также ограничены LINKED_ACCOUNT, REGION или RIGHTSIZING_TYPE.

Для действия GetReservationPurchaseRecommendation поддерживается только NOT. AND и OR не поддерживаются. Измерения ограничены LINKED_ACCOUNT.

Или -> (список)

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

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

И -> (список)

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

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

(… рекурсивно …)Измерения -> (структура)

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

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

Имена типов метаданных, которые можно использовать для фильтрации и группировки результатов. Например, AZ возвращает список зон доступности.

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

LINKED_ACCOUNT_NAME и SERVICE_CODE могут использоваться только в CostCategoryRule.

ANOMALY_TOTAL_IMPACT_ABSOLUTE и ANOMALY_TOTAL_IMPACT_PERCENTAGE могут использоваться только в AnomalySubscriptions.

Значения -> (список)

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

(строка)

ПараметрыСоответствия -> (список)

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

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

Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Теги -> (структура)

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

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

Ключ тега.

Значения -> (список)

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

(строка)

ПараметрыСоответствия -> (список)

Параметры соответствия, которые можно использовать для фильтрации результатов. MatchOptions применим только для действий, связанных с категориями затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE .

(строка)

КатегорииЗатрат -> (структура)

Фильтр, основанный на значениях CostCategory .

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

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

Значения -> (список)

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

(строка)

ПараметрыСоответствия -> (список)

Параметры соответствия, которые можно использовать для фильтрации результатов. ПараметрыСоответствия применимы только для действий, связанных с категорией затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE .

(строка)

И -> (список)

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

(структура)

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

Не все типы Expression поддерживаются в каждом API. Обратитесь к документации для каждого конкретного API, чтобы узнать о поддерживаемых типах.

Существуют два шаблона:

  • Простые значения измерений.
    • Существует три типа простых значений измерений: CostCategories , Tags и Dimensions .
      • Укажите поле CostCategories для определения фильтра, который действует на категории затрат.
      • Укажите поле Tags для определения фильтра, который действует на теги распределения затрат.
      • Укажите поле Dimensions для определения фильтра, который действует на ` DimensionValues https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html`__.
    • Для каждого типа фильтра можно задать имя измерения и значения для фильтров, которые вы планируете использовать.
      • Например, можно отфильтровать по REGION==us-east-1 OR REGION==us-west-1 . Для GetRightsizingRecommendation регион — это полное название (например, REGION==US East (N. Virginia)).
      • Соответствующее значение Expression для этого примера приведено ниже: { "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] } }
      • Как показано в предыдущем примере, списки значений измерений комбинируются с OR при применении фильтра.
    • Можно также задать различные параметры соответствия для дальнейшего управления поведением фильтра. Не все API поддерживают параметры соответствия. Обратитесь к документации для каждого конкретного API, чтобы узнать о поддерживаемых параметрах соответствия.
      • Например, можно отфильтровать по именам связанных учетных записей, начинающимся с "a".
      • Соответствующее значение Expression для этого примера приведено ниже: { "Dimensions": { "Key": "LINKED_ACCOUNT_NAME", "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] } }
  • Составные типы Expression с логическими операциями.
    • Можно использовать несколько типов Expression и логические операторы AND/OR/NOT для создания списка одного или нескольких объектов Expression. Сделав это, вы сможете фильтровать по более продвинутым параметрам.
    • Например, можно фильтровать по ((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer).
    • Соответствующее значение Expression для этого примера приведено ниже: { "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] }

Примечание

Поскольку каждый Expression может иметь только один оператор, служба возвращает ошибку, если указано более одного. Следующий пример показывает объект Expression, который создает ошибку: { "And": [ ... ], "Dimensions": { "Key": "USAGE_TYPE", "Values": [ "DataTransfer" ] } }

Следующее — пример соответствующего сообщения об ошибке: "Expression has more than one roots. Only one root operator is allowed for each expression: And, Or, Not, Dimensions, Tags, CostCategories"

Примечание

Для действия GetRightsizingRecommendation комбинация OR и NOT не поддерживается. OR не поддерживается между различными измерениями или измерениями и тегами. Операторы NOT не поддерживаются. Измерения также ограничены LINKED_ACCOUNT , REGION или RIGHTSIZING_TYPE.

Для действия GetReservationPurchaseRecommendation поддерживается только NOT. AND и OR не поддерживаются. Измерения ограничены LINKED_ACCOUNT.

Или -> (список)

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

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

И -> (список)

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

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

(… рекурсивно …)Измерения -> (структура)

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

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

Названия типов метаданных, которые можно использовать для фильтрации и группировки результатов. Например, AZ возвращает список доступных зон.

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

LINKED_ACCOUNT_NAME и SERVICE_CODE могут использоваться только в CostCategoryRule.

ANOMALY_TOTAL_IMPACT_ABSOLUTE и ANOMALY_TOTAL_IMPACT_PERCENTAGE могут использоваться только в AnomalySubscriptions.

Значения -> (список)

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

(строка)

Параметры соответствия -> (список)

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

MatchOptions применим только для действий, связанных с категориями затрат и подписками на оповещения об аномалиях. Обратитесь к документации для каждого конкретного API, чтобы узнать о поддерживаемых параметрах соответствия.

Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Теги -> (структура)

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

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

Ключ тега.

Значения -> (список)

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

(строка)

Параметры соответствия -> (список)

Параметры соответствия, которые можно использовать для фильтрации результатов. MatchOptions применим только для действий, связанных с категориями затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Категории затрат -> (структура)

Фильтр, основанный на значениях CostCategory.

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

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

Значения -> (список)

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

(строка)

Параметры соответствия -> (список)

Параметры соответствия, которые можно использовать для фильтрации результатов. Параметры соответствия применимы только для действий, связанных с категориями затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Не -> (структура)

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

Или -> (список)

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

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

И -> (список)

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

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

(… рекурсивно …)Измерения -> (структура)

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

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

Названия типов метаданных, которые можно использовать для фильтрации и группировки результатов. Например, AZ возвращает список доступных зон.

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

LINKED_ACCOUNT_NAME и SERVICE_CODE могут использоваться только в CostCategoryRule.

ANOMALY_TOTAL_IMPACT_ABSOLUTE и ANOMALY_TOTAL_IMPACT_PERCENTAGE могут использоваться только в AnomalySubscriptions.

Значения -> (список)

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

(строка)

Параметры соответствия -> (список)

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

MatchOptions применим только для действий, связанных с категориями затрат и подписками на оповещения об аномалиях. Обратитесь к документации для каждого конкретного API, чтобы узнать о поддерживаемых параметрах соответствия.

Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Теги -> (структура)

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

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

Ключ тега.

Значения -> (список)

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

(строка)

Параметры соответствия -> (список)

Параметры соответствия, которые можно использовать для фильтрации результатов. MatchOptions применим только для действий, связанных с категориями затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Категории затрат -> (структура)

Фильтр, основанный на значениях CostCategory.

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

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

Значения -> (список)

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

(строка)

Параметры соответствия -> (список)

Параметры соответствия, которые можно использовать для фильтрации результатов. Параметры соответствия применимы только для действий, связанных с категориями затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Измерения -> (структура)

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

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

Названия типов метаданных, которые можно использовать для фильтрации и группировки результатов. Например, AZ возвращает список доступных зон.

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

LINKED_ACCOUNT_NAME и SERVICE_CODE могут использоваться только в CostCategoryRule.

ANOMALY_TOTAL_IMPACT_ABSOLUTE и ANOMALY_TOTAL_IMPACT_PERCENTAGE могут использоваться только в AnomalySubscriptions.

Значения -> (список)

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

(строка)

Параметры соответствия -> (список)

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

MatchOptions применим только для действий, связанных с категориями затрат и подписками на оповещения об аномалиях. Обратитесь к документации для каждого конкретного API, чтобы узнать о поддерживаемых параметрах соответствия.

Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Теги -> (структура)

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

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

Ключ тега.

Значения -> (список)

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

(строка)

Параметры соответствия -> (список)

Параметры соответствия, которые можно использовать для фильтрации результатов. MatchOptions применим только для действий, связанных с категориями затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Категории затрат -> (структура)

Фильтр, основанный на значениях CostCategory.

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

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

Значения -> (список)

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

(строка)

Параметры соответствия -> (список)

Параметры соответствия, которые можно использовать для фильтрации результатов. Параметры соответствия применимы только для действий, связанных с категориями затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Синтаксис JSON:

{
  "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"|"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"|"AGREEMENT_END_DATE_TIME_AFTER"|"AGREEMENT_END_DATE_TIME_BEFORE"|"INVOICING_ENTITY"|"ANOMALY_TOTAL_IMPACT_ABSOLUTE"|"ANOMALY_TOTAL_IMPACT_PERCENTAGE",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      },
      "Tags": {
        "Key": "string",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      },
      "CostCategories": {
        "Key": "string",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      }
    }
    ...
  ],
  "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"|"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"|"AGREEMENT_END_DATE_TIME_AFTER"|"AGREEMENT_END_DATE_TIME_BEFORE"|"INVOICING_ENTITY"|"ANOMALY_TOTAL_IMPACT_ABSOLUTE"|"ANOMALY_TOTAL_IMPACT_PERCENTAGE",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      },
      "Tags": {
        "Key": "string",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      },
      "CostCategories": {
        "Key": "string",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      }
    }
    ...
  ],
  "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"|"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"|"AGREEMENT_END_DATE_TIME_AFTER"|"AGREEMENT_END_DATE_TIME_BEFORE"|"INVOICING_ENTITY"|"ANOMALY_TOTAL_IMPACT_ABSOLUTE"|"ANOMALY_TOTAL_IMPACT_PERCENTAGE",
      "Values": ["string", ...],
      "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
    },
    "Tags": {
      "Key": "string",
      "Values": ["string", ...],
      "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
    },
    "CostCategories": {
      "Key": "string",
      "Values": ["string", ...],
      "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
    }
  },
  "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"|"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"|"AGREEMENT_END_DATE_TIME_AFTER"|"AGREEMENT_END_DATE_TIME_BEFORE"|"INVOICING_ENTITY"|"ANOMALY_TOTAL_IMPACT_ABSOLUTE"|"ANOMALY_TOTAL_IMPACT_PERCENTAGE",
    "Values": ["string", ...],
    "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
  },
  "Tags": {
    "Key": "string",
    "Values": ["string", ...],
    "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
  },
  "CostCategories": {
    "Key": "string",
    "Values": ["string", ...],
    "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
  }
}

--sort-by (структура)

Значение, по которому требуется отсортировать данные.

Для Key поддерживаются следующие значения:

  • UtilizationPercentage
  • TotalCommitment
  • UsedCommitment
  • UnusedCommitment
  • NetSavings

Поддерживаемые значения для SortOrder — ASCENDING и DESCENDING.

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

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

Порядок сортировки -> (строка)

Порядок сортировки данных.

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

Key=string,SortOrder=string

Синтаксис JSON:

{
  "Key": "string",
  "SortOrder": "ASCENDING"|"DESCENDING"
}

--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-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Вывод

SavingsPlansUtilizationsByTime -> (список)

Объем затрат/обязательств, потраченных на планы экономии. Можно использовать для указания диапазонов дат.

(структура)

Объем использования планов экономии (в часах).

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

Период времени запроса.

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

Начало периода времени. Дата начала включена. Например, если start равно 2017-01-01, Amazon Web Services извлекает данные о затратах и использовании, начиная с 2017-01-01 и до даты окончания. Дата начала должна быть равна или предшествовать текущей дате, чтобы избежать ошибки валидации.

Конец -> (строка)

Конец периода времени. Дата окончания исключена. Например, если end равно 2017-05-01, Amazon Web Services извлекает данные о затратах и использовании с даты начала до, но не включая, 2017-05-01.

Использование -> (структура)

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

Общий объем обязательств -> (строка)

Общий объем обязательств по плану экономии, приобретенный в учетной записи (или наборе учетных записей).

Использованные обязательства -> (строка)

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

Неиспользованные обязательства -> (строка)

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

Процент использования -> (строка)

Объем UsedCommitment, деленный на TotalCommitment для ваших планов экономии.

Экономия -> (структура)

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

Чистая экономия -> (строка)

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

Эквивалент затрат по требованию -> (строка)

Сколько бы стоило использование, если бы оно было накоплено по ставке по требованию.

Амортизированные обязательства -> (структура)

Общий амортизированный объем обязательств по плану экономии. Включает сумму авансовых и периодических платежей за планы экономии.

Амортизированные периодические обязательства -> (строка)

Амортизированная сумма обязательств по плану экономии, приобретенная либо с Partial, либо с NoUpfront.

Амортизированные авансовые обязательства -> (строка)

Амортизированная сумма обязательств по плану экономии, приобретенная с Upfront или PartialUpfront планами экономии.

Общий амортизированный объем обязательств -> (строка)

Общий амортизированный объем обязательств по плану экономии, независимо от метода покупки планов экономии.

Итого -> (структура)

Общий объем затрат/обязательств, использованных по планам экономии, независимо от диапазонов дат.

Использование -> (структура)

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

Общий объем обязательств -> (строка)

Общий объем обязательств по плану экономии, приобретенный в учетной записи (или наборе учетных записей).

Использованные обязательства -> (строка)

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

Неиспользованные обязательства -> (строка)

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

Процент использования -> (строка)

Объем UsedCommitment, деленный на TotalCommitment для ваших планов экономии.

Экономия -> (структура)

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

Чистая экономия -> (строка)

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

Эквивалент затрат по требованию -> (строка)

Сколько бы стоило использование, если бы оно было накоплено по ставке по требованию.

Амортизированные обязательства -> (структура)

Общий амортизированный объем обязательств по плану экономии. Включает сумму авансовых и периодических платежей за планы экономии.

Амортизированные периодические обязательства -> (строка)

Амортизированная сумма обязательств по плану экономии, приобретенная либо с Partial, либо с NoUpfront.

Амортизированные авансовые обязательства -> (строка)

Амортизированная сумма обязательств по плану экономии, приобретенная с Upfront или PartialUpfront планами экономии.

Общий амортизированный объем обязательств -> (строка)

Общий амортизированный объем обязательств по плану экономии, независимо от метода покупки планов экономии.

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

Spec-Zone.ru

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