Spec-Zone.ru › AWS CLI v2

[ aws . es ]

describe-elasticsearch-domain

Описание

Возвращает информацию о конфигурации указанного домена Elasticsearch, включая идентификатор домена, конечную точку домена и ARN домена.

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

Синтаксис

  describe-elasticsearch-domain
--domain-name <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]

Параметры

--domain-name (строка)

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

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

Примеры

Примечание

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

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

Для получения деталей для одного домена

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

aws es describe-elasticsearch-domain \
    --domain-name cli-example

Вывод:

{
    "DomainStatus": {
        "DomainId": "123456789012/cli-example",
        "DomainName": "cli-example",
        "ARN": "arn:aws:es:us-east-1:123456789012:domain/cli-example",
        "Created": true,
        "Deleted": false,
        "Endpoint": "search-cli-example-1a2a3a4a5a6a7a8a9a0a.us-east-1.es.amazonaws.com",
        "Processing": false,
        "UpgradeProcessing": false,
        "ElasticsearchVersion": "7.4",
        "ElasticsearchClusterConfig": {
            "InstanceType": "c5.large.elasticsearch",
            "InstanceCount": 1,
            "DedicatedMasterEnabled": true,
            "ZoneAwarenessEnabled": false,
            "DedicatedMasterType": "c5.large.elasticsearch",
            "DedicatedMasterCount": 3,
            "WarmEnabled": true,
            "WarmType": "ultrawarm1.medium.elasticsearch",
            "WarmCount": 2
        },
        "EBSOptions": {
            "EBSEnabled": true,
            "VolumeType": "gp2",
            "VolumeSize": 10
        },
        "AccessPolicies": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"*\"},\"Action\":\"es:*\",\"Resource\":\"arn:aws:es:us-east-1:123456789012:domain/cli-example/*\"}]}",
        "SnapshotOptions": {
            "AutomatedSnapshotStartHour": 0
        },
        "CognitoOptions": {
            "Enabled": false
        },
        "EncryptionAtRestOptions": {
            "Enabled": true,
            "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/1a2a3a4a-1a2a-1a2a-1a2a-1a2a3a4a5a6a"
        },
        "NodeToNodeEncryptionOptions": {
            "Enabled": true
        },
        "AdvancedOptions": {
            "rest.action.multi.allow_explicit_index": "true"
        },
        "ServiceSoftwareOptions": {
            "CurrentVersion": "R20200522",
            "NewVersion": "",
            "UpdateAvailable": false,
            "Cancellable": false,
            "UpdateStatus": "COMPLETED",
            "Description": "There is no software update available for this domain.",
            "AutomatedUpdateDate": 0.0
        },
        "DomainEndpointOptions": {
            "EnforceHTTPS": true,
            "TLSSecurityPolicy": "Policy-Min-TLS-1-0-2019-07"
        },
        "AdvancedSecurityOptions": {
            "Enabled": true,
            "InternalUserDatabaseEnabled": true
        }
    }
}

Для получения дополнительной информации см. Создание и управление доменными именами Amazon Elasticsearch Service в руководстве разработчика Amazon Elasticsearch Service.

Вывод

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

Текущий статус домена Elasticsearch.

DomainId -> (строка)

Уникальный идентификатор указанного домена Elasticsearch.

DomainName -> (строка)

Имя домена Elasticsearch. Имена доменов уникальны для доменов, принадлежащих учетной записи в регионе AWS. Имена доменов начинаются с буквы или цифры и могут содержать следующие символы: a-z (строчные буквы), 0-9 и - (тире).

ARN -> (строка)

Amazon Resource Name (ARN) домена Elasticsearch. Дополнительную информацию см. в разделе «Идентификаторы сущностей IAM» в документе «Использование AWS Identity and Access Management».

Created -> (логическое значение)

Статус создания домена. True, если создание домена Elasticsearch завершено. False, если создание домена все еще в процессе.

