get-object-attributes

Описание

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

• Разрешения для вёдер общего назначения - Для использования GetObjectAttributes необходимо иметь доступ для чтения к объекту. Разрешения, которые вам необходимы для использования этой операции, зависят от того, является ли ведро версионированным. Если ведро версионировано, вам необходимо получить как s3:GetObjectVersion , так и s3:GetObjectVersionAttributes разрешения для данной операции. Если ведро не версионировано, вам необходимы s3:GetObject и s3:GetObjectAttributes разрешения. Дополнительную информацию см. в разделе Указание разрешений в политике в руководстве пользователя Amazon S3. Если запрашиваемый объект не существует, ошибка, возвращаемая Amazon S3, зависит от того, имеете ли вы также разрешение s3:ListBucket.

  • Если у вас есть разрешение s3:ListBucket на ведро, Amazon S3 возвращает код HTTP-статуса 404 Not Found («такого ключа нет») ошибку.
  • Если у вас нет разрешения s3:ListBucket, Amazon S3 возвращает код HTTP-статуса 403 Forbidden («доступ запрещён») ошибку.

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

  Шифрование

Если вы шифруете объект, используя шифрование на стороне сервера с предоставленными клиентом ключами (SSE-C), когда вы сохраняете объект в Amazon S3, то при получении метаданных объекта необходимо использовать следующие заголовки для предоставления ключа шифрования серверу, чтобы тот смог получить метаданные объекта. Заголовки:

• x-amz-server-side-encryption-customer-algorithm
• x-amz-server-side-encryption-customer-key
• x-amz-server-side-encryption-customer-key-MD5

Дополнительную информацию о SSE-C см. в разделе Шифрование на стороне сервера (использование предоставленных клиентом ключей) в руководстве пользователя Amazon S3.

Рассмотрите следующие моменты при использовании заголовков запроса:

• Если оба заголовка If-Match и If-Unmodified-Since присутствуют в запросе следующим образом, Amazon S3 возвращает код HTTP-статуса 200 OK и запрашиваемые данные:
  • Условие If-Match оценивается как true .
  • Условие If-Unmodified-Since оценивается как false .

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

• Если оба заголовка If-None-Match и If-Modified-Since присутствуют в запросе следующим образом, Amazon S3 возвращает код HTTP-статуса 304 Not Modified :
  • Условие If-None-Match оценивается как false .
  • Условие If-Modified-Since оценивается как true .

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

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

• GetObject
• GetObjectAcl
• GetObjectLegalHold
• GetObjectLockConfiguration
• GetObjectRetention
• GetObjectTagging
• HeadObject
• ListParts

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

Синтаксис

  get-object-attributes
--bucket <value>
--key <value>
[--version-id <value>]
[--max-parts <value>]
[--part-number-marker <value>]
[--sse-customer-algorithm <value>]
[--sse-customer-key <value>]
[--sse-customer-key-md5 <value>]
[--request-payer <value>]
[--expected-bucket-owner <value>]
--object-attributes <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 (строка)

--max-parts (целое число)

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

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

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

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

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

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

--object-attributes (список)

Синтаксис:

"string" "string" ...

Where valid values are:
  ETag
  Checksum
  ObjectParts
  StorageClass
  ObjectSize

--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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую, независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (булево)

Отключить вывод с помощью пэджера.

--cli-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Примеры

Чтобы получить метаданные объекта без возврата самого объекта

Следующий пример get-object-attributes получает метаданные объекта doc1.rtf.

aws s3api get-object-attributes \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf \
    --object-attributes "StorageClass" "ETag" "ObjectSize"

Вывод:

{
    "LastModified": "2022-03-15T19:37:31+00:00",
    "VersionId": "IuCPjXTDzHNfldAuitVBIKJpF2p1fg4P",
    "ETag": "b662d79adeb7c8d787ea7eafb9ef6207",
    "StorageClass": "STANDARD",
    "ObjectSize": 405
}

Дополнительные сведения см. в разделе GetObjectAttributes в справке Amazon S3 API.

Вывод

DeleteMarker -> (boolean)

LastModified -> (timestamp)

VersionId -> (string)

RequestCharged -> (string)

ETag -> (string)

Checksum -> (structure)

ObjectParts -> (structure)

StorageClass -> (string)

ObjectSize -> (long)