Spec-Zone.ru › AWS CLI v2

[ aws . fsx ]

обновить-кеш-файлов

Описание

Обновляет конфигурацию существующего ресурса Amazon File Cache. Вы можете обновить несколько свойств в одном запросе.

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

Синтаксис

  update-file-cache
--file-cache-id <value>
[--client-request-token <value>]
[--lustre-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]

Параметры

--file-cache-id (строка)

Идентификатор кеша, который вы обновляете.

--client-request-token (строка)

(Необязательно) Токен идемпотентности для создания ресурса, строка длиной до 63 ASCII символов. Этот токен автоматически заполняется от вашего имени при использовании командной строки (CLI) или SDK Amazon Web Services.

--lustre-configuration (структура)

Обновления конфигурации ресурса Amazon File Cache.

WeeklyMaintenanceStartTime -> (строка)

Повторяющееся еженедельное время в формате D:HH:MM .

D — это день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Для получения дополнительной информации см. спецификацию ISO-8601, описанную в Википедии .

HH — это час дня с нулевым заполнением (0-23), а MM — это минута часа с нулевым заполнением.

Например, 1:05:00 указывает техническое обслуживание в 5:00 по понедельникам.

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

WeeklyMaintenanceStartTime=string

Синтаксис JSON:

{
  "WeeklyMaintenanceStartTime": "string"
}

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

Вывод

FileCache -> (структура)

Описание кэша, который был обновлён.

OwnerId -> (строка)

Идентификатор учётной записи Amazon Web Services. Этот идентификатор — 12-значное число, которое используется для создания имён ресурсов Amazon Resource Names (ARN) для ресурсов.

CreationTime -> (временная метка)

Время создания ресурса в секундах (с момента 1970-01-01T00:00:00Z), также известное как время Unix.

FileCacheId -> (строка)

Сгенерированный системой уникальный идентификатор кэша.

FileCacheType -> (строка)

Тип кэша, который должен быть LUSTRE.

FileCacheTypeVersion -> (строка)

Версия Lustre кэша, которая должна быть 2.12.

Lifecycle -> (строка)

Статус жизненного цикла кэша. Ниже приведены возможные значения и их описания:

  • AVAILABLE - Кэш находится в исправном состоянии, доступен и готов к использованию.
  • CREATING - Создаётся новый кэш.
  • DELETING - Существующий кэш удаляется.
  • UPDATING - Кэш проходит обновление, инициированное пользователем.
  • FAILED - Существующий кэш претерпел необратимый сбой. При создании нового кэша его создание не удалось.

FailureDetails -> (структура)

Структура, предоставляющая детали любых произошедших сбоев.

Message -> (строка)

Сообщение, описывающее любые произошедшие сбои.

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

Ёмкость хранилища кэша в гигабайтах (GiB).

VpcId -> (строка)

Идентификатор вашей виртуальной частной сети (VPC). Для получения дополнительной информации см. раздел VPC и подсети в руководстве пользователя Amazon VPC.

SubnetIds -> (список)

Список идентификаторов подсетей, из которых кэш будет доступен. В запросе к операции CreateFileCache можно указать только один идентификатор подсети.

(строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Для получения дополнительной информации см. раздел VPC и подсети в руководстве пользователя Amazon VPC.

NetworkInterfaceIds -> (список)

Список идентификаторов сетевых интерфейсов.

(строка)

Идентификатор эластичного сетевого интерфейса. Эластичный сетевой интерфейс — это логический сетевой компонент в виртуальной частной сети (VPC), представляющий собой виртуальную сетевую карту. Для получения дополнительной информации см. раздел Elastic Network Interfaces в руководстве пользователя Amazon EC2 для Linux-инстансов.

DNSName -> (строка)

Имя домена системы Domain Name System (DNS) для кэша.

KmsKeyId -> (строка)

Указывает ID ключа управления ключами (KMS) для шифрования данных в Amazon File Cache. Если KmsKeyId не указан, используется управляемый Amazon FSx ключ KMS для вашей учётной записи. Для получения дополнительной информации см. Шифрование в справке по API Key Management Service.

ResourceARN -> (строка)

Имя ресурса Amazon Resource Name (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. ARN требуется, когда необходимо однозначно указать ресурс в рамках всех сервисов Amazon Web Services. Для получения дополнительной информации см. имена ресурсов Amazon Resource Names (ARN) в общем справочнике Amazon Web Services.

LustreConfiguration -> (структура)

Настройка ресурса Amazon File Cache.

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

Пропускная способность хранилища на единицу представляет собой пропускную способность чтения или записи в мегабайтах в секунду на 1 тебибайт предоставленного хранилища. Ёмкость пропускной способности кэша равна Ёмкости хранилища (TiB) * PerUnitStorageThroughput (МБ/с/TiB). Поддерживается только значение 1000.

DeploymentType -> (строка)

Тип развертывания ресурса Amazon File Cache, который должен быть CACHE_1.

MountName -> (строка)

Значение MountName используется при подключении кэша. Если вы передаёте идентификатор кэша в операцию DescribeFileCaches, она возвращает значение MountName в качестве части описания кэша.

WeeklyMaintenanceStartTime -> (строка)

Еженедельное время в формате D:HH:MM.

D — это день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Для получения дополнительных сведений см. спецификацию ISO-8601 на Википедии.

HH — это отформатированное число часа (0–23), а MM — отформатированное число минуты (0–59).

Например, 1:05:00 указывает техническое обслуживание в 5:00 по понедельникам.

MetadataConfiguration -> (структура)

Настройка для тома Lustre MDT (Metadata Target).

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

Ёмкость хранилища тома Lustre MDT (Metadata Target) в гигабайтах (GiB). Поддерживается только значение 2400 GiB.

LogConfiguration -> (структура)

Настройка ведения журнала Lustre, используемая для записи событий включённого ведения журнала для вашего ресурса Amazon File Cache в Amazon CloudWatch Logs.

Level -> (строка)

События репозитория данных, которые регистрируются Amazon FSx.

  • WARN_ONLY — регистрируются только предупреждения.
  • ERROR_ONLY — регистрируются только ошибки.
  • WARN_ERROR — регистрируются как предупреждения, так и ошибки.
  • DISABLED — ведение журнала событий репозитория данных выключено.

Обратите внимание, что Amazon File Cache использует значение по умолчанию WARN_ERROR, которое изменить нельзя.

Destination -> (строка)

Имя ресурса Amazon Resource Name (ARN), которое указывает место назначения логов. Местом назначения может быть любой ARN группы логов Amazon CloudWatch Logs. ARN места назначения должен находиться в той же области Amazon Web Services, регионе Amazon Web Services и учётной записи Amazon Web Services, что и ваш файл системы Amazon FSx.

DataRepositoryAssociationIds -> (список)

Список идентификаторов ассоциаций репозитория данных, связанных с этим кэшем.

(строка)

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

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