восстановить-объект

Описание

Восстанавливает архивную копию объекта в Amazon S3

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

Этот action выполняет следующие типы запросов:

• restore an archive - Восстановление архивного объекта

Для получения дополнительной информации о структуре S3 в теле запроса, см. следующие разделы:

• PutObject

• Управление доступом с помощью ACL в руководстве Amazon S3 User Guide

• Защита данных с помощью шифрования на стороне сервера в руководстве Amazon S3 User Guide

  Разрешения

Для использования этой операции необходимо иметь разрешения на выполнение действия s3:RestoreObject. Владелец ведра по умолчанию имеет это разрешение и может предоставить его другим. Для получения дополнительной информации о разрешениях, см. Разрешения, связанные с операциями с подресурсами ведра, и Управление разрешениями доступа к вашим ресурсам Amazon S3 в руководстве Amazon S3 User Guide.

Объекты, которые вы архивируете в хранилище S3 Glacier Flexible Retrieval или S3 Glacier Deep Archive, а также в уровнях хранения S3 Intelligent-Tiering Archive или S3 Intelligent-Tiering Deep Archive, недоступны в реальном времени. Для объектов в хранилищах S3 Glacier Flexible Retrieval или S3 Glacier Deep Archive сначала необходимо выполнить запрос на восстановление, а затем дождаться, пока временная копия объекта станет доступной. Если вам нужна постоянная копия объекта, создайте её копию в хранилище Amazon S3 Standard в вашем ведре S3. Чтобы получить доступ к архивным объектам, вы должны восстановить объект на указанный период (количество дней). Для объектов в уровнях доступа Archive Access или Deep Archive Access в S3 Intelligent-Tiering, необходимо сначала выполнить запрос на восстановление, а затем дождаться перемещения объекта в уровень Frequent Access.

Для восстановления конкретной версии объекта вы можете указать идентификатор версии. Если вы не укажете идентификатор версии, Amazon S3 восстановит текущую версию.

При восстановлении архивного объекта вы можете указать один из следующих вариантов уровня доступа к данным в элементе Tier тела запроса:

• Expedited - Ускоренное извлечение позволяет быстро получить доступ к вашим данным, хранящимся в хранилище S3 Glacier Flexible Retrieval или уровне хранения S3 Intelligent-Tiering Archive, когда требуется периодическое неотложное восстановление архивов. Для всех, за исключением самых больших архивных объектов (более 250 МБ+), данные, полученные с помощью ускоренного извлечения, обычно становятся доступными в течение 1–5 минут. Гарантированная емкость обеспечивает наличие емкости для извлечения с использованием ускоренного метода, когда это необходимо. Ускоренное извлечение и гарантированная емкость недоступны для объектов, хранящихся в хранилище S3 Glacier Deep Archive или уровне хранилища S3 Intelligent-Tiering Deep Archive.
• Standard - Стандартное извлечение позволяет получить доступ к любым вашим архивным объектам в течение нескольких часов. Это параметр по умолчанию для запросов извлечения, которые не указывают параметр извлечения. Стандартное извлечение обычно завершается в течение 3–5 часов для объектов, хранящихся в хранилище S3 Glacier Flexible Retrieval или уровне хранения S3 Intelligent-Tiering Archive. Оно обычно завершается в течение 12 часов для объектов, хранящихся в хранилище S3 Glacier Deep Archive или уровне хранения S3 Intelligent-Tiering Deep Archive. Стандартное извлечение бесплатное для объектов, хранящихся в S3 Intelligent-Tiering.
• Bulk - Массовое извлечение, бесплатное для объектов, хранящихся в хранилищах S3 Glacier Flexible Retrieval и S3 Intelligent-Tiering, позволяет извлекать большие объёмы данных, даже петабайты, без дополнительной платы. Массовое извлечение обычно завершается в течение 5–12 часов для объектов, хранящихся в хранилище S3 Glacier Flexible Retrieval или уровне хранения S3 Intelligent-Tiering Archive. Массовое извлечение также является самым выгодным вариантом извлечения при восстановлении объектов из S3 Glacier Deep Archive. Обычно оно завершается в течение 48 часов для объектов, хранящихся в хранилище S3 Glacier Deep Archive или уровне хранения S3 Intelligent-Tiering Deep Archive.

Дополнительную информацию о параметрах извлечения архивов и гарантированной емкости для доступа к данным Expedited см. в руководстве Amazon S3 User Guide - Восстановление архивных объектов.

Вы можете использовать повышение скорости восстановления Amazon S3, чтобы изменить скорость восстановления на более высокую, пока процесс не завершен. Дополнительную информацию см. в руководстве Amazon S3 User Guide - Повышение скорости текущего восстановления.

Чтобы получить состояние восстановления объекта, вы можете отправить запрос HEAD. Операции возвращают заголовок x-amz-restore, который предоставляет информацию о статусе восстановления в ответе. Вы можете использовать уведомления Amazon S3 об событиях для получения уведомлений при инициации или завершении восстановления. Дополнительную информацию см. в руководстве Amazon S3 User Guide - Настройка уведомлений Amazon S3 об событиях.

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

