object-not-exists

Описание

Ожидание получения ответа 404 при опросе с помощью head-object. Будет выполняться опрос каждые 5 секунд до достижения успешного состояния. Выход с кодом возврата 255 после 20 неудачных проверок.

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

Синтаксис

  object-not-exists
--bucket <value>
[--if-match <value>]
[--if-modified-since <value>]
[--if-none-match <value>]
[--if-unmodified-since <value>]
--key <value>
[--range <value>]
[--response-cache-control <value>]
[--response-content-disposition <value>]
[--response-content-encoding <value>]
[--response-content-language <value>]
[--response-content-type <value>]
[--response-expires <value>]
[--version-id <value>]
[--sse-customer-algorithm <value>]
[--sse-customer-key <value>]
[--sse-customer-key-md5 <value>]
[--request-payer <value>]
[--part-number <value>]
[--expected-bucket-owner <value>]
[--checksum-mode <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]

Параметры

--bucket (строка)

Имя ведра, содержащего объект.

Ведра каталогов - При использовании этой операции с ведром каталогов необходимо использовать запросы в стиле виртуального хостинга в формате `` Имя_ведры .s3express-идентификатор_зоны .*код_региона* .amazonaws.com`` . Запросы в стиле пути не поддерживаются. Имена ведер каталогов должны быть уникальными в выбранной зоне (зоне доступности или локальной зоне). Имена ведер должны соответствовать формату `` основное_имя_ведры –идентификатор_зоны –x-s3`` (например, `` amzn-s3-demo-bucket –usw2-az1 –x-s3`` ). Сведения о ограничениях именования ведер см. в руководстве пользователя Amazon S3.

Точки доступа - При использовании этого действия с точкой доступа для ведер общего назначения необходимо указать псевдоним точки доступа вместо имени ведра или указать ARN точки доступа. При использовании этого действия с точкой доступа для ведер каталогов необходимо указать имя точки доступа вместо имени ведра. При использовании ARN точки доступа необходимо направить запросы на хост-имя точки доступа. Хост-имя точки доступа имеет вид ИмяТочкиДоступа -ИдентификаторАккаунта .s3-accesspoint.*Регион* .amazonaws.com. При использовании этого действия с точкой доступа через SDK Amazon Web Services укажите ARN точки доступа вместо имени ведра. Дополнительную информацию об ARN точек доступа см. в руководстве пользователя Amazon S3.

Примечание

Точки доступа Object Lambda не поддерживаются для ведер каталогов.

S3 на Outposts - При использовании этого действия с S3 на Outposts необходимо направить запросы на хост-имя S3 на Outposts. Хост-имя S3 на Outposts имеет вид `` ИмяТочкиДоступа -ИдентификаторАккаунта .*идентификатор_outpost* .s3-outposts.*Регион* .amazonaws.com`` . При использовании этого действия с S3 на Outposts целевое ведро должно быть ARN точки доступа Outposts или псевдонимом точки доступа. Дополнительную информацию о S3 на Outposts см. в руководстве пользователя Amazon S3.

--if-match (строка)

Возвращает объект только в том случае, если его тег сущности (ETag) совпадает с указанным; в противном случае возвращает ошибку 412 (предусловие не выполнено).

Если оба заголовка If-Match и If-Unmodified-Since присутствуют в запросе следующим образом:

условие If-Match равно true, и;
условие If-Unmodified-Since равно false;

Тогда Amazon S3 возвращает 200 OK и запрашиваемые данные.

Дополнительную информацию об условных запросах см. в RFC 7232.

--if-modified-since (отметка времени)

Возвращает объект только в том случае, если он был изменен после указанного времени; в противном случае возвращает ошибку 304 (не изменено).

Если оба заголовка If-None-Match и If-Modified-Since присутствуют в запросе следующим образом:

условие If-None-Match равно false, и;
условие If-Modified-Since равно true;

Тогда Amazon S3 возвращает код ответа 304 Not Modified.

Дополнительную информацию об условных запросах см. в RFC 7232.

--if-none-match (строка)

Возвращает объект только в том случае, если его тег сущности (ETag) отличается от указанного; в противном случае возвращает ошибку 304 (не изменено).

Если оба заголовка If-None-Match и If-Modified-Since присутствуют в запросе следующим образом:

условие If-None-Match равно false, и;
условие If-Modified-Since равно true;

Тогда Amazon S3 возвращает код ответа 304 Not Modified.

Дополнительную информацию об условных запросах см. в RFC 7232.

--if-unmodified-since (отметка времени)

