Spec-Zone.ru › AWS CLI v2

[ aws . athena ]

get-work-group

Описание

Возвращает информацию о группе задач с указанным именем.

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

Синтаксис

  get-work-group
--work-group <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]

Параметры

--work-group (строка)

Имя группы задач.

--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 (строка)

Регион для использования. Переопределяет настройки config/env.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/отключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл с набором сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки config/env.

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

Для возврата информации о группе задач

Следующий get-work-group пример возвращает информацию о AthenaAdmin группе задач.

aws athena get-work-group \
    --work-group AthenaAdmin

Вывод:

{
    "WorkGroup": {
        "Name": "AthenaAdmin",
        "State": "ENABLED",
        "Configuration": {
            "ResultConfiguration": {
                "OutputLocation": "s3://amzn-s3-demo-bucket/"
            },
            "EnforceWorkGroupConfiguration": false,
            "PublishCloudWatchMetricsEnabled": true,
            "RequesterPaysEnabled": false
        },
        "Description": "Workgroup for Athena administrators",
        "CreationTime": 1573677174.105
    }
}

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

Вывод

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

Информация о группе работы.

Имя -> (строка)

Имя группы работы.

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

Состояние группы работы: ВКЛЮЧЕНО или ВЫКЛЮЧЕНО.

Настройка -> (структура)

Настройка группы работы, включающая расположение в Amazon S3, где хранятся результаты запросов и вычислений, конфигурацию шифрования, если таковая используется для результатов запросов и вычислений; включены ли метрики Amazon CloudWatch для группы работы; переопределяют ли настройки группы работы клиентские настройки; и ограничения использования данных для объема данных, сканируемых за запрос или за работу группы. Переопределение настроек группы указано в EnforceWorkGroupConfiguration (true/false) в WorkGroupConfiguration. См. WorkGroupConfiguration$EnforceWorkGroupConfiguration.

Конфигурация результатов -> (структура)

Конфигурация для группы работы, включающая расположение в Amazon S3, где хранятся результаты запросов и вычислений, и вариант шифрования, если таковой используется для результатов запросов и вычислений. Для выполнения запроса необходимо указать расположение результатов запроса одним из способов: либо в группе работы с помощью этого параметра, либо для отдельных запросов (со стороны клиента) с использованием ResultConfiguration$OutputLocation. Если ни один из них не задан, Athena выдает ошибку, что расположение вывода не указано.

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

Расположение в Amazon S3, где хранятся результаты запросов и вычислений, например, s3://path/to/query/bucket/. Для выполнения запроса необходимо указать расположение результатов запроса одним из способов: либо для отдельных запросов, используя этот параметр (со стороны клиента), либо в группе работы, используя WorkGroupConfiguration. Если ни один из них не задан, Athena выдает ошибку, что расположение вывода не указано. Если настройки группы работы переопределяют клиентские настройки, запрос использует настройки, указанные для группы работы. См. WorkGroupConfiguration$EnforceWorkGroupConfiguration.

Конфигурация шифрования -> (структура)

Если результаты запросов и вычислений шифруются в Amazon S3, указывается используемый вариант шифрования (например, SSE_KMS или CSE_KMS ) и информация о ключе. Это настройка со стороны клиента. Если настройки группы работы переопределяют клиентские настройки, запрос использует конфигурацию шифрования, указанную для группы работы, а также расположение для хранения результатов запросов, указанное в группе работы. См. WorkGroupConfiguration$EnforceWorkGroupConfiguration и Переопределение настроек группы работы клиентскими настройками.

Вариант шифрования -> (строка)

Указывает, используется ли шифрование Amazon S3 на сервере с использованием ключей Amazon S3 (SSE_S3), шифрование на сервере с использованием ключей KMS (SSE_KMS) или шифрование на стороне клиента с использованием ключей KMS (CSE_KMS).

Если запрос выполняется в группе работы, и группа работы переопределяет клиентские настройки, то используется настройка шифрования группы работы. Она определяет, должны ли результаты запросов шифроваться для всех запросов, выполняемых в этой группе работы.

KmsKey -> (строка)

Для SSE_KMS и CSE_KMS это ARN или идентификатор ключа KMS.

Ожидаемый владелец ведра -> (строка)

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

Это настройка со стороны клиента. Если настройки группы работы переопределяют клиентские настройки, запрос использует настройку ExpectedBucketOwner, указанную для группы работы, а также использует расположение для хранения результатов запросов, указанное в группе работы. См. WorkGroupConfiguration$EnforceWorkGroupConfiguration и Переопределение настроек группы работы клиентскими настройками.

Конфигурация ACL -> (структура)

Указывает, что для управления владением хранимыми результатами запросов должна быть установлена предварительно заданная ACL Amazon S3. В настоящее время единственная поддерживаемая предварительно заданная ACL - BUCKET_OWNER_FULL_CONTROL. Это настройка со стороны клиента. Если настройки группы работы переопределяют клиентские настройки, запрос использует конфигурацию ACL, указанную для группы работы, а также использует расположение для хранения результатов запросов, указанное в группе работы. Дополнительную информацию см. в WorkGroupConfiguration$EnforceWorkGroupConfiguration и Переопределение настроек группы работы клиентскими настройками.