Deleted -> (логическое значение)

Статус удаления домена. True, если для домена получен запрос на удаление, но очистка ресурсов все еще в процессе. False, если домен не был удален. После завершения удаления домена его статус больше не возвращается.

Endpoint -> (строка)

Конечная точка домена Elasticsearch, которую вы используете для отправки запросов индексирования и поиска.

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

Таблица, содержащая конечные точки домена Elasticsearch, используемые для отправки запросов индексирования и поиска. Пример key, value : 'vpc','vpc-endpoint-h2dsd34efgyghrtguk5gt6j2foh4.us-east-1.es.amazonaws.com' .

ключ -> (строка)

значение -> (строка)

Конечная точка, в которую отправляются запросы к сервису. Например, search-imdb-movies-oopcnjfn6ugofer3zx5iadxxca.eu-west-1.es.amazonaws.com или doc-imdb-movies-oopcnjfn6ugofer3zx5iadxxca.eu-west-1.es.amazonaws.com .

Processing -> (логическое значение)

Статус конфигурации домена Elasticsearch. True, если Amazon Elasticsearch Service обрабатывает изменения конфигурации. False, если конфигурация активна.

UpgradeProcessing -> (логическое значение)

Статус обновления версии домена Elasticsearch. True, если Amazon Elasticsearch Service выполняет обновление версии. False, если конфигурация активна.

ElasticsearchVersion -> (строка)

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

Тип и количество экземпляров в кластере домена.

InstanceType -> (строка)

Тип экземпляра для кластера Elasticsearch. Типы экземпляров UltraWarm не поддерживаются для экземпляров данных.

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

Количество экземпляров в указанном кластере домена.

DedicatedMasterEnabled -> (логическое значение)

Логическое значение, указывающее, включен ли выделенный мастер-узел. Дополнительную информацию см. в разделе «О выделенных мастер-узлах».

ZoneAwarenessEnabled -> (логическое значение)

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

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

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

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

Целое число, указывающее количество зон доступности для домена, когда зональная осведомленность включена. Это значение должно быть равно количеству подсетей, если включены VPC-конечные точки.

DedicatedMasterType -> (строка)

Тип экземпляра для выделенного мастер-узла.

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

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

WarmEnabled -> (логическое значение)

Истина для включения теплового хранилища.

WarmType -> (строка)

Тип экземпляра для узлов теплового хранилища кластера Elasticsearch.

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

Количество тепловых узлов в кластере.

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

Указывает конфигурацию ColdStorageOptions для домена Elasticsearch

Enabled -> (логическое значение)

Включить опцию холодного хранилища. Допускаются значения true или false

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

EBSOptions для указанного домена. Дополнительную информацию см. в разделе «Настройка хранилища на основе EBS».

EBSEnabled -> (логическое значение)

Указывает, включено ли хранилище на основе EBS.

VolumeType -> (строка)

Указывает тип тома для хранилища на основе EBS.

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

Целое число для указания размера тома EBS.

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

Указывает IOPS для томов EBS с предварительно заданным IOPS и GP3 (SSD).

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

Указывает пропускную способность для томов EBS GP3 (SSD).

AccessPolicies -> (строка)

Политика доступа IAM в формате JSON.

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

Указывает статус SnapshotOptions

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

Указывает время в формате UTC, когда служба выполняет ежедневный автоматический снимок указанного домена Elasticsearch. Значение по умолчанию — 0 часа.

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

VPCOptions для указанного домена. Дополнительную информацию см. в разделе «VPC-конечные точки для доменов Amazon Elasticsearch Service».

VPCId -> (строка)

Идентификатор VPC для домена Elasticsearch. Существует только в том случае, если домен был создан с использованием VPCOptions.

SubnetIds -> (список)

Указывает подсети для VPC-конечной точки.

(строка)

AvailabilityZones -> (список)