Возвращает объект только в том случае, если он не был изменен после указанного времени; в противном случае возвращает ошибку 412 (предусловие не выполнено).

Если оба заголовка If-Match и If-Unmodified-Since присутствуют в запросе следующим образом:

условие If-Match равно true, и;
условие If-Unmodified-Since равно false;

Тогда Amazon S3 возвращает 200 OK и запрашиваемые данные.

Дополнительную информацию об условных запросах см. в RFC 7232.

--key (строка)

Ключ объекта.

--range (строка)

HeadObject возвращает только метаданные для объекта. Если диапазон удовлетворяется, только ContentLength затронут в ответе. Если диапазон не удовлетворяется, S3 возвращает ошибку 416 - Requested Range Not Satisfiable.

--response-cache-control (строка)

Устанавливает заголовок Cache-Control ответа.

--response-content-disposition (строка)

Устанавливает заголовок Content-Disposition ответа.

--response-content-encoding (строка)

Устанавливает заголовок Content-Encoding ответа.

--response-content-language (строка)

Устанавливает заголовок Content-Language ответа.

--response-content-type (строка)

Устанавливает заголовок Content-Type ответа.

--response-expires (отметка времени)

Устанавливает заголовок Expires ответа.

--version-id (строка)

Идентификатор версии, используемый для ссылки на конкретную версию объекта.

Примечание

Для ведер каталогов в этой операции API поддерживается только значение null идентификатора версии.

--sse-customer-algorithm (строка)

Указывает алгоритм, используемый при шифровании объекта (например, AES256).

Примечание

Эта функция не поддерживается для ведер каталогов.

--sse-customer-key (строка)

Указывает предоставленный клиентом ключ шифрования для Amazon S3, который используется для шифрования данных. Это значение используется для хранения объекта, а затем отбрасывается; Amazon S3 не хранит ключ шифрования. Ключ должен быть подходящим для использования с алгоритмом, указанным в заголовке x-amz-server-side-encryption-customer-algorithm.

Примечание

Эта функция не поддерживается для ведер каталогов.

--sse-customer-key-md5 (строка)

Указывает 128-битный MD5-дайджест ключа шифрования в соответствии с RFC 1321. Amazon S3 использует этот заголовок для проверки целостности сообщения, чтобы убедиться, что ключ шифрования был передан без ошибок.

Примечание

Эта функция не поддерживается для ведер каталогов.

--request-payer (строка)

Подтверждает, что запрашивающий знает, что ему будет взиматься плата за запрос. Владельцам ведер не нужно указывать этот параметр в своих запросах. Если в исходном или целевом ведре S3 включена опция платы за запрос, запрашивающий заплатит соответствующую плату за копирование объекта. Дополнительную информацию о скачивании объектов из ведер с оплатой запрашивающим см. в руководстве пользователя Amazon S3.

Примечание

Эта функция не поддерживается для ведер каталогов.

Возможные значения:

requester

--part-number (целое число)

Номер части объекта, который считывается. Это целое число от 1 до 10 000. Эффективно выполняет запрос HEAD с диапазоном для указанной части. Полезно для запроса о размере части и количестве частей в этом объекте.

--expected-bucket-owner (строка)

Идентификатор аккаунта предполагаемого владельца ведра. Если предоставленный вами идентификатор аккаунта не совпадает с фактическим владельцем ведра, запрос завершается с кодом состояния HTTP 403 Forbidden (доступ запрещен).

--checksum-mode (строка)

Для получения контрольной суммы этот параметр должен быть включен.

Ведра общего назначения - Если вы включите режим контрольной суммы, и объект загружен с контрольной суммой и зашифрован с помощью ключа Key Management Service (KMS), у вас должны быть разрешения на использование действия kms:Decrypt для получения контрольной суммы.

Ведра каталогов - Если вы включите ChecksumMode, и объект зашифрован с помощью Amazon Web Services Key Management Service (Amazon Web Services KMS), у вас также должны быть разрешения kms:GenerateDataKey и kms:Decrypt в политиках IAM на основе идентификатора и политиках ключа KMS для ключа KMS, чтобы получить контрольную сумму объекта.

Возможные значения:

ENABLED

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

Файл с корневым сертификатом для проверки 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-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Более подробную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. использование кавычек со строками в руководстве пользователя AWS CLI.

Для ожидания (приостановки выполнения), пока объект не будет больше существовать

Следующий wait object-not-exists пример приостанавливается и продолжается только после подтверждения, что указанный объект (--key) в указанном ведре больше не существует.

aws s3api wait object-not-exists \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf

Эта команда не генерирует вывод.

Вывод

Нет