describe-job

Описание

Получает параметры конфигурации и состояние задания Batch Operations. Дополнительную информацию см. в разделе S3 Batch Operations в руководстве пользователя Amazon S3.

Разрешения

Для использования операции DescribeJob необходимо иметь разрешение на выполнение действия s3:DescribeJob.

Связанные действия включают:

CreateJob
ListJobs
UpdateJobPriority
UpdateJobStatus

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

Синтаксис

  describe-job
--account-id <value>
--job-id <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]

Параметры

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

Идентификатор учетной записи Amazon Web Services, связанный с заданием S3 Batch Operations.

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

Идентификатор задания, информацию о котором необходимо получить.

--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-auto-prompt (булево)

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

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

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

Примеры

Примечание

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

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

Для описания задания операций Amazon S3 batch

Следующий пример предоставляет параметры конфигурации и состояние указанного задания batch операций.

aws s3control describe-job \
    --account-id 123456789012 \
    --job-id 93735294-df46-44d5-8638-6356f335324e

Вывод:

{
    "Job": {
        "TerminationDate": "2019-10-03T21:49:53.944Z",
        "JobId": "93735294-df46-44d5-8638-6356f335324e",
        "FailureReasons": [],
        "Manifest": {
            "Spec": {
                "Fields": [
                    "Bucket",
                    "Key"
                ],
                "Format": "S3BatchOperations_CSV_20180820"
            },
            "Location": {
                "ETag": "69f52a4e9f797e987155d9c8f5880897",
                "ObjectArn": "arn:aws:s3:::employee-records-logs/inv-report/7a6a9be4-072c-407e-85a2-ec3e982f773e.csv"
            }
        },
        "Operation": {
            "S3PutObjectTagging": {
                "TagSet": [
                    {
                        "Value": "true",
                        "Key": "confidential"
                    }
                ]
            }
        },
        "RoleArn": "arn:aws:iam::123456789012:role/S3BatchJobRole",
        "ProgressSummary": {
            "TotalNumberOfTasks": 8,
            "NumberOfTasksFailed": 0,
            "NumberOfTasksSucceeded": 8
        },
        "Priority": 42,
        "Report": {
            "ReportScope": "AllTasks",
            "Format": "Report_CSV_20180820",
            "Enabled": true,
            "Prefix": "batch-op-create-job",
            "Bucket": "arn:aws:s3:::employee-records-logs"
        },
        "JobArn": "arn:aws:s3:us-west-2:123456789012:job/93735294-df46-44d5-8638-6356f335324e",
        "CreationTime": "2019-10-03T21:48:48.048Z",
        "Status": "Complete"
    }
}

Вывод

Задание -> (структура)

Содержит параметры конфигурации и состояние задания, указанного в запросе Describe Job.

JobId -> (строка)

Идентификатор указанного задания.

ConfirmationRequired -> (булево)

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

Описание -> (строка)

Описание этого задания, если оно было предоставлено в запросе Create Job этого задания.

JobArn -> (строка)

Amazon Resource Name (ARN) для этого задания.

Состояние -> (строка)

Текущее состояние указанного задания.

Манифест -> (структура)

Информация о конфигурации для объекта манифеста указанного задания.

Spec -> (структура)

Описание формата манифеста указанного задания. Если манифест в формате CSV, также описывает столбцы, содержащиеся в манифесте.

Формат -> (строка)

Указывает, какой из доступных форматов использует указанный манифест.

Поля -> (список)

Если указанный объект манифеста имеет формат S3BatchOperations_CSV_20180820, этот элемент описывает, какие столбцы содержат необходимые данные.

(строка)

Расположение -> (структура)

Содержит информацию, необходимую для поиска манифеста указанного задания. Манифесты не могут импортироваться из ведер каталогов. Дополнительную информацию см. в разделе Ведра каталогов.

ObjectArn -> (строка)

Amazon Resource Name (ARN) для объекта манифеста.

Предупреждение

При использовании XML-запросов необходимо заменить специальные символы (такие как символы возврата каретки) в ключах объектов соответствующими кодами сущностей XML. Дополнительную информацию см. в разделе Ограничения ключей объектов, относящихся к XML, в руководстве пользователя Amazon S3.

ObjectVersionId -> (строка)

Необязательный идентификатор версии для идентификации конкретной версии объекта манифеста.

ETag -> (строка)