Зоны доступности для домена Elasticsearch. Существуют только в том случае, если домен был создан с использованием VPCOptions.

(строка)

SecurityGroupIds -> (список)

Указывает группы безопасности для VPC-конечной точки.

(строка)

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

CognitoOptions для указанного домена. Дополнительную информацию см. в разделе «Аутентификация Amazon Cognito для Kibana».

Enabled -> (логическое значение)

Указывает опцию включения Cognito для аутентификации Kibana.

UserPoolId -> (строка)

Указывает идентификатор пула пользователей Cognito для аутентификации Kibana.

IdentityPoolId -> (строка)

Указывает идентификатор пула идентификаторов Cognito для аутентификации Kibana.

RoleArn -> (строка)

Указывает ARN роли, предоставляющей разрешения Elasticsearch для доступа к ресурсам Cognito.

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

Указывает состояние EncryptionAtRestOptions

Enabled -> (логическое значение)

Указывает опцию включения шифрования при хранении.

KmsKeyId -> (строка)

Указывает идентификатор ключа KMS для опций шифрования при хранении.

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

Указывает состояние NodeToNodeEncryptionOptions

Enabled -> (логическое значение)

Укажите true для включения шифрования между узлами.

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

Указывает состояние AdvancedOptions

ключ -> (строка)

значение -> (строка)

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

Параметры публикации логов для данного домена.

ключ -> (строка)

Тип файла журнала, может быть одним из следующих:

  • INDEX_SLOW_LOGS: Журналы медленных запросов индексирования содержат запросы вставки, которые выполнялись дольше, чем пороговое значение для журнала запросов индексирования.
  • SEARCH_SLOW_LOGS: Журналы медленных запросов поиска содержат запросы поиска, которые выполнялись дольше, чем пороговое значение для журнала запросов поиска.
  • ES_APPLICATION_LOGS: Журналы приложений Elasticsearch содержат информацию об ошибках и предупреждениях, возникших во время работы сервиса, и могут быть полезны для устранения неполадок.
  • AUDIT_LOGS: Аудит журналов содержит записи о пользовательских запросах доступа к домену.

значение -> (структура)

Параметр публикации логов, установленный для данного домена. Атрибуты и их подробности:

  • CloudWatchLogsLogGroupArn: ARN группы журналов CloudWatch, в которую необходимо опубликовать лог.
  • Enabled: Включена ли публикация логов для данного типа логов

CloudWatchLogsLogGroupArn -> (строка)

ARN группы журналов CloudWatch, в которую необходимо опубликовать лог.

Enabled -> (логическое значение)

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

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

Текущий статус программного обеспечения службы домена Elasticsearch.

CurrentVersion -> (строка)

Текущая версия программного обеспечения службы, присутствующая в домене.

NewVersion -> (строка)

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

UpdateAvailable -> (логическое значение)

True, если вы можете обновить версию программного обеспечения службы. False, если вы не можете обновить версию программного обеспечения службы.

Cancellable -> (логическое значение)

True, если вы можете отменить обновление версии программного обеспечения службы. False, если вы не можете отменить обновление версии программного обеспечения службы.

UpdateStatus -> (строка)

Статус обновления программного обеспечения службы. Это поле может принимать следующие значения: ELIGIBLE , PENDING_UPDATE , IN_PROGRESS , COMPLETED и NOT_ELIGIBLE .

Description -> (строка)

Описание UpdateStatus

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

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

OptionalDeployment -> (логическое значение)

True, если программное обеспечение службы никогда не обновляется автоматически. False, если программное обеспечение службы обновляется автоматически после AutomatedUpdateDate .

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

Текущий статус параметров конечной точки домена Elasticsearch.

EnforceHTTPS -> (логическое значение)

Указать, должна ли быть включена только конечная точка HTTPS для домена Elasticsearch.

TLSSecurityPolicy -> (строка)

