get-cost-categories
Описание
Возвращает массив имён и значений категорий затрат.
Примечание
Если имена и значения некоторых категорий затрат не связаны ни с какими затратами, они не будут возвращены этим API.См. также: Документация AWS API
Синтаксис
get-cost-categories
[--search-string <value>]
--time-period <value>
[--cost-category-name <value>]
[--filter <value>]
[--sort-by <value>]
[--billing-view-arn <value>]
[--max-results <value>]
[--next-page-token <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]
Параметры
--search-string (строка)
Значение, по которому вы хотите искать значения фильтра.
Если вы не указываете CostCategoryName , используется SearchString для фильтрации имён категорий затрат, которые соответствуют шаблону SearchString. Если вы указываете CostCategoryName , используется SearchString для фильтрации значений категорий затрат, которые соответствуют шаблону SearchString.
--time-period (структура)
Период времени запроса.
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"
}
--cost-category-name (строка)
--filter (структура)
Используйте Expression для фильтрации в различных API Cost Explorer.
Не все типы Expression поддерживаются в каждом API. Обратитесь к документации для каждого конкретного API, чтобы узнать, что поддерживается.
Существует два шаблона:
- Простые значения размеров.
- Существуют три типа простых значений размеров:
CostCategories,TagsиDimensions.- Укажите поле
CostCategoriesдля определения фильтра, который действует на категории затрат. - Укажите поле
Tagsдля определения фильтра, который действует на теги распределения затрат. - Укажите поле
Dimensionsдля определения фильтра, который действует на `DimensionValueshttps://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.
Or -> (список)
Возвращает результаты, которые соответствуют любому объекту Dimension.
(структура)
Используйте Expression для фильтрации в различных API Cost Explorer.
Не все типы Expression поддерживаются в каждом API. Обратитесь к документации для каждого конкретного API, чтобы узнать, что поддерживается.
Существует два шаблона:
- Простые значения размеров.
- Существуют три типа простых значений размеров:
CostCategories,TagsиDimensions.- Укажите поле
CostCategoriesдля определения фильтра, который действует на категории затрат. - Укажите поле
Tagsдля определения фильтра, который действует на теги распределения затрат. - Укажите поле
Dimensionsдля определения фильтра, который действует на `DimensionValueshttps://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.
Or -> (список)
Возвращает результаты, которые соответствуют любому объекту Dimension.
( … рекурсивно … )
And -> (список)
Возвращает результаты, которые соответствуют обоим объектам 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.
(строка)
Categories -> (структура)
Фильтр, основанный на значениях CostCategory.
Ключ -> (строка)
Значения -> (список)
Конкретное значение категории затрат.
(строка)
Параметры соответствия -> (список)
Параметры соответствия, которые можно использовать для фильтрации результатов. MatchOptions применим только к действиям, связанным с категорией затрат. Значения по умолчанию для MatchOptions это EQUALS и CASE_SENSITIVE.
(строка)
И -> (список)
Возвращать результаты, которые соответствуют обоим объектам Dimension.
(структура)
Используйте Expression для фильтрации в различных API Cost Explorer.
Не все типы Expression поддерживаются в каждом API. Обратитесь к документации для каждого конкретного API, чтобы узнать, что поддерживается.
Существует два шаблона:
- Простые значения измерений.
- Существует три типа простых значений измерений:
CostCategories,TagsиDimensions.- Укажите поле
CostCategoriesдля определения фильтра, который действует на категории затрат. - Укажите поле
Tagsдля определения фильтра, который действует на теги распределения затрат. - Укажите поле
Dimensionsдля определения фильтра, который действует на `DimensionValueshttps://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 применим только для действий, связанных с категориями затрат. Значения по умолчанию для 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 применим только для действий, связанных с категориями затрат. Значения по умолчанию для 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 применим только для действий, связанных с категориями затрат. Значения по умолчанию для 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 (список)
Значение, по которому сортируются данные.
Ключ представляет собой метрики затрат и использования. Поддерживаются следующие значения:
BlendedCostUnblendedCostAmortizedCostNetAmortizedCostNetUnblendedCostUsageQuantityNormalizedUsageAmount
Поддерживаемые значения ключей для параметра SortOrder — ASCENDING и DESCENDING.
При использовании параметра SortBy, значения ключей NextPageToken и SearchString не поддерживаются.
(структура)
Детали сортировки данных.
Ключ -> (строка)
Порядок сортировки -> (строка)
Сокращенная синтаксическая запись:
Key=string,SortOrder=string ...
Синтаксис JSON:
[
{
"Key": "string",
"SortOrder": "ASCENDING"|"DESCENDING"
}
...
]
--billing-view-arn (строка)
--max-results (целое число)
Это поле используется только при предоставлении значения SortBy в запросе.
Максимальное количество объектов, возвращаемых по этому запросу. Если MaxResults не указано со значением SortBy, запрос возвращает 1000 результатов по умолчанию.
Для GetCostCategories, MaxResults имеет верхний лимит 1000.
--next-page-token (строка)
--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
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использование конкретного профиля из файла учетных данных.
--region (строка)
Используемый регион. Переопределяет настройки из конфигурации/среды.
--version (строка)
Отображение версии данного инструмента.
--color (строка)
Включение/выключение цветного вывода.
- on
- off
- auto
--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.
Вывод
NextPageToken -> (строка)
CostCategoryNames -> (список)
Названия категорий затрат.
(строка)
CostCategoryValues -> (список)
Значения категорий затрат.
Если ключ CostCategoryName не указан в запросе, поля CostCategoryValues не возвращаются.
(строка)
ReturnSize -> (целое число)
TotalSize -> (целое число)
© Copyright 2025, Amazon Web Services. Created using Sphinx.