delete-object

Описание

Удаляет объект из ведра. Поведение зависит от состояния ведра с точки зрения версиирования:

• Если версия ведра не включена, операция навсегда удаляет объект.
• Если версия ведра включена, операция вставляет маркер удаления, который становится текущей версией объекта. Чтобы навсегда удалить объект в ведре с включенным версиями, необходимо включить versionId в запросе. Дополнительную информацию о ведрах с включенным версиями см. в разделе Удаление версий объектов из ведра с включенным версиями.
• Если версия ведра приостановлена, операция удаляет объект с нулевым versionId , если таковой существует, и вставляет маркер удаления, который становится текущей версией объекта. Если нет объекта с нулевым versionId и все версии объекта имеют versionId , Amazon S3 не удаляет объект, а только вставляет маркер удаления. Чтобы навсегда удалить объект с versionId , необходимо включить versionId объекта в запросе. Дополнительную информацию о ведрах с приостановленным версиями см. в разделе Удаление объектов из ведер с приостановленным версиями.

Чтобы удалить определенную версию, необходимо использовать параметр запроса versionId. Использование этого параметра запроса приводит к окончательному удалению версии. Если удаленный объект является маркером удаления, Amazon S3 устанавливает заголовок ответа x-amz-delete-marker в значение true.

Если объект, который вы хотите удалить, находится в ведре, где в конфигурации версии ведра включена MFA Delete, вы должны включить заголовок запроса x-amz-mfa в запросе DELETE versionId. Запросы, включающие x-amz-mfa, должны использовать HTTPS. Дополнительную информацию о MFA Delete см. в разделе Использование MFA Delete в руководстве пользователя Amazon S3. Примеры запросов, использующих версия, см. в Пример запроса.

Вы можете удалять объекты, явно вызывая DELETE Object или вызывая (PutBucketLifecycle ), чтобы позволить Amazon S3 удалить их за вас. Если вы хотите заблокировать пользователей или учетные записи от удаления объектов из вашего ведра, вы должны запретить им действия s3:DeleteObject , s3:DeleteObjectVersion и s3:PutLifeCycleConfiguration.

• Разрешения для ведер общего назначения - Следующие разрешения необходимы в ваших политиках, когда запрос DeleteObjects включает определенные заголовки.

  • **s3:DeleteObject ** - Для удаления объекта из ведра всегда необходимо разрешение s3:DeleteObject.
  • **s3:DeleteObjectVersion ** - Для удаления определенной версии объекта из ведра с включенным версиями необходимо разрешение s3:DeleteObjectVersion.

• Разрешения для ведер каталогов - Для предоставления доступа к этой операции API для ведра каталогов рекомендуется использовать операцию API ` CreateSession https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html`__ для сеансовой авторизации. В частности, вы предоставляете разрешение s3express:CreateSession ведру каталогов в политике ведра или политике, связанной с идентификатором IAM. Затем вы выполняете вызов API CreateSession на ведре, чтобы получить токен сеанса. С токеном сеанса в вашем заголовке запроса вы можете отправлять запросы API для этой операции. После истечения срока действия токена сеанса вы выполняете еще один вызов API CreateSession, чтобы сгенерировать новый токен сеанса для использования. AWS CLI или SDK автоматически создают сеанс и обновляют токен сеанса, чтобы избежать прерываний сервиса при истечении срока действия сеанса. Дополнительную информацию об авторизации см. в ` CreateSession https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html`__.

  Синтаксис заголовка HTTP Host

Следующее действие связано с DeleteObject:

• PutObject

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

Синтаксис

  delete-object
--bucket <value>
--key <value>
[--mfa <value>]
[--version-id <value>]
[--request-payer <value>]
[--bypass-governance-retention | --no-bypass-governance-retention]
[--expected-bucket-owner <value>]
[--if-match <value>]
[--if-match-last-modified-time <value>]
[--if-match-size <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 (строка)

--key (строка)

--mfa (строка)

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

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

--bypass-governance-retention | --no-bypass-governance-retention (булево)

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

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

--if-match-last-modified-time (метка времени)

--if-match-size (длинное целое число)

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

Примеры

Следующая команда удаляет объект с именем test.txt из ведра с именем amzn-s3-demo-bucket:

aws s3api delete-object --bucket amzn-s3-demo-bucket --key test.txt

Если включено управление версиями ведра, вывод будет содержать идентификатор версии удаленного маркера:

{
  "VersionId": "9_gKg5vG56F.TTEUdwkxGpJ3tNDlWlGq",
  "DeleteMarker": true
}

Дополнительную информацию об удалении объектов см. в разделе Удаление объектов в Руководстве разработчика Amazon S3.

Вывод

DeleteMarker -> (boolean)

VersionId -> (string)

RequestCharged -> (string)