Укажите политику безопасности TLS, которую необходимо применить к конечной точке HTTPS домена Elasticsearch. Она может быть одним из следующих значений:

  • Policy-Min-TLS-1-0-2019-07: Политика безопасности TLS, поддерживающая версии TLS 1.0 до TLS 1.2
  • Policy-Min-TLS-1-2-2019-07: Политика безопасности TLS, поддерживающая только версию TLS 1.2
  • Policy-Min-TLS-1-2-PFS-2023-10: Политика безопасности TLS, поддерживающая версии TLS 1.2 до TLS 1.3 с совершенной прямой секретностью криптографических блоков

CustomEndpointEnabled -> (логическое значение)

Указать, должна ли быть включена пользовательская конечная точка для домена Elasticsearch.

CustomEndpoint -> (строка)

Указать полностью квалифицированное доменное имя для вашей пользовательской конечной точки.

CustomEndpointCertificateArn -> (строка)

Указать ARN сертификата ACM для вашей пользовательской конечной точки.

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

Текущий статус расширенных параметров безопасности домена Elasticsearch.

Enabled -> (boolean)

Истинно, если расширенная безопасность включена.

InternalUserDatabaseEnabled -> (boolean)

Истинно, если база данных внутренних пользователей включена.

SAMLOptions -> (structure)

Описание приложения SAML, настроенного для домена.

Enabled -> (boolean)

Истинно, если SAML включен.

Idp -> (structure)

Описание информации поставщика идентификации SAML.

MetadataContent -> (string)

Метаданные приложения SAML в формате xml.

EntityId -> (string)

Уникальный идентификатор сущности приложения в поставщике идентификации SAML.

SubjectKey -> (string)

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

RolesKey -> (string)

Ключ, используемый для сопоставления атрибута ролей SAML.

SessionTimeoutMinutes -> (integer)

Длительность в минутах, после которой сессия пользователя становится неактивной.

AnonymousAuthDisableDate -> (timestamp)

Указывает дату отключения анонимной авторизации, когда анонимная авторизация включена.

AnonymousAuthEnabled -> (boolean)

Истинно, если анонимная авторизация включена. Анонимная авторизация может быть включена только при включенной AdvancedSecurity в существующих доменах.

AutoTuneOptions -> (structure)

Текущий статус параметров Авто-Настройки домена Elasticsearch.

State -> (string)

Указывает состояние для домена Elasticsearch.

ErrorMessage -> (string)

Указывает сообщение об ошибке при включении или выключении Авто-Настройки.

ChangeProgressDetails -> (structure)

Указывает подробности изменений конфигурации домена.

ChangeId -> (string)

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

Message -> (string)

Содержит необязательное сообщение, связанное с изменением конфигурации домена.

ConfigChangeStatus -> (string)

Текущий статус изменения конфигурации.

StartTime -> (timestamp)

Время инициирования изменения конфигурации в универсальном координированном времени (UTC).

LastUpdatedTime -> (timestamp)

Последнее время обновления изменения конфигурации.

InitiatedBy -> (string)

Принципал IAM, инициировавший изменение конфигурации.

DomainProcessingStatus -> (string)

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

ModifyingProperties -> (list)

Информация о свойствах домена, которые в настоящее время изменяются.

(structure)

Информация о свойствах домена, которые в настоящее время изменяются.

Name -> (string)

Имя свойства, которое в настоящее время изменяется.

ActiveValue -> (string)

Текущее значение свойства домена, которое изменяется.

PendingValue -> (string)

Значение, которое свойство в конечном итоге получит.

ValueType -> (string)

Тип значения, который в настоящее время изменяется. Свойства могут иметь два типа:

  • PLAIN_TEXT: Содержат прямые значения, такие как "1", "True" или "c5.large.search".
  • STRINGIFIED_JSON: Содержат содержимое в формате JSON, например {“Enabled”:”True”}”.

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

Spec-Zone.ru

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