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 (строка)
--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 -> (строка)
DomainName -> (строка)
ARN -> (строка)
Created -> (логическое значение)
True, если создание домена Elasticsearch завершено. False, если создание домена все еще в процессе.Deleted -> (логическое значение)
True, если для домена получен запрос на удаление, но очистка ресурсов все еще в процессе. False, если домен не был удален. После завершения удаления домена его статус больше не возвращается.Endpoint -> (строка)
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 -> (логическое значение)
True, если Amazon Elasticsearch Service обрабатывает изменения конфигурации. False, если конфигурация активна.UpgradeProcessing -> (логическое значение)
True, если Amazon Elasticsearch Service выполняет обновление версии. False, если конфигурация активна.ElasticsearchVersion -> (строка)
ElasticsearchClusterConfig -> (структура)
Тип и количество экземпляров в кластере домена.
InstanceType -> (строка)
InstanceCount -> (целое число)
DedicatedMasterEnabled -> (логическое значение)
ZoneAwarenessEnabled -> (логическое значение)
ZoneAwarenessConfig -> (структура)
Указывает конфигурацию зональной осведомленности для домена, когда зональная осведомленность включена.
AvailabilityZoneCount -> (целое число)
DedicatedMasterType -> (строка)
DedicatedMasterCount -> (целое число)
WarmEnabled -> (логическое значение)
WarmType -> (строка)
WarmCount -> (целое число)
ColdStorageOptions -> (структура)
Указывает конфигурацию ColdStorageOptions для домена Elasticsearch
Enabled -> (логическое значение)
EBSOptions -> (структура)
EBSOptions для указанного домена. Дополнительную информацию см. в разделе «Настройка хранилища на основе EBS».
EBSEnabled -> (логическое значение)
VolumeType -> (строка)
VolumeSize -> (целое число)
Iops -> (целое число)
Throughput -> (целое число)
AccessPolicies -> (строка)
SnapshotOptions -> (структура)
Указывает статус SnapshotOptions
AutomatedSnapshotStartHour -> (целое число)
0 часа.VPCOptions -> (структура)
VPCOptions для указанного домена. Дополнительную информацию см. в разделе «VPC-конечные точки для доменов Amazon Elasticsearch Service».
VPCId -> (строка)
SubnetIds -> (список)
Указывает подсети для VPC-конечной точки.
(строка)
AvailabilityZones -> (список)
Зоны доступности для домена Elasticsearch. Существуют только в том случае, если домен был создан с использованием VPCOptions.
(строка)
SecurityGroupIds -> (список)
Указывает группы безопасности для VPC-конечной точки.
(строка)
CognitoOptions -> (структура)
CognitoOptions для указанного домена. Дополнительную информацию см. в разделе «Аутентификация Amazon Cognito для Kibana».
Enabled -> (логическое значение)
UserPoolId -> (строка)
IdentityPoolId -> (строка)
RoleArn -> (строка)
EncryptionAtRestOptions -> (структура)
Указывает состояние EncryptionAtRestOptions
Enabled -> (логическое значение)
KmsKeyId -> (строка)
NodeToNodeEncryptionOptions -> (структура)
Указывает состояние NodeToNodeEncryptionOptions
Enabled -> (логическое значение)
AdvancedOptions -> (отображение)
Указывает состояние AdvancedOptions
ключ -> (строка)
значение -> (строка)
LogPublishingOptions -> (отображение)
Параметры публикации логов для данного домена.
ключ -> (строка)
Тип файла журнала, может быть одним из следующих:
- INDEX_SLOW_LOGS: Журналы медленных запросов индексирования содержат запросы вставки, которые выполнялись дольше, чем пороговое значение для журнала запросов индексирования.
- SEARCH_SLOW_LOGS: Журналы медленных запросов поиска содержат запросы поиска, которые выполнялись дольше, чем пороговое значение для журнала запросов поиска.
- ES_APPLICATION_LOGS: Журналы приложений Elasticsearch содержат информацию об ошибках и предупреждениях, возникших во время работы сервиса, и могут быть полезны для устранения неполадок.
- AUDIT_LOGS: Аудит журналов содержит записи о пользовательских запросах доступа к домену.
значение -> (структура)
Параметр публикации логов, установленный для данного домена. Атрибуты и их подробности:
- CloudWatchLogsLogGroupArn: ARN группы журналов CloudWatch, в которую необходимо опубликовать лог.
- Enabled: Включена ли публикация логов для данного типа логов
CloudWatchLogsLogGroupArn -> (строка)
Enabled -> (логическое значение)
ServiceSoftwareOptions -> (структура)
Текущий статус программного обеспечения службы домена Elasticsearch.
CurrentVersion -> (строка)
NewVersion -> (строка)
UpdateAvailable -> (логическое значение)
True, если вы можете обновить версию программного обеспечения службы. False, если вы не можете обновить версию программного обеспечения службы.Cancellable -> (логическое значение)
True, если вы можете отменить обновление версии программного обеспечения службы. False, если вы не можете отменить обновление версии программного обеспечения службы.UpdateStatus -> (строка)
ELIGIBLE , PENDING_UPDATE , IN_PROGRESS , COMPLETED и NOT_ELIGIBLE .Description -> (строка)
UpdateStatusAutomatedUpdateDate -> (метка времени)
OptionalDeployment -> (логическое значение)
True, если программное обеспечение службы никогда не обновляется автоматически. False, если программное обеспечение службы обновляется автоматически после AutomatedUpdateDate .DomainEndpointOptions -> (структура)
Текущий статус параметров конечной точки домена Elasticsearch.
EnforceHTTPS -> (логическое значение)
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 -> (логическое значение)
CustomEndpoint -> (строка)
CustomEndpointCertificateArn -> (строка)
AdvancedSecurityOptions -> (структура)
Текущий статус расширенных параметров безопасности домена Elasticsearch.
Enabled -> (boolean)
InternalUserDatabaseEnabled -> (boolean)
SAMLOptions -> (structure)
Описание приложения SAML, настроенного для домена.
Enabled -> (boolean)
Idp -> (structure)
Описание информации поставщика идентификации SAML.
MetadataContent -> (string)
EntityId -> (string)
SubjectKey -> (string)
RolesKey -> (string)
SessionTimeoutMinutes -> (integer)
AnonymousAuthDisableDate -> (timestamp)
AnonymousAuthEnabled -> (boolean)
AutoTuneOptions -> (structure)
Текущий статус параметров Авто-Настройки домена Elasticsearch.
State -> (string)
ErrorMessage -> (string)
ChangeProgressDetails -> (structure)
Указывает подробности изменений конфигурации домена.
ChangeId -> (string)
Message -> (string)
ConfigChangeStatus -> (string)
StartTime -> (timestamp)
LastUpdatedTime -> (timestamp)
InitiatedBy -> (string)
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.