Вариант ACL S3 -> (строка)

Предварительно заданная ACL Amazon S3, которую Athena должна указать при хранении результатов запросов, включая файлы данных, вставленные Athena в результате операторов, таких как CTAS или INSERT INTO. В настоящее время единственная поддерживаемая предварительно заданная ACL - BUCKET_OWNER_FULL_CONTROL. Если запрос выполняется в группе работы и группа работы переопределяет клиентские настройки, то предварительно заданная ACL Amazon S3, указанная в настройках группы работы, используется для всех запросов, выполняемых в группе работы. Дополнительную информацию о предварительно заданных ACL Amazon S3 см. в разделе Предварительно заданные ACL в Руководстве пользователя Amazon S3.

EnforceWorkGroupConfiguration -> (логическое)

Если установлено «true», настройки группы работы переопределяют клиентские настройки. Если установлено «false», используются клиентские настройки. Дополнительную информацию см. в разделе Переопределение настроек группы работы клиентскими настройками.

PublishCloudWatchMetricsEnabled -> (логическое)

Указывает, что метрики Amazon CloudWatch включены для группы работы.

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

Верхнее ограничение использования данных (отсечка) для количества байтов, которые может отсканировать один запрос в группе работы.

RequesterPaysEnabled -> (логическое)

Если установлено true, позволяет членам, назначенным в группу работы, ссылаться на ведра Amazon S3 Requester Pays в запросах. Если установлено false, члены группы работы не могут запрашивать данные из ведер Requester Pays, и запросы, которые извлекают данные из ведер Requester Pays, вызывают ошибку. По умолчанию установлено false. Дополнительную информацию о ведрах Requester Pays см. в разделе Ведра Requester Pays в Руководстве разработчика Amazon Simple Storage Service.

Версия движка -> (структура)

Версия движка, которую используют все запросы, выполняемые в группе работы. Запросы в группе работы AmazonAthenaPreviewFunctionality выполняются на предварительном движке независимо от этой настройки.

SelectedEngineVersion -> (строка)

Версия движка, запрошенная пользователем. Возможные значения определяются выводом ListEngineVersions, включая AUTO. По умолчанию установлено AUTO.

EffectiveEngineVersion -> (строка)

Только для чтения. Версия движка, на которой выполняется запрос. Если пользователь запрашивает допустимую версию движка, отличную от Авто, эффективная версия движка совпадает с версией движка, запрошенной пользователем. Если пользователь запрашивает Авто, эффективная версия движка выбирается Athena. Когда запрос на обновление версии движка выполняется операцией CreateWorkGroup или UpdateWorkGroup, поле EffectiveEngineVersion игнорируется.

Дополнительная конфигурация -> (строка)

Указывает строку JSON с пользовательским определением, передаваемую движку ноутбука.

Роль выполнения -> (строка)

ARN роли выполнения, используемой для доступа к ресурсам пользователя для сеансов Spark и групп работы, поддерживающих IAM Identity Center. Этот параметр применяется только к группам работы, поддерживающим Spark и IAM Identity Center. Этот параметр обязателен для групп работы, поддерживающих IAM Identity Center.

Конфигурация шифрования контента клиента -> (структура)

Указывает ключ KMS, используемый для шифрования хранилищ данных пользователя в Athena. Этот параметр не применяется к группам работы Athena SQL.

KmsKey -> (строка)

Управляемый клиентом ключ KMS, используемый для шифрования хранилищ данных пользователя в Athena.

Включить минимальную конфигурацию шифрования -> (логическое)

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

Настройка EnforceWorkGroupConfiguration имеет приоритет над флагом EnableMinimumEncryptionConfiguration. Это означает, что если EnforceWorkGroupConfiguration равно true, флаг EnableMinimumEncryptionConfiguration игнорируется, и используется конфигурация шифрования группы работы.

Конфигурация Identity Center -> (структура)

Указывает, поддерживает ли группа работы IAM Identity Center.

Включить Identity Center -> (логическое)

Указывает, поддерживает ли группа работы IAM Identity Center.

IdentityCenterInstanceArn -> (строка)

ARN экземпляра IAM Identity Center, связанного с группой работы.

Конфигурация предоставления доступа к результатам запросов в S3 -> (структура)

Указывает, включены ли разрешения доступа к Amazon S3 для результатов запросов.

Включить предоставление доступа к S3 -> (логическое)

Указывает, включены ли разрешения доступа к Amazon S3 для результатов запросов.

Создать префикс уровня пользователя -> (логическое)

При включении добавляет идентификатор пользователя как префикс пути Amazon S3 к расположению вывода результатов запроса.

Тип аутентификации -> (строка)

Тип аутентификации, используемый для предоставления доступа к Amazon S3. В настоящее время поддерживается только DIRECTORY_IDENTITY.

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

Описание группы работы.

Время создания -> (отметка времени)

Дата и время создания группы работы.

IdentityCenterApplicationArn -> (строка)

ARN приложения IAM Identity Center, связанного с группой работы.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API