ETag для указанного объекта манифеста.

Операция -> (структура)

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

LambdaInvoke -> (структура)

Указывает указанной задаче вызвать функцию Lambda для каждого объекта в манифесте.

FunctionArn -> (строка)

Amazon Resource Name (ARN) функции Lambda, которую указанная задача будет вызывать для каждого объекта в манифесте.

InvocationSchemaVersion -> (строка)

Указывает версию схемы для полезной нагрузки, которую Batch Operations отправляет при вызове функции Lambda. Версия 1.0 является по умолчанию. Версия 2.0 требуется, когда вы используете Batch Operations для вызова функций Lambda, которые действуют на ведра каталога, или если вам нужно указать UserArguments . Дополнительную информацию см. в разделе Автоматизация обработки объектов в ведрах каталога Amazon S3 с помощью S3 Batch Operations и Lambda в блоге Amazon Web Services Storage.

Предупреждение

Убедитесь, что ваш код функции Lambda ожидает InvocationSchemaVersion 2.0 и использует имя ведра, а не ARN ведра. Если InvocationSchemaVersion не соответствует тому, чего ожидает ваша функция Lambda, функция может работать некорректно.

Примечание

Ведра каталога - Чтобы инициировать функцию Amazon Web Services Lambda для выполнения пользовательских действий над объектами в ведрах каталога, вы должны указать 2.0 .

UserArguments -> (отображение)

Ключевые пары, которые передаются в полезную нагрузку, которую Batch Operations отправляет при вызове функции Lambda. Вы должны указать InvocationSchemaVersion 2.0 для LambdaInvoke операций, которые включают UserArguments . Дополнительную информацию см. в разделе Автоматизация обработки объектов в ведрах каталога Amazon S3 с помощью S3 Batch Operations и Lambda в блоге Amazon Web Services Storage.

key -> (строка)

value -> (строка)

S3PutObjectCopy -> (структура)

Указывает указанной задаче выполнить вызов копирования объекта PUT для каждого объекта в манифесте.

TargetResource -> (строка)

Указывает целевой Amazon Resource Name (ARN) ведра для операции пакетной копии.

