Spec-Zone.ru › AWS CLI v2

[ aws . kendra ]

обновить-индекс

Описание

Обновляет индекс 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 (строка)

Роль управления доступом и идентификацией (IAM), предоставляющая Amazon Kendra разрешения на доступ к журналам и метрикам Amazon CloudWatch.

--description (строка)

Новое описание индекса.

--document-metadata-configuration-updates (список)

Конфигурация метаданных документов, которую вы хотите обновить для индекса. Метаданные документов — это поля или атрибуты, связанные с вашими документами. Например, название отдела компании, связанное с каждым документом.

(структура)

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

Имя -> (строка)

Имя поля индекса.

Тип -> (строка)

Тип данных поля индекса.

Релевантность -> (структура)

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

Актуальность -> (логическое значение)

Указывает, что это поле определяет, насколько «свежий» документ. Например, если документ 1 был создан 5 ноября, а документ 2 — 31 октября, документ 1 «свежее», чем документ 2. Применимо только к полям 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-вызовов.

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

Единицы емкости хранения -> (целое число)

Количество дополнительной емкости хранения для индекса. Одна единица емкости предоставляет 30 ГБ места для хранения или 100 000 документов, в зависимости от того, что будет достигнуто раньше. Вы можете добавить до 100 дополнительных единиц емкости.

Единицы емкости запросов -> (целое число)

Количество дополнительной емкости запросов для индекса и емкости 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 -> (строка)

URL ключа подписи.

SecretManagerArn -> (строка)

Amazon Resource Name (arn) секрета.

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

Поле атрибута имени пользователя.

Поле атрибута группы -> (строка)

Поле атрибута группы.

Издатель -> (строка)

Издатель маркера.

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_FILTER
  • USER_TOKEN

--user-group-resolution-configuration (структура)

Получает пользователей и группы из источника идентификации IAM Identity Center. Чтобы настроить это, см. UserGroupResolutionConfiguration. Это полезно для фильтрации контекста пользователя, где результаты поиска фильтруются на основе доступа пользователя или его группы к документам.

Предупреждение

Если вы используете индекс Amazon Kendra Gen AI Enterprise Edition, UserGroupResolutionConfiguration не поддерживается.

UserGroupResolutionMode -> (строка)

Провайдер источника идентификации (режим), который вы хотите использовать для получения пользователей и групп. В настоящее время единственным доступным режимом является IAM Identity Center. Ваши пользователи и группы должны существовать в источнике идентификации IAM Identity Center для использования этого режима.

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

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.

Spec-Zone.ru

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