get-dimension-values

Описание

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

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

Синтаксис

  get-dimension-values
[--search-string <value>]
--time-period <value>
--dimension <value>
[--context <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 (строка)

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

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

Начальная и конечная даты для получения значений измерений. Начальная дата включена, а конечная — исключена. Например, если start — 2017-01-01, а end — 2017-05-01, то данные о затратах и использовании извлекаются с 2017-01-01 и до включительно 2017-04-30, но не включая 2017-05-01.

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"
}

--dimension (строка)

Имя измерения. Каждое Dimension доступно для разного Context. Для получения дополнительной информации, см. Context. LINK_ACCOUNT_NAME и SERVICE_CODE могут использоваться только в CostCategoryRule.

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

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

--context (строка)

Контекст для вызова GetDimensionValues. Это может быть RESERVATIONS или COST_AND_USAGE. Значение по умолчанию — COST_AND_USAGE. Если контекст установлен на RESERVATIONS, полученные значения измерений можно использовать в операции GetReservationUtilization. Если контекст установлен на COST_AND_USAGE, полученные значения измерений можно использовать в операции GetCostAndUsage.

Если вы установите контекст на COST_AND_USAGE, вы можете использовать следующие измерения для поиска:

AZ — Доступная зона. Пример — us-east-1a.
BILLING_ENTITY — Продавец Amazon Web Services, с которым связан ваш аккаунт. Возможные значения: - Amazon Web Services (Amazon Web Services): Сущность, которая продает услуги Amazon Web Services. - AISPL (Amazon Internet Services Pvt. Ltd.): Местная индийская сущность, выступающая в качестве реселлера услуг Amazon Web Services в Индии. - Amazon Web Services Marketplace: Сущность, поддерживающая продажу решений, созданных на основе Amazon Web Services сторонними поставщиками программного обеспечения.
CACHE_ENGINE — Операционная система Amazon ElastiCache. Примеры — Windows или Linux.
DEPLOYMENT_OPTION — Область охвата развертываний Amazon Relational Database Service. Допустимые значения — SingleAZ и MultiAZ.
DATABASE_ENGINE — База данных Amazon Relational Database Service. Примеры — Aurora или MySQL.
INSTANCE_TYPE — Тип экземпляра Amazon EC2. Пример — m4.xlarge.
INSTANCE_TYPE_FAMILY — Семейство типов экземпляров, оптимизированных для разных задач. Примеры — Compute Optimized (например, C4, C5, C6g и C7g), Memory Optimization (например, R4, R5n, R5b и R6g).
INVOICING_ENTITY — Название сущности, которая выставляет счет Amazon Web Services.
LEGAL_ENTITY_NAME — Название организации, которая продает вам услуги Amazon Web Services, например, Amazon Web Services.
LINKED_ACCOUNT — Описание в атрибуте карты, содержащем полное имя учетной записи участника. Поле значения содержит идентификатор Amazon Web Services учетной записи участника.
OPERATING_SYSTEM — Операционная система. Примеры — Windows или Linux.
OPERATION — Выполненное действие. Примеры — RunInstance и CreateBucket.
PLATFORM — Операционная система Amazon EC2. Примеры — Windows или Linux.
PURCHASE_TYPE — Тип резервирования покупки, к которому относится это использование. Примеры — On-Demand Instances и Standard Reserved Instances.
RESERVATION_ID — Уникальный идентификатор резервации Amazon Web Services Reservation Instance.
SAVINGS_PLAN_ARN — Уникальный идентификатор ваших планов экономии.
SAVINGS_PLANS_TYPE — Тип планов экономии (экземпляр EC2 или вычисления).
SERVICE — Услуга Amazon Web Services, например, Amazon DynamoDB.
TENANCY — Тип аренды ресурса. Примеры — совместная или выделенная.
USAGE_TYPE — Тип использования. Пример — DataTransfer-In-Bytes. Ответ на операцию GetDimensionValues включает атрибут единицы. Примеры — GB и Hrs.
USAGE_TYPE_GROUP — Группировка общих типов использования. Пример — Amazon EC2: CloudWatch – Alarms. Ответ на эту операцию включает атрибут единицы.
REGION — Регион Amazon Web Services.
RECORD_TYPE — Различные типы платежей, такие как сборы за Reserved Instance (RI), затраты на использование, возмещение налогов и кредиты.
RESOURCE_ID — Уникальный идентификатор ресурса. ResourceId — функция, доступная только по запросу в течение последних 14 дней для EC2-Compute Service.

Если вы установите контекст на RESERVATIONS, вы можете использовать следующие измерения для поиска:

AZ — Доступная зона. Пример — us-east-1a.
CACHE_ENGINE — Операционная система Amazon ElastiCache. Примеры — Windows или Linux.
DEPLOYMENT_OPTION — Область охвата развертываний Amazon Relational Database Service. Допустимые значения — SingleAZ и MultiAZ.
INSTANCE_TYPE — Тип экземпляра Amazon EC2. Пример — m4.xlarge.
LINKED_ACCOUNT — Описание в атрибуте карты, содержащем полное имя учетной записи участника. Поле значения содержит идентификатор Amazon Web Services учетной записи участника.
PLATFORM — Операционная система Amazon EC2. Примеры — Windows или Linux.
REGION — Регион Amazon Web Services.
SCOPE (только для использования) — Область охвата Reserved Instance (RI). Значения — региональный или отдельная доступная зона.
TAG (только для покрытия) — Теги, связанные с Reserved Instance (RI).
TENANCY — Тип аренды ресурса. Примеры — совместная или выделенная.

Если вы установите контекст на SAVINGS_PLANS, вы можете использовать следующие измерения для поиска:

SAVINGS_PLANS_TYPE — Тип планов экономии (экземпляр EC2 или вычисления)
PAYMENT_OPTION — Способ оплаты для заданных планов экономии (например, Все авансом)
REGION — Регион Amazon Web Services.
INSTANCE_TYPE_FAMILY — Семейство экземпляров (например, m5)
LINKED_ACCOUNT — Описание в атрибуте карты, содержащем полное имя учетной записи участника. Поле значения содержит идентификатор Amazon Web Services учетной записи участника.
SAVINGS_PLAN_ARN — Уникальный идентификатор ваших планов экономии.

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

COST_AND_USAGE
RESERVATIONS
SAVINGS_PLANS

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

Используйте 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 типов и логические операторы 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.

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

Простые значения измерений.
- Существует три типа простых значений измерений: 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 типов и логические операторы 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"] }}} ] }

Примечание

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.

(строка)

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

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

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

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

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

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

(строка)

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

Параметры соответствия, которые можно использовать для фильтрации результатов. MatchOptions применим только к действиям, связанным с категорией затрат. Значения по умолчанию для 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" ] } }

Примечание

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

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

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

И -> (список)

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

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

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

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

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

Не все измерения поддерживаются в каждом 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.

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

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

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

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

(строка)

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

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

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

(строка)

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

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

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

Ключ тега.

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

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

(строка)

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

(строка)

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

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

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

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

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

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

(строка)

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

(строка)

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

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

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

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

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

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

(строка)

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

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

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

(строка)

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

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

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

Ключ тега.

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

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

(строка)

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

(строка)

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

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

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

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

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

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

(строка)

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

(строка)

Синтаксис 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 (список)

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

Ключ представляет собой метрики затрат и использования. Поддерживаются следующие значения:

BlendedCost
UnblendedCost
AmortizedCost
NetAmortizedCost
NetUnblendedCost
UsageQuantity
NormalizedUsageAmount

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

При указании параметра SortBy контекст должен быть COST_AND_USAGE. Кроме того, при использовании SortBy не поддерживаются NextPageToken и SearchString.

(структура)

Подробности о том, как отсортировать данные.

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

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

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

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

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

Key=string,SortOrder=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "SortOrder": "ASCENDING"|"DESCENDING"
  }
  ...
]

--billing-view-arn (строка)

Уникальное имя ресурса Amazon (ARN), идентифицирующее конкретный вид выставления счетов. ARN используется для указания конкретного вида выставления счетов для взаимодействия или получения информации при работе с API, связанными с услугами Amazon Web Services по выставлению счетов и управлению затратами. BillingViewArn можно получить, вызвав API ListBillingViews.

--max-results (целое число)

Это поле используется только при указании SortBy в запросе. Максимальное количество объектов, возвращаемых для данного запроса. Если MaxResults не указан вместе с SortBy, запрос возвращает 1000 результатов в качестве значения по умолчанию для этого параметра.

Для GetDimensionValues MaxResults имеет верхний предел 1000.

--next-page-token (строка)

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

--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.

Примеры

Примечание

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

Если не указано иное, все примеры используют правила цитирования в стиле Unix. Вам нужно будет адаптировать эти примеры к правилам цитирования вашей консоли. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для получения тегов для измерения SERVICE со значением «Elastic»

Этот пример получает теги для измерения SERVICE со значением «Elastic» за период с 01 января 2017 года по 18 мая 2017 года.

Команда:

aws ce get-dimension-values --search-string Elastic --time-period Start=2017-01-01,End=2017-05-18 --dimension SERVICE

Вывод:

