create-tracker
Описание
Создает ресурс отслеживания в вашей учетной записи Amazon Web Services, который позволяет получать текущее и историческое местоположение устройств.
См. также: Документация API AWS
Синтаксис
create-tracker
--tracker-name <value>
[--pricing-plan <value>]
[--kms-key-id <value>]
[--pricing-plan-data-source <value>]
[--description <value>]
[--tags <value>]
[--position-filtering <value>]
[--event-bridge-enabled | --no-event-bridge-enabled]
[--kms-key-enable-geospatial-queries | --no-kms-key-enable-geospatial-queries]
[--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]
Параметры
--tracker-name (строка)
Имя ресурса отслеживания.
Требования:
- Содержать только буквенно-цифровые символы (A-Z, a-z, 0-9), дефисы (-), точки (.) и символы подчеркивания (_).
- Должно быть уникальным именем ресурса отслеживания.
- Пробелы запрещены. Например,
ExampleTracker.
--pricing-plan (строка)
Больше не используется. Если указано, единственное допустимое значение — RequestBasedUsage .
Возможные значения:
RequestBasedUsageMobileAssetTrackingMobileAssetManagement
--kms-key-id (строка)
--pricing-plan-data-source (строка)
--description (строка)
--tags (словарь)
Применяет один или несколько тегов к ресурсу отслеживания. Тег — это пара ключ-значение, которая помогает управлять, идентифицировать, искать и фильтровать ресурсы, маркируя их.
Формат: "key" : "value"
Ограничения:
- Максимум 50 тегов на ресурс
- Каждый тег ресурса должен быть уникальным с максимальным количеством одного значения.
- Максимальная длина ключа: 128 символов Юникода в UTF-8
- Максимальная длина значения: 256 символов Юникода в UTF-8
- Можно использовать буквенно-цифровые символы (A–Z, a–z, 0–9) и следующие символы: + - = . _ : / @.
- Нельзя использовать «aws:» в качестве префикса ключа.
key -> (строка)
value -> (строка)
Сокращенный синтаксис:
KeyName1=string,KeyName2=string
Синтаксис JSON:
{"string": "string"
...}
--position-filtering (строка)
Указывает фильтрацию местоположения для ресурса отслеживания.
Допустимые значения:
-
TimeBased— Обновления местоположения оцениваются относительно связанных коллекций геозон, но не каждое обновление местоположения сохраняется. Если частота обновлений выше 30 секунд, для каждого уникального идентификатора устройства сохраняется только одно обновление каждые 30 секунд. -
DistanceBased— Если устройство переместилось менее чем на 30 м (98,4 фута), обновления местоположения игнорируются. Обновления местоположения в этой области не оцениваются относительно связанных геозон и не сохраняются. Это помогает контролировать расходы, уменьшая количество оценок геозон и исторических позиций устройств для постраничной навигации. Фильтрация по расстоянию также может уменьшить влияние шума GPS при отображении траекторий устройств на карте. -
AccuracyBased— Если устройство переместилось менее чем на измеренную точность, обновления местоположения игнорируются. Например, если два последовательных обновления от устройства имеют горизонтальную точность 5 м и 10 м, второе обновление игнорируется, если устройство переместилось менее чем на 15 м. Игнорируемые обновления местоположения не оцениваются относительно связанных геозон и не сохраняются. Это может уменьшить влияние шума GPS при отображении траекторий устройств на карте и помочь контролировать расходы, уменьшая количество оценок геозон.
Этот параметр необязателен. Если не указано, значение по умолчанию — TimeBased .
Возможные значения:
TimeBasedDistanceBasedAccuracyBased
--event-bridge-enabled | --no-event-bridge-enabled (логическое значение)
Включить отправку событий местоположения UPDATE от этого отслеживателя в EventBridge.
Примечание
Вам не нужно включать эту функцию, чтобы получать событияENTER и EXIT для геозон с этим отслеживателем. Эти события всегда отправляются в EventBridge.--kms-key-enable-geospatial-queries | --no-kms-key-enable-geospatial-queries (логическое значение)
Включает GeospatialQueries для отслеживателя, использующего управляемый клиентом ключ Amazon Web Services KMS.
Этот параметр используется только при использовании управляемого клиентом ключа KMS.
Примечание
Если вы хотите зашифровать данные с помощью собственного управляемого клиентом ключа KMS, функция запросов по ограничивающим многоугольникам будет отключена по умолчанию. Это связано с тем, что при использовании этой функции представление ваших позиций устройства не будет зашифровано с помощью вашего управляемого ключа KMS. Однако точное местоположение устройства все равно зашифровано с помощью вашего управляемого ключа.
Вы можете выбрать участие в функции запросов по ограничивающим многоугольникам. Это делается путем установки параметра KmsKeyEnableGeospatialQueries в значение true при создании или обновлении отслеживателя.
--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
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Показать версию этого инструмента.
--color (строка)
Включить/выключить вывод цвета.
- включить
- выключить
- авто
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Файл сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь тайм-аута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь тайм-аута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде строки, закодированной в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключить пейджер CLI для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запроса параметров ввода CLI.
Вывод
TrackerName -> (строка)
TrackerArn -> (строка)
Amazon Resource Name (ARN) ресурса отслеживания. Используется, когда необходимо указать ресурс по всей системе Amazon Web Services.
- Пример формата:
arn:aws:geo:region:account-id:tracker/ExampleTracker
CreateTime -> (метка времени)
YYYY-MM-DDThh:mm:ss.sssZ .
© Copyright 2025, Amazon Web Services. Created using Sphinx.