[ aws . storagegateway ]
обновить-nfs-файл-совместное-использование
Описание
Обновляет сетевое файловое хранилище NFS (Network File System). Данная операция поддерживается только в S3 File Gateways.
Примечание
Для того чтобы оставить поле совместного использования файла без изменений, установите соответствующее поле ввода в значение null.Обновляет следующие параметры совместного использования файла:
- По умолчанию класс хранения для вашего S3-бакета
- Значения метаданных по умолчанию для вашего S3-бакета
- Разрешенные клиенты NFS для вашего совместного использования файла
- Настройки сжатия
- Статус записи для вашего совместного использования файла
См. также: Документацию API AWS
Синтаксис
update-nfs-file-share
--file-share-arn <value>
[--encryption-type <value>]
[--kms-encrypted | --no-kms-encrypted]
[--kms-key <value>]
[--nfs-file-share-defaults <value>]
[--default-storage-class <value>]
[--object-acl <value>]
[--client-list <value>]
[--squash <value>]
[--read-only | --no-read-only]
[--guess-mime-type-enabled | --no-guess-mime-type-enabled]
[--requester-pays | --no-requester-pays]
[--file-share-name <value>]
[--cache-attributes <value>]
[--notification-policy <value>]
[--audit-destination-arn <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-share-arn (строка)
--encryption-type (строка)
Указывает тип шифрования на стороне сервера, который будет использоваться совместным использованием файлов для данных, хранящихся в Amazon S3.
Примечание
Рекомендуется использовать EncryptionType вместо KMSEncrypted для настройки метода шифрования совместного использования файла. Вам не нужно предоставлять значения для обоих параметров.
Если значения обоих параметров присутствуют в одном запросе, указанные методы шифрования не должны конфликтовать. Например, если EncryptionType является SseS3, то KMSEncrypted должно быть false. Если EncryptionType является SseKms или DsseKms, то KMSEncrypted должно быть true.
Возможные значения:
SseS3SseKmsDsseKms
--kms-encrypted | --no-kms-encrypted (логическое значение)
Необязательно. Установите в значение true, чтобы использовать шифрование Amazon S3 на стороне сервера с вашим собственным ключом KMS (SSE-KMS), или в значение false, чтобы использовать ключ, управляемый Amazon S3 (SSE-S3). Для использования двухслойного шифрования (DSSE-KMS), установите параметр EncryptionType.
Примечание
Рекомендуется использовать EncryptionType вместо KMSEncrypted для настройки метода шифрования совместного использования файла. Вам не нужно предоставлять значения для обоих параметров.
Если значения обоих параметров присутствуют в одном запросе, указанные методы шифрования не должны конфликтовать. Например, если EncryptionType является SseS3, то KMSEncrypted должно быть false. Если EncryptionType является SseKms или DsseKms, то KMSEncrypted должно быть true.
Допустимые значения: true | false
--kms-key (строка)
KMSEncrypted равно true, или если EncryptionType равно SseKms или DsseKms.--nfs-file-share-defaults (структура)
Значения по умолчанию для совместного использования файла. Необязательно.
FileMode -> (строка)
0666 представляет режим файла по умолчанию в рамках совместного использования файла. Значение по умолчанию - 0666.DirectoryMode -> (строка)
0666 представляет режим доступа по умолчанию для всех каталогов в рамках совместного использования файла. Значение по умолчанию - 0777.GroupId -> (целое число)
nfsnobody.OwnerId -> (целое число)
nfsnobody.Сокращенный синтаксис:
FileMode=string,DirectoryMode=string,GroupId=long,OwnerId=long
Синтаксис JSON:
{
"FileMode": "string",
"DirectoryMode": "string",
"GroupId": long,
"OwnerId": long
}
--default-storage-class (строка)
Класс хранения по умолчанию для объектов, помещаемых в бакет Amazon S3 с помощью S3 File Gateway. Значение по умолчанию - S3_STANDARD. Необязательно.
Допустимые значения: S3_STANDARD | S3_INTELLIGENT_TIERING | S3_STANDARD_IA | S3_ONEZONE_IA
--object-acl (строка)
Значение, устанавливающее разрешение списка управления доступом (ACL) для объектов в S3-бакете, в который S3 File Gateway помещает объекты. Значение по умолчанию - private.
Возможные значения:
privatepublic-readpublic-read-writeauthenticated-readbucket-owner-readbucket-owner-full-controlaws-exec-read
--client-list (список)
Список клиентов, которым разрешен доступ к S3 File Gateway. Список должен содержать либо валидные IP-адреса, либо валидные CIDR-блоки.
(строка)
Синтаксис:
"string" "string" ...
--squash (строка)
Пользователь, сопоставленный анонимному пользователю.
Допустимые значения:
-
RootSquash: Только root сопоставлен анонимному пользователю. -
NoSquash: Никто не сопоставлен анонимному пользователю. -
AllSquash: Все сопоставлены анонимному пользователю.
--read-only | --no-read-only (логическое значение)
Значение, устанавливающее статус записи для совместного использования файла. Установите это значение в true, чтобы установить статус записи в режим только для чтения, в противном случае установите в false.
Допустимые значения: true | false
--guess-mime-type-enabled | --no-guess-mime-type-enabled (логическое значение)
Значение, которое позволяет угадывать тип MIME для загружаемых объектов на основе расширений файлов. Установите это значение в true, чтобы включить угадывание типа MIME, в противном случае установите в false. Значение по умолчанию - true.
Допустимые значения: true | false
--requester-pays | --no-requester-pays (логическое значение)
Значение, которое устанавливает, кто оплачивает стоимость запроса и затраты, связанные с загрузкой данных из S3-бакета. Если это значение установлено в true, запрашивающий оплачивает затраты; в противном случае, владелец S3-бакета оплачивает. Однако владелец S3-бакета всегда оплачивает затраты на хранение данных.
Примечание
RequesterPays - это конфигурация для S3-бакета, который поддерживает совместное использование файлов, поэтому убедитесь, что конфигурация совместного использования файлов совпадает с конфигурацией S3-бакета.Допустимые значения: true | false
--file-share-name (строка)
Имя совместного использования файла. Необязательно.
Примечание
FileShareName должен быть установлен, если имя префикса S3 установлено в LocationARN, или если используется точка доступа или псевдоним точки доступа.Валидное имя совместного использования NFS может содержать только следующие символы: a -z, A -Z, 0 -9, -, . и _.
--cache-attributes (структура)
Указывает информацию о кэшировании обновления для совместного использования файла.
CacheStaleTimeoutInSeconds -> (целое число)
Обновляет кэш совместного использования файла с помощью времени жизни (TTL). TTL - это продолжительность времени с момента последнего обновления, после которого доступ к каталогу заставит шлюз файлов сначала обновить содержимое этого каталога из ведра Amazon S3 или файловой системы Amazon FSx. Продолжительность TTL выражается в секундах.
Допустимые значения: 0, от 300 до 2 592 000 секунд (от 5 минут до 30 дней)
Сокращенный синтаксис:
CacheStaleTimeoutInSeconds=integer
Синтаксис JSON:
{
"CacheStaleTimeoutInSeconds": integer
}
--notification-policy (строка)
Политика уведомлений для совместного использования файлов. SettlingTimeInSeconds управляет количеством секунд ожидания после последней точки времени, когда клиент записывал в файл, прежде чем генерировать уведомление ObjectUploaded. Поскольку клиенты могут выполнять множество мелких записей в файлы, лучше всего установить этот параметр как можно дольше, чтобы избежать генерации нескольких уведомлений для одного файла в короткий промежуток времени.
Примечание
SettlingTimeInSeconds не влияет на временные рамки загрузки объекта в Amazon S3, только на временные рамки уведомления.Это значение не предназначено для указания точного времени отправки уведомления. В некоторых случаях шлюзу может потребоваться больше времени, чем указанный период ожидания, для генерации и отправки уведомлений.
Следующий пример устанавливает NotificationPolicy с SettlingTimeInSeconds, установленным в 60.
{\"Upload\": {\"SettlingTimeInSeconds\": 60}}Следующий пример устанавливает NotificationPolicy в выключенное состояние.
{}--audit-destination-arn (строка)
--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.
Вывод
FileShareARN -> (string)
© Copyright 2025, Amazon Web Services. Created using Sphinx.