обновить-индекс
Описание
Обновляет индекс Amazon Kendra.
См. также: Документация API AWS
Синтаксис
update-index
--id <value>
[--name <value>]
[--role-arn <value>]
[--description <value>]
[--document-metadata-configuration-updates <value>]
[--capacity-units <value>]
[--user-token-configurations <value>]
[--user-context-policy <value>]
[--user-group-resolution-configuration <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]
Параметры
--id (строка)
--name (строка)
--role-arn (строка)
--description (строка)
--document-metadata-configuration-updates (список)
Конфигурация метаданных документов, которую вы хотите обновить для индекса. Метаданные документов — это поля или атрибуты, связанные с вашими документами. Например, название отдела компании, связанное с каждым документом.
(структура)
Указывает свойства, такие как настройка релевантности и возможность поиска, для поля индекса.
Имя -> (строка)
Тип -> (строка)
Релевантность -> (структура)
Предоставляет параметры настройки, определяющие, как поле влияет на результаты поиска.
Актуальность -> (логическое значение)
DATE.Важность -> (целое число)
Срок действия -> (строка)
Указывает период времени, на который распространяется повышение. Например, чтобы повысить значение для документов с значением поля в течение последнего месяца, вы бы использовали «2628000s». Как только значение поля выходит за указанный диапазон, эффект повышения исчезает. Чем выше важность, тем быстрее эффект снижается. Если вы не укажете значение, значение по умолчанию — 3 месяца. Значение поля — числовая строка, за которой следует символ «s», например «86400s» для одного дня или «604800s» для одной недели.
Применимо только к полям DATE.
Порядок ранжирования -> (строка)
Определяет, как должны интерпретироваться значения.
Когда поле RankOrder имеет значение ASCENDING, более высокие числа лучше. Например, документ с оценкой 10 имеет более высокое ранжирование, чем документ с оценкой 1.
Когда поле RankOrder имеет значение DESCENDING, более низкие числа лучше. Например, в приложении отслеживания задач задача с приоритетом 1 более важна, чем задача с приоритетом 5.
Применимо только к полям LONG.
Карта значений важности -> (карта)
Список значений, которым следует придать другое повышение, когда они появляются в списке результатов. Например, если вы повышаете поле «отдел», запросы, совпадающие с полем «отдел», повышаются в результатах. Однако вы можете добавить записи из поля «отдел», чтобы повысить документы со значениями выше.
Например, вы можете добавить в карту названия отделов. Если вы добавите «HR»,5 и «Legal»,3, этим отделам уделяется особое внимание, когда они появляются в метаданных документа. При появлении этих терминов им присваивается указанная важность вместо обычной важности для повышения.
ключ -> (строка)
значение -> (целое число)
Поиск -> (структура)
Предоставляет информацию о том, как поле используется во время поиска.
Facetable -> (логическое значение)
false.Поисковое -> (логическое значение)
Searchable имеет значение true, вы можете использовать настройку релевантности для ручного настройки того, как Amazon Kendra оценивает поле в поиске. Значение по умолчанию — true для строковых полей и false для числовых и датированных полей.Отображаемое -> (логическое значение)
true.Сортируемое -> (логическое значение)
Sortable не установлено значение true, Amazon Kendra вернет исключение. Значение по умолчанию — false.Упрощенный синтаксис:
Name=string,Type=string,Relevance={Freshness=boolean,Importance=integer,Duration=string,RankOrder=string,ValueImportanceMap={KeyName1=integer,KeyName2=integer}},Search={Facetable=boolean,Searchable=boolean,Displayable=boolean,Sortable=boolean} ...
Синтаксис JSON:
[
{
"Name": "string",
"Type": "STRING_VALUE"|"STRING_LIST_VALUE"|"LONG_VALUE"|"DATE_VALUE",
"Relevance": {
"Freshness": true|false,
"Importance": integer,
"Duration": "string",
"RankOrder": "ASCENDING"|"DESCENDING",
"ValueImportanceMap": {"string": integer
...}
},
"Search": {
"Facetable": true|false,
"Searchable": true|false,
"Displayable": true|false,
"Sortable": true|false
}
}
...
]
--capacity-units (структура)
Устанавливает количество дополнительных единиц хранилища документов и емкости запросов, которые должны использоваться индексом. Вы можете изменить емкость индекса до 5 раз в день или выполнить 5 API-вызовов.
Если вы используете дополнительные единицы хранения, вы не можете уменьшить емкость хранения ниже необходимой для удовлетворения потребностей хранения вашего индекса.
Единицы емкости хранения -> (целое число)
Единицы емкости запросов -> (целое число)
Количество дополнительной емкости запросов для индекса и емкости GetQuerySuggestions.
Одна дополнительная единица емкости для индекса предоставляет 0,1 запроса в секунду или приблизительно 8000 запросов в день. Вы можете добавить до 100 дополнительных единиц емкости.
GetQuerySuggestions емкость в пять раз превышает предоставленную емкость запросов для индекса или базовую емкость 2,5 вызова в секунду, в зависимости от того, что выше. Например, базовая емкость индекса — 0,1 запросов в секунду, а GetQuerySuggestions емкость имеет базу 2,5 вызовов в секунду. Если вы добавите еще 0,1 запросов в секунду, чтобы в итоге получить 0,2 запросов в секунду для индекса, GetQuerySuggestions емкость составит 2,5 вызова в секунду (выше, чем в пять раз больше 0,2 запросов в секунду).Упрощенный синтаксис:
StorageCapacityUnits=integer,QueryCapacityUnits=integer
Синтаксис JSON:
{
"StorageCapacityUnits": integer,
"QueryCapacityUnits": integer
}
--user-token-configurations (список)
Конфигурация маркера пользователя.
Предупреждение
Если вы используете индекс Amazon Kendra Gen AI Enterprise Edition, и вы пытаетесь использоватьUserTokenConfigurations для настройки политики контекста пользователя, Amazon Kendra возвращает ошибку ValidationException.(структура)
Предоставляет конфигурационную информацию для маркера.
Предупреждение
Если вы используете индекс Amazon Kendra Gen AI Enterprise Edition, и вы пытаетесь использоватьUserTokenConfigurations для настройки политики контекста пользователя, Amazon Kendra возвращает ошибку ValidationException.JwtTokenTypeConfiguration -> (структура)
Информация о конфигурации типа маркера JWT.
Расположение ключа -> (строка)
URL -> (строка)
SecretManagerArn -> (строка)
Поле атрибута имени пользователя -> (строка)
Поле атрибута группы -> (строка)
Издатель -> (строка)
ClaimRegex -> (строка)
JsonTokenTypeConfiguration -> (структура)
Информация о конфигурации типа маркера JSON.
Поле атрибута имени пользователя -> (строка)
Поле атрибута группы -> (строка)
Упрощенный синтаксис:
JwtTokenTypeConfiguration={KeyLocation=string,URL=string,SecretManagerArn=string,UserNameAttributeField=string,GroupAttributeField=string,Issuer=string,ClaimRegex=string},JsonTokenTypeConfiguration={UserNameAttributeField=string,GroupAttributeField=string} ...
Синтаксис JSON:
[
{
"JwtTokenTypeConfiguration": {
"KeyLocation": "URL"|"SECRET_MANAGER",
"URL": "string",
"SecretManagerArn": "string",
"UserNameAttributeField": "string",
"GroupAttributeField": "string",
"Issuer": "string",
"ClaimRegex": "string"
},
"JsonTokenTypeConfiguration": {
"UserNameAttributeField": "string",
"GroupAttributeField": "string"
}
}
...
]
--user-context-policy (строка)
Политика контекста пользователя.
Предупреждение
Если вы используете индекс Amazon Kendra Gen AI Enterprise Edition, вы можете использовать толькоATTRIBUTE_FILTER для фильтрации результатов поиска по контексту пользователя. Если вы используете индекс Amazon Kendra Gen AI Enterprise Edition и пытаетесь использовать USER_TOKEN для настройки политики контекста пользователя, Amazon Kendra возвращает ошибку ValidationException.Возможные значения:
ATTRIBUTE_FILTERUSER_TOKEN
--user-group-resolution-configuration (структура)
Получает пользователей и группы из источника идентификации IAM Identity Center. Чтобы настроить это, см. UserGroupResolutionConfiguration. Это полезно для фильтрации контекста пользователя, где результаты поиска фильтруются на основе доступа пользователя или его группы к документам.
Предупреждение
Если вы используете индекс Amazon Kendra Gen AI Enterprise Edition,UserGroupResolutionConfiguration не поддерживается.UserGroupResolutionMode -> (строка)
Упрощенный синтаксис:
UserGroupResolutionMode=string
Синтаксис JSON:
{
"UserGroupResolutionMode": "AWS_SSO"|"NONE"
}
--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 (boolean)
Включить отладку протоколирования.
--endpoint-url (string)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI проверяет сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования для вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определённый профиль из файла учетных данных.
--region (string)
Регион для использования. Переопределяет настройки конфигурации/окружения.
--version (string)
Показать версию этого инструмента.
--color (string)
Включить/отключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружаться, если этот аргумент предоставлен.
--ca-bundle (string)
Файл сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/окружения.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (string)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое отображается в двоичный блок fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (boolean)
Отключить пагинатор CLI для вывода.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматический запрос параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Более подробную информацию см. в руководстве по началу работы с AWS CLI в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, похожие на Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для обновления индекса Amazon Kendra
Следующий update-index обновляет конфигурацию индекса Amazon Kendra. Если действие успешно выполнено, служба либо не отправляет вывод, либо возвращает HTTP-код состояния 200, либо AWS CLI возвращает код 0. Используйте describe-index, чтобы просмотреть конфигурацию и состояние индекса.
aws kendra update-index \
--id enterpriseindex1 \
--name "new name for Enterprise Edition index 1" \
--description "new description for Enterprise Edition index 1" \
--role-arn arn:aws:iam::my-account-id:role/KendraNewRoleForEnterpriseIndex \
--capacity-units '{"QueryCapacityUnits": 2, "StorageCapacityUnits": 1}' \
--document-metadata-configuration-updates '{"Name": "_document_title", "Relevance": {"Importance": 6}}, {"Name": "_last_updated_at", "Relevance": {"Importance": 8}}' \
--user-context-policy "USER_TOKEN" \
--user-token-configurations '{"JsonTokenTypeConfiguration": {"GroupAttributeField": "groupNameField", "UserNameAttributeField": "userNameField"}}'
Эта команда не производит вывод.
Дополнительную информацию см. в руководстве по началу работы с индексом и источником данных Amazon Kendra в Руководстве разработчика Amazon Kendra.
Вывод
Нет
© Copyright 2025, Amazon Web Services. Created using Sphinx.