{
   "TotalSize": 6,
   "DimensionValues": [
       {
           "Attributes": {},
           "Value": "Amazon ElastiCache"
       },
       {
           "Attributes": {},
           "Value": "EC2 - Other"
       },
       {
           "Attributes": {},
           "Value": "Amazon Elastic Compute Cloud - Compute"
       },
       {
           "Attributes": {},
           "Value": "Amazon Elastic Load Balancing"
       },
       {
           "Attributes": {},
           "Value": "Amazon Elastic MapReduce"
       },
       {
           "Attributes": {},
           "Value": "Amazon Elasticsearch Service"
       }
   ],
   "ReturnSize": 6
}

Вывод

DimensionValues -> (список)

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

Если вы зададите контекст COST_AND_USAGE, вы можете использовать следующие измерения для поиска:

AZ - Доступная зона. Пример - us-east-1a.
DATABASE_ENGINE - База данных Amazon Relational Database Service. Примеры: Aurora или MySQL.
INSTANCE_TYPE - Тип экземпляра Amazon EC2. Пример - m4.xlarge.
LEGAL_ENTITY_NAME - Название организации, которая предоставляет вам услуги Amazon Web Services, например, Amazon Web Services.
LINKED_ACCOUNT - Описание в атрибуте, включающее полное имя учетной записи участника. Поле значения содержит идентификатор учетной записи участника в Amazon Web Services.
OPERATING_SYSTEM - Операционная система. Примеры: Windows или Linux.
OPERATION - Выполненное действие. Примеры включают RunInstance и CreateBucket.
PLATFORM - Операционная система Amazon EC2. Примеры: Windows или Linux.
PURCHASE_TYPE - Тип резервирования покупки, к которой относится данное использование. Примеры: On-Demand Instances и Standard Reserved Instances.
SERVICE - Услуга Amazon Web Services, например, Amazon DynamoDB.
USAGE_TYPE - Тип использования. Пример: DataTransfer-In-Bytes. Ответ на операцию GetDimensionValues включает атрибут единицы измерения. Примеры: GB и Hrs.
USAGE_TYPE_GROUP - Группировка общих типов использования. Пример: Amazon EC2: CloudWatch – Alarms. Ответ на эту операцию включает атрибут единицы измерения.
RECORD_TYPE - Различные типы платежей, такие как сборы за резервирование, затраты на использование, возвраты налогов и кредиты.
RESOURCE_ID - Уникальный идентификатор ресурса. ResourceId — это функция, доступная только в течение последних 14 дней для EC2-Compute Service. Вы можете подключиться, включив Hourly и Resource Level Data в настройках консоли управления затратами.

Если вы зададите контекст RESERVATIONS, вы можете использовать следующие измерения для поиска:

AZ - Доступная зона. Пример - us-east-1a.
CACHE_ENGINE - Операционная система Amazon ElastiCache. Примеры: Windows или Linux.
DEPLOYMENT_OPTION - Область действия развертываний Amazon Relational Database Service. Допустимые значения - SingleAZ и MultiAZ.
INSTANCE_TYPE - Тип экземпляра Amazon EC2. Пример - m4.xlarge.
LINKED_ACCOUNT - Описание в атрибуте, включающее полное имя учетной записи участника. Поле значения содержит идентификатор учетной записи участника в Amazon Web Services.
PLATFORM - Операционная система Amazon EC2. Примеры: Windows или Linux.
REGION - Регион Amazon Web Services.
SCOPE (только для использования) - Область действия резервированной инстанции (RI). Значения: региональные или в пределах одной доступной зоны.
TAG (только для покрытия) - Теги, связанные с резервированной инстанцией (RI).
TENANCY - Тип выделения ресурсов. Примеры: shared или dedicated.

Если вы зададите контекст SAVINGS_PLANS, вы можете использовать следующие измерения для поиска:

SAVINGS_PLANS_TYPE - Тип планов экономии (экземпляр EC2 или вычисления)
PAYMENT_OPTION - Способ оплаты для заданных планов экономии (например, All Upfront)
REGION - Регион Amazon Web Services.
INSTANCE_TYPE_FAMILY - Семейство экземпляров (например, m5)
LINKED_ACCOUNT - Описание в атрибуте, включающее полное имя учетной записи участника. Поле значения содержит идентификатор учетной записи участника в Amazon Web Services.
SAVINGS_PLAN_ARN - Уникальный идентификатор вашего плана экономии

(структура)

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

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

Значение измерения со специфическим атрибутом.

Атрибуты -> (словарь)

Атрибут, применимый к определённому Dimension.

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

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

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

Количество результатов, возвращенных Amazon Web Services за один раз.

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

Общее количество результатов поиска.

NextPageToken -> (строка)

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