Если ваше ведро имеет конфигурацию жизненного цикла с правилом, которое включает действие истечения срока действия, истечение срока действия объекта перекрывает срок, который вы указали в запросе на восстановление. Например, если вы восстанавливаете копию объекта на 10 дней, но истечение срока действия объекта запланировано на 3 дня, Amazon S3 удаляет объект через 3 дня. Дополнительную информацию о конфигурации жизненного цикла см. в руководстве Amazon S3 User Guide - PutBucketLifecycleConfiguration и Управление жизненным циклом объектов.

Успешная операция возвращает код состояния 200 OK или 202 Accepted.

• Если объект ранее не восстанавливался, Amazon S3 возвращает 202 Accepted в ответе.
• Если объект был ранее восстановлен, Amazon S3 возвращает 200 OK в ответе.
• Специальные ошибки:
  • Код: RestoreAlreadyInProgress
  • Причина: Восстановление объекта уже в процессе.
  • Код HTTP-статуса: 409 Конфликт
  • Префикс кода ошибки SOAP: Client
• • Код: GlacierExpeditedRetrievalNotAvailable
  • Причина: Ускоренное извлечение в настоящее время недоступно. Повторите попытку позже. (Возвращается, если емкости недостаточно для обработки запроса Expedited. Эта ошибка применима только к ускоренному извлечению, а не к S3 Standard или массовому извлечению.)
  • Код HTTP-статуса: 503
  • Префикс кода ошибки SOAP: N/A

Следующие операции связаны с RestoreObject :

• PutBucketLifecycleConfiguration
• GetBucketNotificationConfiguration

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

Синтаксис

  restore-object
--bucket <value>
--key <value>
[--version-id <value>]
[--restore-request <value>]
[--request-payer <value>]
[--checksum-algorithm <value>]
[--expected-bucket-owner <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 (строка)

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

--restore-request (структура)

{
  "Days": integer,
  "GlacierJobParameters": {
    "Tier": "Standard"|"Bulk"|"Expedited"
  },
  "Type": "SELECT",
  "Tier": "Standard"|"Bulk"|"Expedited",
  "Description": "string",
  "SelectParameters": {
    "InputSerialization": {
      "CSV": {
        "FileHeaderInfo": "USE"|"IGNORE"|"NONE",
        "Comments": "string",
        "QuoteEscapeCharacter": "string",
        "RecordDelimiter": "string",
        "FieldDelimiter": "string",
        "QuoteCharacter": "string",
        "AllowQuotedRecordDelimiter": true|false
      },
      "CompressionType": "NONE"|"GZIP"|"BZIP2",
      "JSON": {
        "Type": "DOCUMENT"|"LINES"
      },
      "Parquet": {

      }
    },
    "ExpressionType": "SQL",
    "Expression": "string",
    "OutputSerialization": {
      "CSV": {
        "QuoteFields": "ALWAYS"|"ASNEEDED",
        "QuoteEscapeCharacter": "string",
        "RecordDelimiter": "string",
        "FieldDelimiter": "string",
        "QuoteCharacter": "string"
      },
      "JSON": {
        "RecordDelimiter": "string"
      }
    }
  },
  "OutputLocation": {
    "S3": {
      "BucketName": "string",
      "Prefix": "string",
      "Encryption": {
        "EncryptionType": "AES256"|"aws:kms"|"aws:kms:dsse",
        "KMSKeyId": "string",
        "KMSContext": "string"
      },
      "CannedACL": "private"|"public-read"|"public-read-write"|"authenticated-read"|"aws-exec-read"|"bucket-owner-read"|"bucket-owner-full-control",
      "AccessControlList": [
        {
          "Grantee": {
            "DisplayName": "string",
            "EmailAddress": "string",
            "ID": "string",
            "Type": "CanonicalUser"|"AmazonCustomerByEmail"|"Group",
            "URI": "string"
          },
          "Permission": "FULL_CONTROL"|"WRITE"|"WRITE_ACP"|"READ"|"READ_ACP"
        }
        ...
      ],
      "Tagging": {
        "TagSet": [
          {
            "Key": "string",
            "Value": "string"
          }
          ...
        ]
      },
      "UserMetadata": [
        {
          "Name": "string",
          "Value": "string"
        }
        ...
      ],
      "StorageClass": "STANDARD"|"REDUCED_REDUNDANCY"|"STANDARD_IA"|"ONEZONE_IA"|"INTELLIGENT_TIERING"|"GLACIER"|"DEEP_ARCHIVE"|"OUTPOSTS"|"GLACIER_IR"|"SNOW"|"EXPRESS_ONEZONE"
    }
  }
}

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

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

--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
• text
• table
• yaml
• yaml-stream

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

Примеры

Для создания запроса восстановления объекта

Следующий пример restore-object восстанавливает указанный Amazon S3 Glacier-объект для ведра my-glacier-bucket на 10 дней.

aws s3api restore-object \
    --bucket my-glacier-bucket \
    --key doc1.rtf \
    --restore-request Days=10

Эта команда не выводит никаких данных.

Вывод

RequestCharged -> (строка)

RestoreOutputPath -> (строка)