Ведра общего назначения - Например, чтобы скопировать объекты в ведро общего назначения с именем destinationBucket , установите свойство TargetResource в значение arn:aws:s3:::destinationBucket .
Ведра каталога - Например, чтобы скопировать объекты в ведро каталога с именем destinationBucket в зоне доступности, идентифицируемой по идентификатору AZ usw2-az1 , установите свойство TargetResource в значение arn:aws:s3express:*region* :*account_id* :/bucket/*destination_bucket_base_name* --*usw2-az1* --x-s3 . Ведро каталога в качестве целевого ведра может находиться в зоне доступности или локальной зоне.

Примечание

Копирование объектов между различными регионами Amazon Web Services не поддерживается, когда исходное или целевое ведро находится в локальных зонах Amazon Web Services. Источник и целевое ведра должны находиться в одном и том же родительском регионе Amazon Web Services. В противном случае вы получите ошибку HTTP 400 Bad Request с кодом ошибки InvalidRequest .

CannedAccessControlList -> (строка)

Примечание

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

AccessControlGrants -> (список)

Примечание

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

(структура)

Grantee -> (структура)

TypeIdentifier -> (строка)

Identifier -> (строка)

DisplayName -> (строка)

Permission -> (строка)

MetadataDirective -> (строка)

ModifiedSinceConstraint -> (метка времени)

NewObjectMetadata -> (структура)

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

CacheControl -> (строка)

ContentDisposition -> (строка)

ContentEncoding -> (строка)

ContentLanguage -> (строка)

UserMetadata -> (отображение)

key -> (строка)

value -> (строка)

ContentLength -> (длинное целое)

Этот элемент устарел.

ContentMD5 -> (строка)

Этот элемент устарел.

ContentType -> (строка)

HttpExpiresDate -> (метка времени)

RequesterCharged -> (булево)

Этот элемент устарел.

SSEAlgorithm -> (строка)

Алгоритм шифрования на стороне сервера, используемый при хранении объектов в Amazon S3.

Ведра каталога - Для ведер каталога поддерживаются только два варианта шифрования на стороне сервера: шифрование на стороне сервера с управляемыми ключами Amazon S3 (SSE-S3) (AES256 ) и шифрование на стороне сервера с ключами KMS (SSE-KMS) (KMS ). Дополнительную информацию см. в разделе Защита данных с помощью шифрования на стороне сервера в Руководстве пользователя Amazon S3. Для операции копирования в Batch Operations см. S3CopyObjectOperation .

NewObjectTagging -> (список)

Указывает список тегов, которые нужно добавить к целевым объектам после их копирования. Если NewObjectTagging не указан, теги исходных объектов по умолчанию копируются в целевые объекты.

Примечание

Ведра каталога - Теги не поддерживаются ведрами каталога. Если у ваших исходных объектов есть теги, а ваше целевое ведро является ведром каталога, укажите пустой набор тегов в поле NewObjectTagging, чтобы предотвратить копирование тегов исходных объектов в ведро каталога.

(структура)

Контейнер для пары ключ-значение.

Key -> (строка)

Ключ тега

Value -> (строка)

Значение тега

RedirectLocation -> (строка)

Если целевое ведро настроено как веб-сайт, указывает необязательное свойство метаданных для перенаправлений веб-сайтов, x-amz-website-redirect-location . Позволяет перенаправлять веб-страницы, если к копии объекта осуществляется доступ через конечную точку веб-сайта.

Примечание

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

RequesterPays -> (булево)

Примечание

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

StorageClass -> (строка)

Укажите класс хранения для целевых объектов в операции Copy .

Примечание

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

UnModifiedSinceConstraint -> (метка времени)

SSEAwsKmsKeyId -> (строка)

Указывает идентификатор ключа KMS (идентификатор ключа, ARN ключа или псевдоним ключа) для использования при шифровании объектов. Если ключ KMS не существует в том же аккаунте, который выполняет команду, вы должны использовать полный ARN ключа, а не идентификатор ключа.

Примечание

Ведра каталога - Если вы укажете SSEAlgorithm с KMS , вы должны указать параметр SSEAwsKmsKeyId с идентификатором (идентификатор ключа или ARN ключа) управляемого ключа симметричного шифрования KMS для использования. В противном случае вы получите ошибку HTTP 400 Bad Request . Формат псевдонима ключа KMS не поддерживается. Чтобы зашифровать новые копии объектов в ведре каталога с помощью SSE-KMS, вы должны указать SSE-KMS в качестве конфигурации по умолчанию для шифрования ведра каталога с помощью ключа KMS (конкретно, управляемого ключа). Управляемый ключ Amazon Web Services (aws/s3 ) не поддерживается. Ваша конфигурация SSE-KMS может поддерживать только 1 управляемый ключ на ведро каталога на протяжении всего срока службы ведра. После того, как вы укажете управляемый ключ для SSE-KMS в качестве конфигурации по умолчанию для шифрования ведра, вы не можете переопределить управляемый ключ для конфигурации SSE-KMS ведра. Затем, при указании параметров шифрования на стороне сервера для новых копий объектов с SSE-KMS, вы должны убедиться, что ключ шифрования является тем же управляемым ключом, который вы указали для конфигурации шифрования по умолчанию ведра каталога.

TargetKeyPrefix -> (строка)

Указывает префикс папки, в которую вы хотите скопировать объекты. Например, чтобы скопировать объекты в папку с именем Folder1 в целевом ведре, установите свойство TargetKeyPrefix в значение Folder1 .

ObjectLockLegalHoldStatus -> (строка)

Статус юридической блокировки, который будет применен ко всем объектам в задаче Batch Operations.

Примечание

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

ObjectLockMode -> (строка)

Режим хранения, который будет применен ко всем объектам в задаче Batch Operations.

Примечание

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

ObjectLockRetainUntilDate -> (метка времени)

Дата истечения срока действия примененной конфигурации хранения объектов для всех объектов в задаче Batch Operations.

Примечание

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

BucketKeyEnabled -> (булево)

Указывает, должна ли Amazon S3 использовать ключ ведра S3 для шифрования объектов с помощью шифрования на стороне сервера с использованием Amazon Web Services KMS (SSE-KMS). Установка этого заголовка в значение true заставляет Amazon S3 использовать ключ ведра S3 для шифрования объектов с помощью SSE-KMS.

Указание этого заголовка с действием Копировать не влияет на уровневые настройки ключа ведра S3.

Примечание

Ведра каталога - Ключи ведер S3 не поддерживаются, когда вы копируете объекты, зашифрованные с помощью SSE-KMS, из ведер общего назначения в ведра каталога, из ведер каталога в ведра общего назначения или между ведрами каталога с помощью операции копирования в Batch Operations. В этом случае Amazon S3 делает вызов KMS каждый раз, когда выполняется запрос на копирование объекта, зашифрованного с помощью KMS.

ChecksumAlgorithm -> (строка)

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

S3PutObjectAcl -> (структура)

Указывает указанной задаче выполнить вызов PutObjectAcl для каждого объекта в манифесте.

Примечание

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

AccessControlPolicy -> (структура)

AccessControlList -> (структура)

Owner -> (структура)

ID -> (строка)

DisplayName -> (строка)

Grants -> (список)

(структура)

Grantee -> (структура)

TypeIdentifier -> (строка)

Identifier -> (строка)

DisplayName -> (строка)

Permission -> (строка)

CannedAccessControlList -> (строка)

S3PutObjectTagging -> (структура)

Направляет указанную задачу на выполнение вызова маркировки объекта PUT для каждого объекта в манифесте.

Примечание

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

TagSet -> (список)

(структура)

Контейнер для пары имя-значение.

Key -> (строка)

Ключ тега

Value -> (строка)

Значение тега

S3DeleteObjectTagging -> (структура)

Направляет указанную задачу на выполнение вызова удаления маркировки объекта DELETE для каждого объекта в манифесте.

Примечание

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

S3InitiateRestoreObject -> (структура)

Направляет указанную задачу на инициирование запросов восстановления для каждого архивированного объекта в манифесте.

Примечание

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

ExpirationInDays -> (целое число)

Этот аргумент указывает, как долго объект S3 Glacier или S3 Glacier Deep Archive остается доступным в Amazon S3. Задания S3 Initiate Restore Object, нацеленные на объекты S3 Glacier и S3 Glacier Deep Archive, требуют, чтобы ExpirationInDays было установлено в 1 или больше.

Наоборот, не устанавливайте ExpirationInDays при создании заданий S3 Initiate Restore Object, нацеленных на объекты S3 Intelligent-Tiering Archive Access и Deep Archive Access. Объекты в архивных уровнях доступа S3 Intelligent-Tiering не подлежат истечению срока восстановления, поэтому указание ExpirationInDays приведет к ошибке запроса восстановления.

Задания S3 Batch Operations могут работать либо с объектами класса хранения S3 Glacier и S3 Glacier Deep Archive, либо с объектами уровня хранения S3 Intelligent-Tiering Archive Access и Deep Archive Access, но не с обоими типами в одной задаче. Если вам нужно восстановить объекты обоих типов, вы должны создать отдельные задания Batch Operations.

GlacierJobTier -> (строка)

S3 Batch Operations поддерживает типы извлечения STANDARD и BULK, но не тип извлечения EXPEDITED.

S3PutObjectLegalHold -> (структура)

Содержит конфигурацию для операции с юридической удержанием объектов S3, которую задание S3 Batch Operations передает каждому объекту для базовой операции API PutObjectLegalHold. Дополнительную информацию см. в разделе Использование юридического удержания S3 Object Lock с S3 Batch Operations в Руководстве пользователя Amazon S3.

Примечание

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

LegalHold -> (структура)

Содержит состояние юридического удержания Object Lock, которое должно быть применено ко всем объектам в задании Batch Operations.

Status -> (строка)

Статус юридического удержания Object Lock, который должен быть применен ко всем объектам в задании Batch Operations.

S3PutObjectRetention -> (структура)

Содержит параметры конфигурации для действия удержания Object Lock для задания S3 Batch Operations. Batch Operations передает каждый объект для базовой операции API PutObjectRetention. Дополнительную информацию см. в разделе Использование удержания S3 Object Lock с S3 Batch Operations в Руководстве пользователя Amazon S3.

Примечание

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

BypassGovernanceRetention -> (булево)

Указывает, должно ли действие применяться к объектам в задании Batch Operations, даже если для них установлен тип Object Lock GOVERNANCE.

Retention -> (структура)

Содержит режим удержания Object Lock, который должен быть применен ко всем объектам в задании Batch Operations. Дополнительную информацию см. в разделе Использование удержания S3 Object Lock с S3 Batch Operations в Руководстве пользователя Amazon S3.

RetainUntilDate -> (временная метка)

Дата, до которой примененное удержание Object Lock истечет для всех объектов, установленных заданием Batch Operations.

Mode -> (строка)

Режим удержания Object Lock, который должен быть применен ко всем объектам в задании Batch Operations.

S3ReplicateObject -> (структура)

Направляет указанную задачу на вызов ReplicateObject для каждого объекта в манифесте задания.

Примечание

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

Priority -> (целое число)

Приоритет указанной задачи.

ProgressSummary -> (структура)

Описание общего количества задач, выполненных указанным заданием, количества успешно выполненных задач и количества задач, завершившихся ошибкой.

TotalNumberOfTasks -> (длинное целое число)

NumberOfTasksSucceeded -> (длинное целое число)

NumberOfTasksFailed -> (длинное целое число)

Timers -> (структура)

Атрибут JobTimers сводки выполнения задания.

ElapsedTimeInActiveSeconds -> (длинное целое число)

Указывает время, прошедшее в секундах, в котором задание находилось в активном состоянии.

StatusUpdateReason -> (строка)

Причина обновления задания.

FailureReasons -> (список)

Если указанное задание завершилось ошибкой, это поле содержит информацию об ошибке.

(структура)

Если это задание завершилось ошибкой, этот элемент указывает причину ошибки.

FailureCode -> (строка)

Код ошибки, если таковой имеется, для указанного задания.

FailureReason -> (строка)

Причина ошибки, если таковая имеется, для указанного задания.

Report -> (структура)

Содержит конфигурационную информацию для отчета о завершении задания, если вы запросили его в запросе Create Job.

Bucket -> (строка)

Amazon Resource Name (ARN) для ведра, в котором будет храниться указанный отчет о завершении задания.

Примечание

Ведра каталогов - Ведра каталогов не поддерживаются в качестве места хранения отчетов о завершении задания Batch Operations.

Format -> (строка)

Формат указанного отчета о завершении задания.

Enabled -> (булево)

Указывает, будет ли указанное задание генерировать отчет о завершении задания.

Prefix -> (строка)

Необязательный префикс, описывающий, где в указанном ведре будет храниться отчет о завершении задания. Amazon S3 сохраняет отчет о завершении задания по адресу <prefix>/job-<job-id>/report.json.

ReportScope -> (строка)

Указывает, будет ли отчет о завершении задания содержать подробности всех задач или только задач, завершившихся ошибкой.

CreationTime -> (временная метка)

Временная метка, указывающая время создания этого задания.

TerminationDate -> (временная метка)

Временная метка, указывающая время завершения этого задания. Дата завершения задания - это дата и время, когда оно было успешно выполнено, завершилось с ошибкой или было отменено.

RoleArn -> (строка)

Amazon Resource Name (ARN) для роли управления идентификацией и доступом (IAM), назначенной для выполнения задач для этого задания.

SuspendedDate -> (временная метка)

Временная метка, когда это задание было приостановлено, если оно было приостановлено.

SuspendedCause -> (строка)

Причина приостановки указанного задания. Задание приостанавливается только в том случае, если вы создаете его через консоль Amazon S3. При создании задания оно переходит в состояние Suspended, чтобы дождаться подтверждения перед запуском. После подтверждения задания оно автоматически выходит из состояния Suspended.

ManifestGenerator -> (структура помеченных союзов)

Генератор манифеста, используемый для генерации манифеста задания для этого задания.

Примечание

Это структура помеченных объединений. Только один из следующих ключей верхнего уровня может быть установлен: S3JobManifestGenerator.

S3JobManifestGenerator -> (структура)

Детали конфигурации генератора манифеста задания S3.

ExpectedBucketOwner -> (строка)

Идентификатор учетной записи Amazon Web Services, являющейся владельцем ведра, в которое записывается сгенерированный манифест. Если предоставлен, идентификатор учетной записи Amazon Web Services владельца ведра сгенерированного манифеста должен совпадать с этим значением, в противном случае задание завершится ошибкой.

SourceBucket -> (строка)

ARN исходного ведра, используемого генератором манифеста.

Примечание

Ведра каталогов - Ведра каталогов не поддерживаются в качестве исходных ведер, используемых S3JobManifestGenerator для генерации манифеста задания.

ManifestOutputLocation -> (структура)

Указывает расположение, в которое будет записан сгенерированный манифест. Манифесты не могут быть записаны в ведра каталогов. Для получения дополнительной информации см. Ведра каталогов.

ExpectedManifestBucketOwner -> (строка)

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

Bucket -> (строка)

ARN ведра, в которое должен быть записан сгенерированный манифест.

Примечание

Ведра каталогов - Ведра каталогов не поддерживаются в качестве ведер для хранения сгенерированного манифеста.

ManifestPrefix -> (строка)

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

ManifestEncryption -> (структура)

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

SSES3 -> (структура)

Указывает использование SSE-S3 для шифрования сгенерированных объектов манифеста.

SSEKMS -> (структура)

Детали конфигурации использования SSE-KMS для шифрования сгенерированных объектов манифеста.

KeyId -> (строка)

Указывает идентификатор симметричного ключа шифрования управляемого клиентом Amazon Web Services Key Management Service (Amazon Web Services KMS) для шифрования сгенерированных объектов манифеста.

ManifestFormat -> (строка)

Формат сгенерированного манифеста.

Filter -> (структура)

Указывает правила, которые S3JobManifestGenerator должен использовать для определения того, должен ли объект в исходном ведре включаться или исключаться из сгенерированного манифеста задания.

EligibleForReplication -> (булево)

Включать объекты в сгенерированный манифест только в том случае, если они подходят для репликации в соответствии с конфигурацией репликации в исходном ведре.

CreatedAfter -> (временная метка)

Если предоставлено, сгенерированный манифест включает только объекты исходного ведра, созданные после этого времени.

CreatedBefore -> (временная метка)

Если предоставлено, сгенерированный манифест включает только объекты исходного ведра, созданные до этого времени.

ObjectReplicationStatuses -> (список)

Если предоставлено, сгенерированный манифест включает только объекты исходного ведра, которые имеют один из указанных статусов репликации.

(строка)

KeyNameConstraint -> (структура)

Если предоставлено, сгенерированный манифест включает только объекты исходного ведра, ключи объектов которых соответствуют строковым ограничениям, указанным для MatchAnyPrefix , MatchAnySuffix и MatchAnySubstring.

MatchAnyPrefix -> (список)

Если предоставлено, сгенерированный манифест включает объекты, где указанная строка находится в начале строки ключа объекта. Каждый фильтр KeyNameConstraint принимает массив строк длиной 1 строка.

(строка)

MatchAnySuffix -> (список)

Если предоставлено, сгенерированный манифест включает объекты, где указанная строка находится в конце строки ключа объекта. Каждый фильтр KeyNameConstraint принимает массив строк длиной 1 строка.

(строка)

MatchAnySubstring -> (список)

Если предоставлено, сгенерированный манифест включает объекты, где указанная строка находится где-либо в строке ключа объекта. Каждый фильтр KeyNameConstraint принимает массив строк длиной 1 строка.

(строка)

ObjectSizeGreaterThanBytes -> (целое число с плавающей запятой)

Если предоставлено, сгенерированный манифест включает только объекты исходного ведра, размер файла которых больше указанного количества байтов.

ObjectSizeLessThanBytes -> (целое число с плавающей запятой)

Если предоставлено, сгенерированный манифест включает только объекты исходного ведра, размер файла которых меньше указанного количества байтов.

MatchAnyStorageClass -> (список)

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

(строка)

EnableManifestOutput -> (булево)

Определяет, записывать ли сгенерированный манифест задания в ведро.

GeneratedManifestDescriptor -> (структура)

Атрибут JobDescriptor, содержащий сведения о сгенерированном манифесте задания.

Format -> (строка)

Формат сгенерированного манифеста.

Location -> (структура)

Содержит информацию, необходимую для поиска объекта манифеста. Манифесты не могут быть импортированы из ведер каталогов. Для получения дополнительной информации см. Ведра каталогов.

ObjectArn -> (строка)

Amazon Resource Name (ARN) для объекта манифеста.

Предупреждение

При использовании XML-запросов необходимо заменить специальные символы (такие как возврат каретки) в ключах объектов их эквивалентными кодами XML-сущностей. Для получения дополнительной информации см. Ограничения ключей объектов, относящиеся к XML, в Руководстве пользователя Amazon S3.

ObjectVersionId -> (строка)

Необязательный идентификатор версии для идентификации конкретной версии объекта манифеста.

ETag -> (строка)

ETag для указанного объекта манифеста.