Amazon Elasticsearch Service 구성 API 참조 - Amazon Elasticsearch Service

Amazon Elasticsearch Service 구성 API 참조

이 참조에서는 Amazon Elasticsearch Service 구성 API에서의 작업, 데이터 형식 및 오류에 대해 설명합니다. 구성 API는 HTTP를 통해 Amazon ES 도메인을 만들고 구성하는 데 사용할 수 있는 REST API입니다. 또한 AWS CLI 및 콘솔을 사용하여 Amazon ES 도메인을 구성할 수도 있습니다. 자세한 내용은 Amazon ES 도메인 생성 및 구성 단원을 참조하십시오.

작업

다음 표에는 Amazon Elasticsearch Service 구성 API에 대한 REST 인터페이스의 각 작업에 필요한 HTTP 메서드에 대한 빠른 참조가 나와 있습니다. 각 작업에 대한 설명에는 필요한 HTTP 메서드도 포함되어 있습니다.

참고

모든 구성 서비스 요청에는 서명이 되어 있어야 합니다. 자세한 내용은 이 설명서의 Amazon Elasticsearch 서비스 요청 서명AWS General Reference서명 버전 4 서명 프로세스 단원을 참조하십시오.

AcceptInboundCrossClusterSearchConnection

대상 도메인 소유자가 인바운드 클러스터 간 검색 연결 요청을 수락할 수 있도록 허용합니다.

구문

PUT https://es.us-east-1.amazonaws.com/2015-01-01/es/ccs/inboundConnection/{ConnectionId}/accept

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
CrossClusterSearchConnection 객체 인바운드 연결 세부 정보입니다.

AddTags

Amazon ES 도메인에 리소스 태그를 연결합니다. 자세한 내용은 Amazon ES 도메인 태깅을 참조하십시오.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/tags { "ARN": "domain-arn", "TagList": [{ "Key": "tag-key", "Value": "tag-value" }] }

요청 파라미터

이 작업은 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
TagList TagList 리소스 태그 목록.
ARN ARN 리소스 태그를 연결하려는 Amazon ES 도메인의 ARN(Amazon 리소스 이름)입니다.

응답 요소

AddTags 작업이 데이터 구조를 반환하지 않습니다.

AssociatePackage

패키지를 Amazon ES 도메인에 연결합니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/packages/associate/package-id/domain-name

요청 파라미터

파라미터 데이터 형식 필수? 설명
PackageID 문자열 도메인에 연결할 패키지의 내부 ID입니다. 이 값을 확인하려면 DescribePackages를 사용합니다.
DomainName DomainName 패키지를 연결할 도메인의 이름입니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식
DomainPackageDetails DomainPackageDetails

CreateElasticsearchDomain

Amazon ES 도메인을 생성합니다. 자세한 내용은 Amazon ES 도메인 생성 단원을 참조하십시오.

참고

Amazon ES 도메인을 만들려고 하는데 같은 이름의 도메인이 이미 존재하는 경우, API는 오류를 보고하지 않습니다. 그 대신 기존 도메인에 대한 세부 정보가 표시됩니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/es/domain { "ElasticsearchClusterConfig": { "ZoneAwarenessConfig": { "AvailabilityZoneCount": 3 }, "ZoneAwarenessEnabled": true|false, "InstanceCount": 3, "DedicatedMasterEnabled": true|false, "DedicatedMasterType": "c5.large.elasticsearch", "DedicatedMasterCount": 3, "InstanceType": "r5.large.elasticsearch", "WarmCount": 3, "WarmEnabled": true|false, "WarmType": "ultrawarm1.large.elasticsearch" }, "EBSOptions": { "EBSEnabled": true|false, "VolumeType": "io1|gp2|standard", "Iops": 1000, "VolumeSize": 35 }, "EncryptionAtRestOptions": { "Enabled": true|false, "KmsKeyId":"arn:aws:kms:us-east-1:123456789012:alias/my-key" }, "SnapshotOptions": { "AutomatedSnapshotStartHour": 3 }, "VPCOptions": { "VPCId": "vpc-12345678", "SubnetIds": ["subnet-abcdefg1", "subnet-abcdefg2", "subnet-abcdefg3"], "SecurityGroupIds": ["sg-12345678"] }, "AdvancedOptions": { "rest.action.multi.allow_explicit_index": "true|false", "indices.fielddata.cache.size": "40", "indices.query.bool.max_clause_count": "1024" }, "CognitoOptions": { "Enabled": true|false, "UserPoolId": "us-east-1_121234567", "IdentityPoolId": "us-east-1:12345678-1234-1234-1234-123456789012", "RoleArn": "arn:aws:iam::123456789012:role/service-role/CognitoAccessForAmazonES" }, "NodeToNodeEncryptionOptions": { "Enabled": true|false }, "DomainEndpointOptions": { "EnforceHTTPS": true|false, "TLSSecurityPolicy": "Policy-Min-TLS-1-2-2019-07|Policy-Min-TLS-1-0-2019-07" }, "LogPublishingOptions": { "SEARCH_SLOW_LOGS": { "CloudWatchLogsLogGroupArn":"arn:aws:logs:us-east-1:264071961897:log-group1:sample-domain", "Enabled":true|false }, "INDEX_SLOW_LOGS": { "CloudWatchLogsLogGroupArn":"arn:aws:logs:us-east-1:264071961897:log-group2:sample-domain", "Enabled":true|false }, "ES_APPLICATION_LOGS": { "CloudWatchLogsLogGroupArn":"arn:aws:logs:us-east-1:264071961897:log-group3:sample-domain", "Enabled":true|false } }, "AdvancedSecurityOptions": { "Enabled": true|false, "InternalUserDatabaseEnabled": true|false, "MasterUserOptions": { "MasterUserARN": "arn:aws:iam::123456789012:role/my-master-user-role" "MasterUserName": "my-master-username", "MasterUserPassword": "my-master-password" } }, "ElasticsearchVersion": "7.1", "DomainName": "my-domain", "AccessPolicies": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":[\"123456789012\"]},\"Action\":[\"es:es:ESHttp*\"],\"Resource\":\"arn:aws:es:us-east-1:123456789012:domain/my-domain/*\"}]}" }

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
DomainName DomainName 만들 Amazon ES 도메인의 이름입니다.
ElasticsearchVersion 문자열 아니요 Elasticsearch의 버전입니다. 지정하지 않을 경우 기본값인 1.5를 사용합니다. 지원되는 버전의 전체 목록은 지원되는 Elasticsearch 버전 단원을 참조하십시오.
ElasticsearchClusterConfig ElasticsearchClusterConfig 아니요 Amazon ES 도메인의 클러스터 구성을 위한 컨테이너입니다.
EBSOptions EBSOptions 아니요 Amazon ES 도메인에 EBS 기반 스토리지를 사용하도록 하는 데 필요한 매개변수의 컨테이너입니다.
VPCOptions VPCOptions 아니요 VPC 액세스 도메인을 구성하는 데 필요한 값을 저장하는 컨테이너입니다. 이러한 값을 지정하지 않을 경우 Amazon ES는 퍼블릭 엔드포인트를 갖는 도메인을 생성합니다. 자세한 내용은 Amazon Elasticsearch Service 도메인에 대한 VPC 지원 단원을 참조하십시오.
CognitoOptions CognitoOptions 아니요 Kibana에 Amazon Cognito 인증을 사용하도록 Amazon ES를 구성할 키-값 페어.
AccessPolicies 문자열 아니요 새 Amazon ES 도메인에 대한 액세스 정책을 지정하는 IAM 정책 문서입니다. 자세한 내용은 Amazon Elasticsearch Service의 자격 증명 및 액세스 관리 단원을 참조하십시오.
SnapshotOptions SnapshotOptions 아니요

(사용되지 않음) Elasticsearch 5.3 이상을 실행하는 도메인의 경우 Amazon ES는 시간별 자동 스냅샷을 생성하므로 이 설정이 무의미합니다.

이전 버전의 Elasticsearch를 실행하는 도메인의 경우 Amazon ES는 일별 자동 스냅샷을 생성합니다. 이 값은 서비스에서 스냅샷을 생성하려는 시간에 대한 컨테이너 역할을 수행합니다.

AdvancedOptions AdvancedOptions 아니요 고급 구성 옵션을 지정하는 키-값 페어입니다. 자세한 내용은 고급 옵션 구성을 참조하십시오.
LogPublishingOptions LogPublishingOptions 아니요 로그 게시를 느리게 구성하는 키-값 페어입니다.
EncryptionAtRestOptions EncryptionAtRestOptions 아니요 유휴 시 암호화를 활성화하는 키-값 페어입니다.
NodeToNodeEncryptionOptions NodeToNodeEncryptionOptions 아니요 노드 간 암호화를 활성화합니다.
DomainEndpointOptions DomainEndpointOptions 아니요 모든 트래픽에 HTTPS를 요구하도록 할지 여부와 같은 도메인 엔드포인터에 대한 추가 옵션입니다.
AdvancedSecurityOptions AdvancedSecurityOptions 아니요 세분화된 액세스 제어를 위한 옵션입니다.

응답 요소

필드 데이터 형식
DomainStatus ElasticsearchDomainStatus

CreateOutboundCrossClusterSearchConnection

소스 도메인에서 대상 도메인으로 새 클러스터 간 검색 연결을 생성합니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/es/ccs/outboundConnection { "ConnectionAlias": "StringValue", "SourceDomainInfo": { "DomainName": "Domain-name", "Region": "us-east-1" }, "DestinationDomainInfo": { "OwnerId": "Account-id", "DomainName": "Domain-name", "Region": "us-east-1" } }

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
ConnectionAlias 문자열 연결의 이름입니다.
SourceDomainInfo 객체 소스 도메인의 이름 및 리전입니다.
DestinationDomainInfo 객체 대상 도메인의 이름 및 리전입니다.

응답 요소

필드 데이터 형식 설명
SourceDomainInfo 객체 소스 도메인의 이름 및 리전입니다.
DestinationDomainInfo 객체 대상 도메인의 이름 및 리전입니다.
ConnectionAlias 문자열 연결의 이름입니다.
ConnectionStatus 문자열 연결 상태입니다.
CrossClusterSearchConnectionId 문자열 아웃바운드 연결의 ID입니다.

CreatePackage

Amazon ES 도메인에서 사용할 패키지를 추가합니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/packages { "PackageName": "my-package-name", "PackageType": "TXT-DICTIONARY", "PackageDescription": "My synonym file.", "PackageSource": { "S3BucketName": "my-s3-bucket", "S3Key": "synonyms.txt" } }

요청 파라미터

이 작업은 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
PackageName 문자열 패키지의 고유한 이름입니다.
PackageType 문자열 패키지 유형입니다. 현재 TXT-DICTIONARY만 지원됩니다.
PackageDescription 문자열 아니요 패키지에 대한 설명입니다.
PackageSource PackageSource 패키지용 S3 버킷 및 키입니다.

응답 요소

필드 데이터 형식
PackageDetails PackageDetails

DeleteElasticsearchDomain

Amazon ES 도메인과 포함된 데이터를 모두 삭제합니다. 삭제되고 나면 도메인은 복구할 수 없습니다.

구문

DELETE https://es.us-east-1.amazonaws.com/2015-01-01/es/domain/domain-name

요청 파라미터

파라미터 데이터 형식 필수? 설명
DomainName DomainName 삭제할 Amazon ES 도메인의 이름입니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식
DomainStatus ElasticsearchDomainStatus

DeleteElasticsearchServiceRole

Amazon ES와 Amazon EC2 간 서비스 연결 역할을 삭제합니다. 이 역할은 Amazon ES에게 VPC 엔드포인트를 VPC에 배치할 권한을 부여합니다. VPC 엔드포인트를 사용하는 도메인이 만들어지거나 올바로 기능하려면 서비스 연결 역할이 있어야 합니다.

참고

이 작업은 서비스 연결 역할을 사용 중인 도메인이 없는 경우에만 성공합니다.

구문

DELETE https://es.us-east-1.amazonaws.com/2015-01-01/es/role

요청 파라미터

이 작업은 요청 파라미터를 사용하지 않습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

DeleteElasticsearchServiceRole 작업이 데이터 구조를 반환하지 않습니다.

DeleteInboundCrossClusterSearchConnection

대상 도메인 소유자가 기존 인바운드 클러스터 간 검색 연결을 삭제할 수 있도록 허용합니다.

구문

DELETE https://es.us-east-1.amazonaws.com/2015-01-01/es/ccs/inboundConnection/{ConnectionId}

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
CrossClusterSearchConnection 객체 인바운드 연결 세부 정보입니다.

DeleteOutboundCrossClusterSearchConnection

소스 도메인 소유자가 기존 아웃바운드 클러스터 간 검색 연결을 삭제할 수 있도록 허용합니다.

구문

DELETE https://es.us-east-1.amazonaws.com/2015-01-01/es/ccs/outboundConnection/{ConnectionId}

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
CrossClusterSearchConnection 객체 아웃바운드 연결 세부 정보입니다.

DeletePackage

Amazon ES에서 패키지를 삭제합니다. 패키지가 Amazon ES 도메인에 연결되어 있어서는 안 됩니다.

구문

DELETE https://es.us-east-1.amazonaws.com/2015-01-01/packages/package-id

요청 파라미터

파라미터 데이터 형식 필수? 설명
PackageID 문자열 삭제할 패키지의 내부 ID입니다. 이 값을 확인하려면 DescribePackages를 사용합니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식
PackageDetails PackageDetails

DescribeElasticsearchDomain

도메인 ID, 도메인 서비스 엔드포인트 및 도메인 ARN을 비롯하여 지정된 Amazon ES 도메인에 대한 도메인 구성에 대해 설명합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/es/domain/domain-name

요청 파라미터

파라미터 데이터 형식 필수? 설명
DomainName DomainName 기술할 Amazon ES 도메인의 이름입니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식
DomainStatus ElasticsearchDomainStatus

DescribeElasticsearchDomainConfig

Amazon ES 도메인의 구성을 표시합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/es/domain/domain-name/config

요청 파라미터

파라미터 데이터 형식 필수? 설명
DomainName DomainName 설명하고자 하는 Amazon ES 도메인 구성의 이름입니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식
DomainConfig ElasticsearchDomainConfig

DescribeElasticsearchDomains

지정된 최대 5개 Amazon ES 도메인에 대한 도메인 구성을 기술합니다. 정보에는 도메인 ID, 도메인 서비스 엔드포인트 및 도메인 ARN이 포함됩니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/es/domain-info { "DomainNames": [ "domain-name1", "domain-name2", ] }

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

필드 데이터 형식 필수? 설명
DomainNames DomainNameList Amazon ES 도메인 이름의 배열입니다.

응답 요소

필드 데이터 형식
DomainStatusList ElasticsearchDomainStatusList

DescribeElasticsearchInstanceTypeLimits

지정된 Elasticsearch 버전 및 인스턴스 유형에 대한 인스턴스 개수, 스토리지 및 마스터 노드 한도를 설명합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/es/instanceTypeLimits/elasticsearch-version/instance-type?domainName=domain-name

요청 파라미터

파라미터 데이터 형식 필수? 설명
ElasticsearchVersion 문자열 Elasticsearch 버전입니다. 지원되는 버전 목록은 지원되는 Elasticsearch 버전 단원을 참조하십시오.
InstanceType 문자열 인스턴스 유형. 리전별로 인스턴스 유형을 보려면 Amazon Elasticsearch Service 요금 단원을 참조하십시오.
DomainName DomainName 아니요 기존 도메인의 이름입니다. 기존 도메인에 대한 한도가 필요할 경우에만 지정합니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
LimitsByRole Map 적용 가능한 모든 인스턴스 한도를 포함한 맵입니다. "data"는 데이터 노드를 의미합니다. "master"는 전용 마스터 노드를 참조합니다.

DescribeInboundCrossClusterSearchConnections

대상 도메인에 대한 인바운드 클러스터 간 검색 연결을 모두 나열합니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/es/ccs/inboundConnection/search { "Filters": [ { "Name": filter-name (str), "Values" : [val1, val2, ..] (list of strings) }, .... "MaxResults": int (Optional, default value - 100), "NextToken": "next-token-string (optional)" ] }

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
Filters 객체 “설명” 요청에 사용할 수 있는 필터 이름 및 값 목록입니다. cross-cluster-search-connection-id, source-domain-info.domain-name, source-domain-info.owner-id, source-domain-info.regiondestination-domain-info.domain-name 필드가 지원됩니다.
MaxResults 정수 아니요 결과 수를 제한합니다. 기본값은 100입니다.
NextToken 문자열 아니요 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

응답 요소

필드 데이터 형식 설명
CrossClusterSearchConnections 객체 인바운드 연결 목록입니다.
NextToken 문자열 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

DescribeOutboundCrossClusterSearchConnections

소스 도메인에 대한 아웃바운드 클러스터 간 검색 연결을 모두 나열합니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/es/ccs/outboundConnection/search { "Filters": [ { "Name": filter-name (str), "Values" : [val1, val2, ..] (list of strings) }, .... "MaxResults": int (Optional, default value - 100), "NextToken": "next-token-string (optional)" ] }

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
Filters 객체 “설명” 요청에 사용할 수 있는 필터 이름 및 값 목록입니다. cross-cluster-search-connection-id, source-domain-info.domain-name, source-domain-info.owner-id, source-domain-info.regiondestination-domain-info.domain-name 필드가 지원됩니다.
MaxResults 정수 아니요 결과 수를 제한합니다. 기본값은 100입니다.
NextToken 문자열 아니요 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

응답 요소

필드 데이터 형식 설명
CrossClusterSearchConnections 객체 아웃바운드 연결 목록입니다.
NextToken 문자열 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

DescribePackages

Amazon ES에서 사용할 수 있는 모든 패키지를 설명합니다. 필터링, 결과 수 제한 및 페이지 매김에 대한 옵션이 포함되어 있습니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/packages/describe { "Filters": [{ "Name": "PackageStatus", "Value": [ "DELETING", "AVAILABLE" ] }], "MaxResults": 5, "NextToken": "next-token", }

요청 파라미터

이 작업은 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
Filters 필터 아니요 지정된 값과 일치하는 패키지만 반환합니다.
MaxResults 정수 아니요 결과를 최대 패키지 수로 제한합니다.
NextToken 문자열 아니요 페이지 매김에 사용됩니다. 이전 API 호출에 null이 아닌 NextToken 값이 포함된 경우에만 필요합니다. 지정된 경우 다음 페이지의 결과를 반환합니다.

응답 요소

필드 데이터 형식 설명
PackageDetailsList 나열 PackageDetails 객체의 목록입니다.

DescribeReservedElasticsearchInstanceOfferings

주어진 리전에서 사용 가능한 예약 인스턴스 상품을 설명합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/es/reservedInstanceOfferings?offeringId=offering-id&maxResults=max-results&nextToken=next-token

요청 파라미터

파라미터 데이터 형식 필수? 설명
OfferingId 문자열 아니요 상품 ID입니다.
MaxResults 정수 아니요 결과 수를 제한합니다. 30~100 범위여야 합니다.
NextToken 문자열 아니요 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함한 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
ReservedElasticsearchInstanceOfferings ReservedElasticsearchInstanceOfferings 예약 인스턴스 상품에 대한 모든 정보를 담은 컨테이너입니다. 자세한 내용은 예약 인스턴스 구입(AWS CLI) 단원을 참조하십시오.

DescribeReservedElasticsearchInstances

주어진 리전에서 예약한 인스턴스를 설명합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/es/reservedInstances?reservationId=reservation-id&maxResults=max-results&nextToken=next-token

요청 파라미터

파라미터 데이터 형식 필수? 설명
ReservationId 문자열 아니요 예약 구매 후 할당된 예약 ID입니다.
MaxResults 정수 아니요 결과 수를 제한합니다. 30~100 범위여야 합니다.
NextToken 문자열 아니요 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함한 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
ReservedElasticsearchInstances

ReservedElasticsearchInstances

예약한 인스턴스에 대한 모든 정보의 컨테이너입니다. 자세한 내용은 예약 인스턴스 구입(AWS CLI) 단원을 참조하십시오.

DissociatePackage

지정된 Amazon ES 도메인에서 패키지를 제거합니다. 패키지를 ES 인덱스와 함께 사용 중인 경우 분리가 실패합니다. 이 패키지는 나중에 Amazon ES 서비스에서 연결하는 데 계속 사용할 수 있습니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/packages/dissociate/package-id/domain-name

요청 파라미터

파라미터 데이터 형식 필수? 설명
PackageID 문자열 도메인에서 분리할 패키지의 내부 ID입니다. 이 값을 확인하려면 ListPackagesForDomain을 사용합니다.
DomainName DomainName 패키지를 분리할 도메인의 이름입니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식
DomainPackageDetails DomainPackageDetails

GetCompatibleElasticsearchVersions

Elasticsearch 버전 및 업그레이드 가능한 버전의 맵을 반환합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/es/compatibleVersions?domainName=domain-name

요청 파라미터

파라미터 데이터 형식 필수? 설명
DomainName DomainName 아니요 기존 도메인의 이름입니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
CompatibleElasticsearchVersions Map Elasticsearch 버전 및 업그레이드 가능한 버전의 맵입니다.
{ "CompatibleElasticsearchVersions": [{ "SourceVersion": "6.7", "TargetVersions": ["6.8"] }] }

GetUpgradeHistory

최근 10회의 도메인 업그레이드 작업의 목록을 반환합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/es/upgradeDomain/domain-name/history?maxResults=max-results&nextToken=next-token

요청 파라미터

파라미터 데이터 형식 필수? 설명
MaxResults 정수 아니요 결과 수를 제한합니다. 30~100 범위여야 합니다.
DomainName DomainName 기존 도메인의 이름입니다.
NextToken 문자열 아니요 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
UpgradeHistoryList UpgradeHistoryList 직전 10회의 업그레이드 작업의 결과 로그를 위한 컨테이너입니다.

GetUpgradeStatus

도메인의 Elasticsearch 버전 업그레이드의 최신 상태를 반환합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/es/upgradeDomain/domain-name/status

요청 파라미터

파라미터 데이터 형식 필수? 설명
DomainName DomainName 기존 도메인의 이름입니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
UpgradeStepItem UpgradeStepItem 도메인의 버전 업그레이드의 최신 상태를 위한 컨테이너입니다.

ListDomainNames

활성 리전의 현재 사용자가 소유한 모든 Amazon ES 도메인의 이름을 표시합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/domain

요청 파라미터

이 작업은 요청 파라미터를 사용하지 않습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
DomainNameList DomainNameList 현재 사용자가 소유한 모든 Amazon ES 도메인의 이름입니다.

ListDomainsForPackage

패키지가 연결된 모든 Amazon ES 도메인을 나열합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/packages/package-id/domains?maxResults=max-results&nextToken=next-token

요청 파라미터

파라미터 데이터 형식 필수? 설명
PackageID 문자열 도메인을 나열할 패키지입니다.
MaxResults 정수 아니요 결과 수를 제한합니다.
NextToken 문자열 아니요 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함한 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
DomainPackageDetailsList 나열 DomainPackageDetails 객체의 목록입니다.
NextToken 문자열 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

ListElasticsearchInstanceTypeDetails

지정된 Elasticsearch 버전에서 지원되는 모든 Elasticsearch 인스턴스 유형과 본 인스턴스 유형이 지원하는 기능을 나열합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/es/instanceTypeDetails/elasticsearch-version?domainName=domain-name&maxResults=max-results&nextToken=next-token

요청 파라미터

파라미터 데이터 형식 필수? 설명
ElasticsearchVersion 문자열 Elasticsearch 버전입니다.
DomainName 문자열 아니요 Amazon ES 도메인 이름입니다.
MaxResults 정수 아니요 결과 수를 제한합니다. 30~100 범위여야 합니다.
NextToken 문자열 아니요 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
ElasticsearchInstanceTypes 나열 지정된 Elasticsearch 버전에서 지원되는 모든 인스턴스 유형 목록과 본 인스턴스 유형이 지원하는 기능
NextToken 문자열

페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

ListElasticsearchInstanceTypes (지원 중단)

지정된 Elasticsearch 버전에서 지원되는 모든 Elasticsearch 인스턴스 유형을 나열합니다. 이 작업은 사용 중단되었습니다. 대신 ListElasticsearchInstanceTypeDetails를 사용하십시오.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/es/instanceTypes/elasticsearch-version?domainName=domain-name&maxResults=max-results&nextToken=next-token

요청 파라미터

파라미터 데이터 형식 필수? 설명
ElasticsearchVersion 문자열 Elasticsearch 버전입니다.
DomainName 문자열 아니요 Amazon ES 도메인 이름입니다.
MaxResults 정수 아니요 결과 수를 제한합니다. 30~100 범위여야 합니다.
NextToken 문자열 아니요 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
ElasticsearchInstanceTypes 나열 지정된 Elasticsearch 버전을 지원하는 인스턴스 유형 목록입니다.
NextToken 문자열 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

ListElasticsearchVersions

Amazon ES에서 지원되는 모든 Elasticsearch 버전을 나열합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/es/versions?maxResults=max-results&nextToken=next-token

요청 파라미터

파라미터 데이터 형식 필수? 설명
MaxResults 정수 아니요 결과 수를 제한합니다. 30~100 범위여야 합니다.
NextToken 문자열 아니요 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
ElasticsearchVersions 나열 지원되는 모든 Elasticsearch 버전을 나열합니다.
NextToken 문자열 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

ListPackagesForDomain

Amazon ES 도메인에 연결된 모든 패키지를 나열합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/domain/domain-name/packages?maxResults=max-results&nextToken=next-token

요청 파라미터

파라미터 데이터 형식 필수? 설명
DomainName 문자열 연결된 패키지를 나열할 도메인의 이름입니다.
MaxResults 정수 아니요 결과 수를 제한합니다.
NextToken 문자열 아니요 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함한 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
DomainPackageDetailsList List DomainPackageDetails 객체의 목록입니다.
NextToken String 페이지 매김에 사용됩니다. 이전 API 호출이 NextToken을 포함하는 결과를 생성한 경우에만 필요합니다. next-token 입력을 받아 다음 페이지의 결과를 반환하고, 응답에 next-token 출력을 제공하여 클라이언트가 더 많은 결과를 가져오는 데 사용할 수 있습니다.

ListTags

Amazon ES 도메인의 리소스 태그를 모두 표시합니다.

구문

GET https://es.us-east-1.amazonaws.com/2015-01-01/tags?arn=domain-arn

요청 파라미터

파라미터 데이터 형식 필수? 설명
ARN ARN Amazon ES 도메인의 Amazon 리소스 이름(ARN)입니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
TagList TagList 리소스 태그 목록. 자세한 내용은 Amazon Elasticsearch Service 도메인 태깅을 참조하십시오.

PurchaseReservedElasticsearchInstanceOffering

예약 인스턴스를 구매합니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/es/purchaseReservedInstanceOffering { "ReservationName" : "my-reservation", "ReservedElasticsearchInstanceOfferingId" : "1a2a3a4a5-1a2a-3a4a-5a6a-1a2a3a4a5a6a", "InstanceCount" : 3 }

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

이름 데이터 형식 필수? 설명
ReservationName 문자열 예약을 나타내는 이름.
ReservedElasticsearchInstanceOfferingId 문자열 상품 ID입니다.
InstanceCount 정수 예약할 인스턴스 수입니다.

응답 요소

필드 데이터 형식 설명
ReservationName 문자열 예약 이름.
ReservedElasticsearchInstanceId 문자열 예약 ID.

RejectInboundCrossClusterSearchConnection

대상 도메인 소유자가 인바운드 클러스터 간 검색 연결 요청을 거부할 수 있도록 허용합니다.

구문

PUT https://es.us-east-1.amazonaws.com/2015-01-01/es/ccs/inboundConnection/{ConnectionId}/reject

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

이 작업은 HTTP 요청 본문을 사용하지 않습니다.

응답 요소

필드 데이터 형식 설명
CrossClusterSearchConnection 객체 인바운드 연결 세부 정보입니다.

RemoveTags

Amazon ES 도메인에서 지정된 리소스 태그를 제거합니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/tags-removal { "ARN": "arn:aws:es:us-east-1:123456789012:domain/my-domain", "TagKeys": [ "tag-key1", "tag-key2" ] }

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
ARN ARN Amazon ES 도메인의 Amazon 리소스 이름(ARN)입니다. 자세한 내용은 AWS Identity and Access Management 사용IAM 개체에 대한 식별자 단원을 참조하십시오.
TagKeys TagKey Amazon ES 도메인에서 제거하려는 리소스 태그의 태그 키 목록입니다.

응답 요소

RemoveTags 작업은 응답 요소를 반환하지 않습니다.

StartElasticsearchServiceSoftwareUpdate

Amazon ES 도메인에 대한 서비스 소프트웨어 업데이트 일정을 예약합니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/es/serviceSoftwareUpdate/start { "DomainName": "domain-name" }

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
DomainName DomainName 최신 서비스 소프트웨어로 업데이트하려는 Amazon ES 도메인의 이름입니다.

응답 요소

필드 데이터 형식 설명
ServiceSoftwareOptions ServiceSoftwareOptions 최신 서비스 소프트웨어와 관련된 도메인 상태에 대한 컨테이너입니다.

StopElasticsearchServiceSoftwareUpdate

Amazon ES 도메인에 대해 예약된 서비스 소프트웨어 업데이트를 중단합니다. 도메인의 UpdateStatusPENDING_UPDATE인 경우에만 작동합니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/es/serviceSoftwareUpdate/stop { "DomainName": "domain-name" }

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
DomainName DomainName 최신 서비스 소프트웨어로 업데이트하려는 Amazon ES 도메인의 이름입니다.

응답 요소

필드 데이터 형식 설명
ServiceSoftwareOptions ServiceSoftwareOptions 최신 서비스 소프트웨어와 관련된 도메인 상태에 대한 컨테이너입니다.

UpdateElasticsearchDomainConfig

Amazon ES 도메인의 구성(예: 인스턴스 유형 및 인스턴스 수)을 수정합니다. 업데이트할 값만 지정하면 됩니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/es/domain/<DOMAIN_NAME>/config { "ElasticsearchClusterConfig": { "ZoneAwarenessConfig": { "AvailabilityZoneCount": 3 }, "ZoneAwarenessEnabled": true|false, "InstanceCount": 3, "DedicatedMasterEnabled": true|false, "DedicatedMasterType": "c5.large.elasticsearch", "DedicatedMasterCount": 3, "InstanceType": "r5.large.elasticsearch", "WarmCount": 6, "WarmType": "ultrawarm1.medium.elasticsearch" }, "EBSOptions": { "EBSEnabled": true|false, "VolumeType": "io1|gp2|standard", "Iops": 1000, "VolumeSize": 35 }, "SnapshotOptions": { "AutomatedSnapshotStartHour": 3 }, "VPCOptions": { "SubnetIds": ["subnet-abcdefg1", "subnet-abcdefg2", "subnet-abcdefg3"], "SecurityGroupIds": ["sg-12345678"] }, "AdvancedOptions": { "rest.action.multi.allow_explicit_index": "true|false", "indices.fielddata.cache.size": "40", "indices.query.bool.max_clause_count": "1024" }, "CognitoOptions": { "Enabled": true|false, "UserPoolId": "us-east-1_121234567", "IdentityPoolId": "us-east-1:12345678-1234-1234-1234-123456789012", "RoleArn": "arn:aws:iam::123456789012:role/service-role/CognitoAccessForAmazonES" }, "DomainEndpointOptions": { "EnforceHTTPS": true|false, "TLSSecurityPolicy": "Policy-Min-TLS-1-2-2019-07|Policy-Min-TLS-1-0-2019-07" }, "LogPublishingOptions": { "SEARCH_SLOW_LOGS": { "CloudWatchLogsLogGroupArn":"arn:aws:logs:us-east-1:264071961897:log-group1:sample-domain", "Enabled":true|false }, "INDEX_SLOW_LOGS": { "CloudWatchLogsLogGroupArn":"arn:aws:logs:us-east-1:264071961897:log-group2:sample-domain", "Enabled":true|false }, "ES_APPLICATION_LOGS": { "CloudWatchLogsLogGroupArn":"arn:aws:logs:us-east-1:264071961897:log-group3:sample-domain", "Enabled":true|false } }, "AdvancedSecurityOptions": { "InternalUserDatabaseEnabled": true|false, "MasterUserOptions": { "MasterUserARN": "arn:aws:iam::123456789012:role/my-master-user-role" "MasterUserName": "my-master-username", "MasterUserPassword": "my-master-password" } }, "DomainName": "my-domain", "AccessPolicies": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":[\"*\"]},\"Action\":[\"es:*\"],\"Resource\":\"arn:aws:es:us-east-1:123456789012:domain/my-domain/*\"}]}" }

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
DomainName DomainName 구성을 업데이트하려는 Amazon ES 도메인의 이름입니다.
ElasticsearchClusterConfig ElasticsearchClusterConfig 아니요 클러스터 구성에 적용하려는 변경 사항(예: 인스턴스 유형 및 EC2 인스턴스의 수)입니다.
EBSOptions EBSOptions 아니요 데이터 노드에 연결된 EBS 볼륨의 유형 및 크기입니다.
VPCOptions VPCOptions 아니요 VPC에서 사용할 Amazon ES를 구성하는 데 필요한 값을 저장하는 컨테이너입니다. 자세한 내용은 Amazon Elasticsearch Service 도메인에 대한 VPC 지원 단원을 참조하십시오.
SnapshotOptions SnapshotOptions 아니요 (사용되지 않음) 서비스가 Amazon ES 도메인의 인덱스에 대해 일일 자동 스냅샷을 생성하는 시간입니다.
AdvancedOptions AdvancedOptions 아니요 고급 구성 옵션을 지정하는 키-값 페어입니다. 자세한 내용은 고급 옵션 구성을 참조하십시오.
AccessPolicies 문자열 아니요 Amazon ES 도메인에 대한 액세스 정책을 지정합니다. 자세한 내용은 액세스 정책 구성을 참조하십시오.
LogPublishingOptions LogPublishingOptions 아니요 로그 게시를 느리게 구성하는 키-값 페어입니다.
CognitoOptions CognitoOptions 아니요 Kibana에 Amazon Cognito 인증을 사용하도록 Amazon ES를 구성할 키-값 페어.
DomainEndpointOptions DomainEndpointOptions 아니요 모든 트래픽에 HTTPS를 요구하도록 할지 여부와 같은 도메인 엔드포인터에 대한 추가 옵션입니다.
AdvancedSecurityOptions AdvancedSecurityOptions 아니요 세분화된 액세스 제어를 위한 옵션입니다.

응답 요소

필드 데이터 형식
DomainConfig ElasticsearchDomainConfig

UpgradeElasticsearchDomain

Amazon ES 도메인을 새 버전의 Elasticsearch로 업그레이드합니다. 또는 업그레이드 자격을 확인합니다.

구문

POST https://es.us-east-1.amazonaws.com/2015-01-01/es/upgradeDomain { "DomainName": "domain-name", "TargetVersion": "7.4", "PerformCheckOnly": true|false }

요청 파라미터

이 작업은 HTTP 요청 파라미터를 사용하지 않습니다.

요청 본문

파라미터 데이터 형식 필수? 설명
DomainName 문자열 업그레이드할 Amazon ES 도메인의 이름입니다.
TargetVersion 문자열 업그레이드하려는 Elasticsearch 버전입니다. GetCompatibleElasticsearchVersions 단원을 참조하십시오.
PerformCheckOnly 부울 아니요 기본값은 false입니다. true일 경우, Amazon ES가 도메인의 자격을 확인하지만 업그레이드를 수행하지는 않습니다.

응답 요소

필드 데이터 형식 설명
UpgradeElasticsearchDomainResponse Map 작업 세부 정보를 확인하는 기본 응답입니다.

데이터 형식

이 단원에서는 구성 API에서 사용하는 데이터 형식에 대해 설명합니다.

AdvancedOptions

고급 Elasticsearch 구성 옵션을 지정하는 키-값 페어입니다.

필드 데이터 형식 설명
rest.action.multi.allow_explicit_index 키-값 페어:

"rest.action.multi.allow_explicit_index":"true"

부울이 아닌 문자열을 사용하는 것에 유의하십시오. HTTP 요청의 본문에서 인덱스에 대한 명시적 참조를 허용할지 여부를 지정합니다. 인덱스 및 도메인 API와 같은 도메인 하위 리소스에 대한 액세스 정책을 구성하려면 이 속성을 비활성화해야 합니다. 하위 리소스에 대한 액세스 정책에 관한 자세한 내용은 액세스 정책 구성을 참조하십시오.
indices.fielddata.cache.size 키-값 페어:

"indices.fielddata.cache.size":"80"

정수가 아닌 문자열을 사용하는 것에 유의하십시오. 필드 데이터에 할당되는 Java 힙 공간의 백분율을 지정합니다. 기본적으로 이 설정은 무한입니다.
indices.query.bool.max_clause_count 키-값 페어:

"indices.query.bool.max_clause_count":"1024"

정수가 아닌 문자열을 사용하는 것에 유의하십시오. Lucene 부울 쿼리 하나에 허용되는 최대 절 수를 지정합니다. 기본값은 1,024입니다. 절 수가 허용되는 개수 이상인 쿼리는 TooManyClauses 오류를 일으킵니다. 자세한 내용은 Lucene 설명서 단원을 참조하십시오.

ARN

필드 데이터 형식 설명
ARN 문자열 Amazon ES 도메인의 Amazon 리소스 이름(ARN)입니다. 자세한 내용은 AWS Identity and Access Management 문서의 IAM ARN을 참조하십시오.

AdvancedSecurityOptions

필드 데이터 형식 설명
Enabled 부울 세분화된 액세스 제어를 활성화하는 경우 True입니다.
InternalUserDatabaseEnabled 부울 내부 사용자 데이터베이스를 활성화하는 경우 True입니다.
MasterUserOptions MasterUserOptions 마스터 사용자에 대한 정보를 제공하는 컨테이너입니다.

CognitoOptions

필드 데이터 형식 설명
Enabled 부울(Boolean) Kibana에 대한 Amazon Cognito 인증을 활성화할지 여부. Kibana에 대한 Amazon Cognito 인증 단원을 참조하십시오.
UserPoolId 문자열 Amazon ES에서 Kibana 인증을 사용하도록 하려는 Amazon Cognito 사용자 풀 ID.
IdentityPoolId 문자열 Amazon ES에서 Kibana 인증을 사용하도록 하려는 Amazon Cognito 자격 증명 풀 ID.
RoleArn 문자열 Amazon ES에서 사용자 풀과 자격 증명 풀의 구성을 허용하는 AmazonESCognitoAccess 역할.

CreateElasticsearchDomainRequest

CreateElasticsearchDomain 서비스 작업에 필요한 파라미터의 컨테이너입니다.

필드 데이터 형식 설명
DomainName DomainName 만들 Amazon ES 도메인의 이름입니다.
ElasticsearchClusterConfig ElasticsearchClusterConfig Amazon ES 도메인의 클러스터 구성을 위한 컨테이너입니다.
EBSOptions EBSOptions Amazon ES 도메인에 EBS 기반 스토리지를 사용하도록 하는 데 필요한 매개변수의 컨테이너입니다.
AccessPolicies 문자열 새 Amazon ES 도메인에 대한 액세스 정책을 지정하는 IAM 정책 문서입니다. 자세한 내용은 액세스 정책 구성을 참조하십시오.
DomainEndpointOptions DomainEndpointOptions 모든 트래픽에 HTTPS를 요구하도록 할지 여부와 같은 도메인 엔드포인터에 대한 추가 옵션입니다.
SnapshotOptions SnapshotOptions (사용되지 않음) 도메인 인덱스의 자동 스냅샷을 구성하는 데 필요한 파라미터의 컨테이너입니다.
VPCOptions VPCOptions VPC에서 사용할 Amazon ES를 구성하는 데 필요한 값을 저장하는 컨테이너입니다.
LogPublishingOptions LogPublishingOptions 로그 게시를 느리게 구성하는 키-값 페어입니다.
AdvancedOptions AdvancedOptions 고급 구성 옵션을 지정하는 키-값 페어입니다.
CognitoOptions CognitoOptions Kibana에 Amazon Cognito 인증을 사용하도록 Amazon ES를 구성할 키-값 페어.
NodeToNodeEncryptionOptions NodeToNodeEncryptionOptions 노드 간 암호화를 활성화하기 위해 true를 지정합니다.

DomainEndpointOptions

Field 데이터 형식 설명
EnforceHTTPS true로 설정하면 도메인에 대한 모든 트레픽이 HTTPS를 통해 도착해야 합니다.
TLSSecurityPolicy 문자열 도메인에 대한 트래픽에 요구되는 최소 TLS 버전입니다. 유효한 값은 TLS 1.0(기본값) 또는 1.2입니다.
  • Policy-Min-TLS-1-0-2019-07

  • Policy-Min-TLS-1-2-2019-07

DomainID

데이터 형식 설명
문자열 Amazon ES 도메인의 고유한 식별자입니다.

DomainName

Amazon ES 도메인의 이름입니다.

데이터 형식 설명
문자열 Amazon ES 도메인의 이름입니다. 도메인 이름은 AWS 리전 내에서 동일한 계정이 소유한 모든 도메인 간에 고유합니다. 도메인 이름은 소문자로 시작해야 하며 3~28자여야 합니다. 유효한 문자는 a-z(소문자만), 0-9 및 –(하이픈)입니다.

DomainNameList

Amazon ES 도메인 이름의 문자열입니다.

데이터 형식 설명
문자열 배열 Amazon ES 도메인의 배열 형식은 다음과 같습니다.

["<Domain_Name>","<Domain_Name>"...]

DomainPackageDetails

도메인에 연결된 패키지에 대한 정보입니다.

필드 데이터 형식 설명
DomainName 문자열 패키지를 연결한 도메인의 이름입니다.
DomainPackageStatus 문자열 연결 상태입니다. 값은 ASSOCIATING, ASSOCIATION_FAILED, ACTIVE, DISSOCIATING, DISSOCIATION_FAILED입니다.
ErrorDetails 문자열 패키지가 오류 상태인 경우 추가 정보입니다. 그렇지 않은 경우 null입니다.
LastUpdated Timestamp 연결 상태에 대한 최근 업데이트의 타임스탬프입니다.
PackageID 문자열 패키지의 내부 ID입니다.
PackageName 문자열 패키지의 사용자 지정 이름입니다.
PackageType 문자열 현재 TXT-DICTIONARY만 지원됩니다.
ReferencePath 문자열 Amazon ES 클러스터 노드에서 패키지의 위치를 나타냅니다. 사전 파일의 경우 synonym_path와 동일합니다.

EBSOptions

Amazon ES 도메인에 EBS 기반 스토리지를 사용하도록 하는 데 필요한 매개변수의 컨테이너입니다.

필드 데이터 형식 설명
EBSEnabled 부울(Boolean) Amazon ES 도메인의 데이터 노드에 EBS 볼륨을 연결할지 여부를 지정합니다.
VolumeType 문자열 데이터 노드에 연결된 EBS 볼륨의 유형을 지정합니다.
VolumeSize 문자열 데이터 노드에 연결된 EBS 볼륨의 크기(GiB)를 지정합니다.
Iops 문자열 데이터 노드에 연결된 EBS 볼륨의 기본 입력/출력(I/O) 성능을 지정합니다. 프로비저닝된 IOPS EBS 볼륨 유형에만 적용됩니다.

ElasticsearchClusterConfig

Amazon ES 도메인의 클러스터 구성을 위한 컨테이너입니다.

필드 데이터 형식 설명
InstanceType 문자열 클러스터에 있는 데이터 노드의 인스턴스 유형입니다.
InstanceCount 정수 클러스터의 인스턴스 수입니다.
DedicatedMasterEnabled 부울(Boolean) 클러스터에 전용 마스터 노드를 사용할 수 있는지 여부를 지정합니다. 클러스터에서 전용 마스터 노드를 사용하는 경우 True를 지정합니다. 사용하지 않는 경우에는 False를 지정합니다. 자세한 내용은 전용 마스터 노드 정보 단원을 참조하십시오.
DedicatedMasterType 문자열 클러스터에 있는 전용 마스터 노드의 Amazon ES 인스턴스 유형입니다.
DedicatedMasterCount 정수 클러스터에 있는 전용 마스터 노드 수입니다.
ZoneAwarenessEnabled 부울(Boolean) 다중 가용 영역을 사용할 수 있는지 여부를 나타냅니다. 자세한 내용은 다중 AZ 도메인 구성 단원을 참조하십시오.
ZoneAwarenessConfig ZoneAwarenessConfig 영역 인식 구성 옵션을 위한 컨테이너입니다. ZoneAwarenessEnabledtrue일 경우에만 필수입니다.
WarmEnabled 클러스터에 웜 스토리지를 사용할지 여부입니다.
WarmCount 정수 클러스터의 웜 노드 수입니다.
WarmType 문자열 클러스터의 웜 노드에 대한 인스턴스 유형입니다.
WarmStorage 정수 프로비저닝된 총 웜 스토리지 용량(GiB)입니다.

ElasticsearchDomainConfig

Amazon ES 도메인의 구성을 위한 컨테이너입니다.

필드 데이터 형식 설명
ElasticsearchVersion 문자열 Elasticsearch 버전입니다.
ElasticsearchClusterConfig ElasticsearchClusterConfig Amazon ES 도메인의 클러스터 구성을 위한 컨테이너입니다.
EBSOptions EBSOptions Amazon ES 도메인에 대해 구성된 EBS 옵션을 위한 컨테이너입니다.
AccessPolicies 문자열 Amazon ES 도메인에 대한 액세스 정책을 지정합니다. 자세한 내용은 액세스 정책 구성을 참조하십시오.
SnapshotOptions SnapshotOptions (사용되지 않음) 서비스가 Amazon ES 도메인의 인덱스에 대해 일일 자동 스냅샷을 생성하는 시간입니다.
DomainEndpointOptions DomainEndpointOptions 모든 트래픽에 HTTPS를 요구하도록 할지 여부와 같은 도메인 엔드포인터에 대한 추가 옵션입니다.
VPCOptions VPCDerivedInfo 도메인의 현재 VPCOptions과 구성에 대한 업데이트의 상태입니다.
LogPublishingOptions LogPublishingOptions 로그 게시를 느리게 구성하는 키-값 페어입니다.
AdvancedOptions AdvancedOptions 고급 구성 옵션을 지정하는 키-값 페어입니다.
EncryptionAtRestOptions EncryptionAtRestOptions 유휴 시 암호화를 활성화하는 키-값 페어입니다.
NodeToNodeEncryptionOptions NodeToNodeEncryptionOptions 노드 간 암호화의 활성화 여부.

ElasticsearchDomainStatus

DomainStatus 데이터 구조의 콘텐츠를 위한 컨테이너입니다.

필드 데이터 형식 설명
DomainID DomainID Amazon ES 도메인의 고유한 식별자입니다.
DomainName DomainName Amazon ES 도메인의 이름입니다. 도메인 이름은 AWS 리전 내에서 동일한 계정이 소유한 모든 도메인 간에 고유합니다. 도메인 이름은 소문자로 시작해야 하며 3~28자여야 합니다. 유효한 문자는 a-z(소문자만), 0-9 및 –(하이픈)입니다.
ARN ARN Amazon ES 도메인의 Amazon 리소스 이름(ARN)입니다. 자세한 내용은 AWS Identity and Access Management 사용IAM 개체에 대한 식별자 단원을 참조하십시오.
Created 부울(Boolean) Amazon ES 도메인의 생성 상태입니다. 도메인 생성이 완료되면 True이고 도메인 생성이 진행 중이면 False입니다.
Deleted 부울(Boolean) Amazon ES 도메인의 삭제 상태입니다. 도메인 삭제가 완료되면 True이고 도메인 삭제가 진행 중이면 False입니다.
Endpoint ServiceUrl Amazon ES 도메인으로 인덱스, 검색 및 데이터 업로드 요청을 제출하는 데 사용되는 도메인별 엔드포인트입니다.
Endpoints EndpointsMap Amazon ES 도메인이 VPC 엔드포인트를 사용할 경우 존재하는 키-값 페어입니다.
Processing 부울(Boolean) Amazon ES 도메인 구성 변경 상태입니다. 서비스가 여전히 구성 변경을 처리 중이면 True이고 구성 변경이 활성 상태이면 False입니다. 인덱스, 검색 및 데이터 업로드 요청을 제출하기 전에 도메인이 활성 상태가 될 때까지 기다려야 합니다.
ElasticsearchVersion 문자열 Elasticsearch 버전입니다.
ElasticsearchClusterConfig ElasticsearchClusterConfig Amazon ES 도메인의 클러스터 구성을 위한 컨테이너입니다.
EBSOptions EBSOptions Amazon ES 도메인에 EBS 기반 스토리지를 사용하도록 하는 데 필요한 매개변수의 컨테이너입니다.
AccessPolicies 문자열 새 Amazon ES 도메인에 대한 액세스 정책을 지정하는 IAM 정책 문서입니다. 자세한 내용은 액세스 정책 구성을 참조하십시오.
SnapshotOptions SnapshotOptions (사용되지 않음) Amazon ES 도메인 인덱스의 일일 자동 스냅샷을 구성하는 데 필요한 파라미터의 컨테이너입니다.
VPCOptions VPCDerivedInfo Amazon ES가 도메인의 VPCOptions를 기반으로 도출하는 정보입니다.
LogPublishingOptions LogPublishingOptions 로그 게시를 느리게 구성하는 키-값 페어입니다.
AdvancedOptions AdvancedOptions 고급 구성 옵션을 지정하는 키-값 페어입니다.
EncryptionAtRestOptions EncryptionAtRestOptions 유휴 시 암호화를 활성화하는 키-값 페어입니다.
CognitoOptions CognitoOptions Kibana에 Amazon Cognito 인증을 사용하도록 Amazon ES를 구성할 키-값 페어.
NodeToNodeEncryptionOptions NodeToNodeEncryptionOptions 노드 간 암호화의 활성화 여부.
UpgradeProcessing 새 Elasticsearch 버전으로 업그레이드가 진행 중인 경우 True입니다.
ServiceSoftwareOptions ServiceSoftwareOptions 도메인의 서비스 소프트웨어 상태입니다.

ElasticsearchDomainStatusList

지정된 각 Amazon ES 도메인의 상태가 포함된 목록입니다.

필드 데이터 형식 설명
DomainStatusList ElasticsearchDomainStatus 지정된 각 Amazon ES 도메인의 상태가 포함된 목록입니다.

EncryptionAtRestOptions

유휴 시 도메인이 데이터를 암호화할지 여부와 암호화하는 경우 AWS Key Management Service(KMS) 키를 사용할지 여부를 지정합니다. 기존 도메인 업데이트가 아닌 새 도메인을 생성할 때만 사용할 수 있습니다. 자세한 내용은 유휴 시 데이터 암호화 활성화 단원을 참조하십시오.

필드 데이터 형식 설명
Enabled 부울(Boolean) 유휴 시 암호화를 활성화하기 위해 true를 지정합니다.
KmsKeyId 문자열 KMS 키 ID입니다. 1a2a3a4-1a2a-3a4a-5a6a-1a2a3a4a5a6a 양식을 사용합니다.

EndpointsMap

VPC 엔드포인트가 저장된 키-값 페어입니다. Amazon ES 도메인이 VPC에 상주하는 경우에만 존재합니다.

필드 데이터 형식 설명
Endpoints 키-값 문자열 페어: "vpc": "<VPC_ENDPOINT>" 도메인의 VPC 엔드포인트입니다.

필터

DescribePackages 응답에 포함된 패키지를 필터링합니다.

필드 데이터 형식 설명
Name 문자열 PackageDetails의 모든 필드입니다.
Value 나열 지정된 필드의 값 목록입니다.

LogPublishingOptions

Amazon ES 도메인이 Amazon CloudWatch에 Elasticsearch 애플리케이션 및 느린 로그를 게시할지 여부를 지정합니다. Elasticsearch REST API를 사용하는 느린 로그 모음을 계속 활성화해야 합니다. 자세한 내용은 느린 로그에 대한 Elasticsearch 로깅 임계값 설정 단원을 참조하십시오.

필드 데이터 형식 설명
INDEX_SLOW_LOGS 키-값

CloudWatch 로그 그룹 및 Elasticsearch의 인덱스 느린 로그 여부를 정의하는 두 개의 키-값 페어는 다음 위치에 게시되어야 합니다.

"CloudWatchLogsLogGroupArn":"arn:aws:logs:us-east-1:264071961897:log-group:sample-domain", "Enabled":true
SEARCH_SLOW_LOGS 키-값

CloudWatch 로그 그룹 및 Elasticsearch 검색 느린 로그 여부를 정의하는 두 개의 키-값 페어는 다음 위치에 게시되어야 합니다.

"CloudWatchLogsLogGroupArn":"arn:aws:logs:us-east-1:264071961897:log-group:sample-domain", "Enabled":true
ES_APPLICATION_LOGS 키-값 CloudWatch 로그 그룹 및 Elasticsearch의 오류 로그 여부를 정의하는 두 개의 키-값 페어는 다음 위치에 게시되어야 합니다.
"CloudWatchLogsLogGroupArn":"arn:aws:logs:us-east-1:264071961897:log-group:sample-domain", "Enabled":true

MasterUserOptions

필드 데이터 형식 설명
MasterUserARN 문자열 마스터 사용자의 ARN입니다. AdvancedSecurityOptions에서 InternalUserDatabaseEnabledfalse인 경우에만 지정합니다.
MasterUserName 문자열 마스터 사용자의 사용자 이름입니다. AdvancedSecurityOptions에서 InternalUserDatabaseEnabledtrue인 경우에만 지정합니다.
MasterUserPassword 문자열 마스터 사용자의 암호입니다. AdvancedSecurityOptions에서 InternalUserDatabaseEnabledtrue인 경우에만 지정합니다.

NodeToNodeEncryptionOptions

노드 간 암호화를 활성화 또는 비활성화합니다.

필드 데이터 형식 설명
Enabled 부울(Boolean) true를 사용하여 활성화

OptionState

Amazon ES 도메인의 고급 옵션에 대한 업데이트 상태입니다.

필드 데이터 형식 설명
OptionStatus 문자열 유효한 값 3개 중 하나:
  • RequiresIndexDocuments

  • 처리 중

  • 활성 상태

OptionStatus

Amazon ES 도메인의 구성 옵션에 대한 업데이트 상태입니다.

필드 데이터 형식 설명
CreationDate Timestamp Amazon ES 도메인이 생성된 날짜와 시간입니다.
UpdateDate Timestamp Amazon ES 도메인이 업데이트된 날짜와 시간입니다.
UpdateVersion 정수 개체의 최신 버전을 지정하는 정수입니다.
State OptionState Amazon ES 도메인의 구성 옵션에 대한 업데이트 상태입니다.
PendingDeletion 서비스가 Amazon ES 도메인 및 도메인의 모든 리소스를 영구히 삭제하기 위한 요청을 처리 중인지 여부를 나타냅니다.

PackageDetails

패키지에 대한 기본 정보입니다.

필드 데이터 형식 설명
CreatedAt Timestamp 패키지가 포함된 버킷의 이름입니다.
ErrorDetails 문자열 패키지가 오류 상태인 경우 추가 정보입니다. 그렇지 않은 경우 null입니다.
PackageDescription 문자열 패키지에 대한 사용자 지정 설명입니다.
PackageID 문자열 패키지의 내부 ID입니다.
PackageName 문자열 패키지의 사용자 지정 이름입니다.
PackageStatus 문자열 값은 COPYING, COPY_FAILED, AVAILABLE, DELETING 또는 DELETE_FAILED입니다.
PackageType 문자열 현재 TXT-DICTIONARY만 지원됩니다.

PackageSource

Amazon ES에 추가할 패키지용 버킷 및 키입니다.

필드 데이터 형식 설명
S3BucketName 문자열 패키지가 포함된 버킷의 이름입니다.
S3Key 문자열 패키지의 키(파일 이름)입니다.

ServiceSoftwareOptions

최신 서비스 소프트웨어와 관련된 도메인 상태에 대한 컨테이너입니다.

필드 데이터 형식 설명
UpdateAvailable 부울(Boolean) 도메인에 대해 서비스 소프트웨어 업데이트를 사용할 수 있는지 여부입니다.
Cancellable 부울(Boolean) 도메인 업데이트를 요청한 경우 업데이트를 취소할 수 있는지 여부입니다.
AutomatedUpdateDate Timestamp 필요한 업데이트에 대해 배포 창이 닫히는 Epoch 시간입니다. 이 시간 후 Amazon ES는 소프트웨어 업그레이드 일정을 자동으로 예약합니다.
UpdateStatus 문자열 업데이트의 상태입니다. 값은 ELIGIBLE, PENDING_UPDATE, IN_PROGRESS, COMPLETED, NOT_ELIGIBLE입니다.
Description 문자열 상태에 대한 자세한 설명입니다.
CurrentVersion 문자열 현재 서비스 소프트웨어 버전입니다.
NewVersion 문자열 최신 서비스 소프트웨어 버전입니다.
OptionalDeployment 부울(Boolean) 서비스 소프트웨어 업데이트가 선택 사항인지 여부입니다.

ServiceURL

Amazon ES 도메인으로 인덱스, 검색 및 데이터 업로드 요청을 제출하는 데 사용되는 도메인별 엔드포인트입니다.

필드 데이터 형식 설명
ServiceURL 문자열 Amazon ES 도메인으로 인덱스, 검색 및 데이터 업로드 요청을 제출하는 데 사용되는 도메인별 엔드포인트입니다.

SnapshotOptions

(사용되지 않음) Amazon Elasticsearch Service 인덱스 스냅샷 작업 단원을 참조하십시오. Amazon ES 도메인 인덱스의 일일 자동 스냅샷 생성 시간을 구성하는 데 필요한 파라미터의 컨테이너입니다.

Field 데이터 형식 설명
AutomatedSnapshotStartHour 정수 (사용되지 않음) 서비스가 Amazon ES 도메인의 인덱스에 대해 일일 자동 스냅샷을 생성하는 시간입니다.

태그

필드 데이터 형식 설명
Key TagKey 태그의 필수 이름입니다. 태그 키는 연결된 Amazon ES 도메인에 대해 고유해야 합니다. 자세한 내용은 Amazon Elasticsearch Service 도메인 태깅을 참조하십시오.
Value TagValue 태그의 선택적 문자열 값입니다. 태그 값은 태그 세트에서 고유할 필요는 없으며 null일 수 있습니다. 예를 들어, project/Trinity 및 cost-center/Trinity의 태그 세트에 키-값 페어가 있을 수 있습니다.

TagKey

필드 데이터 형식 설명
Key 문자열 태그의 이름입니다. 문자열은 최대 128자일 수 있습니다.

TagList

필드 데이터 형식 설명
Tag Tag Amazon ES 도메인에 연결된 리소스 태그입니다.

TagValue

필드 데이터 형식 설명
Value 문자열 TagKey의 값을 보관합니다. 문자열은 최대 256자일 수 있습니다.

VPCDerivedInfo

필드 데이터 형식 설명
VPCId 문자열 VPC의 ID입니다. VPC를 생성하면 Amazon VPC가 이 값을 생성합니다.
SubnetIds StringList 도메인의 VPC 엔드포인트와 연결된 서브넷 ID의 목록입니다. 자세한 내용은 Amazon VPC 사용 설명서의 VPC 및 서브넷 을 참조하십시오.
AvailabilityZones StringList VPC의 서브넷과 연결된 가용 영역의 목록입니다. 자세한 내용은 Amazon VPC 사용 설명서VPC 및 서브넷 기본 사항을 참조하십시오.
SecurityGroupIds StringList 도메인의 VPC 엔드포인트와 연결된 보안 그룹 ID의 목록입니다. 자세한 정보는 Amazon VPC 사용 설명서VPC의 보안 그룹 단원을 참조하십시오.

VPCOptions

필드 데이터 형식 설명
SubnetIds StringList 도메인의 VPC 엔드포인트와 연결된 서브넷 ID의 목록입니다. 도메인에서 여러 가용 영역으르 사용할 경우 영역당 2개의 서브넷 ID를 제공해야 합니다. 그렇지 않은 경우 하나만 제공합니다. 자세한 내용은 Amazon VPC 사용 설명서VPC 및 서브넷을 참조하십시오.
SecurityGroupIds StringList 도메인의 VPC 엔드포인트와 연결된 보안 그룹 ID의 목록입니다. 보안 그룹 ID를 제공하지 않은 경우 Amazon ES가 VPC의 기본 보안 그룹을 사용합니다. 자세한 내용은 Amazon VPC 사용 설명서VPC의 보안 그룹을 참조하십시오.
VPCId 문자열 VPC의 ID입니다.

ZoneAwarenessConfig

필드 데이터 형식 설명
AvailabilityZoneCount 정수 여러 가용 영역(AZ)을 활성화한 경우 이 필드는 도메인에서 사용할 영역 개수입니다. 유효 값은 23입니다.

오류

Amazon ES에서 다음 오류가 발생합니다.

예외 설명
BaseException 모든 서비스 오류에 대해 발생합니다. 오류의 HTTP 상태 코드가 포함되어 있습니다.
ValidationException HTTP 요청에 잘못된 입력이 포함되어 있거나 필요한 입력이 누락된 경우 발생합니다. HTTP 상태 코드 400을 반환합니다.
DisabledOperationException 클라이언트가 지원되지 않는 작업을 수행하려고 하면 발생합니다. HTTP 상태 코드 409을 반환합니다.
InternalException 요청 처리 중 서비스 내부 오류가 발생하는 경우 발생합니다. HTTP 상태 코드 500을 반환합니다.
InvalidTypeException 잘못되었거나 지원되지 않는 Amazon ES 도메인 하위 리소스를 만들거나 이러한 리소스에 액세스하려고 하면 발생합니다. HTTP 상태 코드 409을 반환합니다.
LimitExceededException 허용되는 개수 및 유형보다 많은 Amazon ES 도메인 리소스 및 하위 리소스를 만들려고 하면 발생합니다. HTTP 상태 코드 409을 반환합니다.
ResourceNotFoundException 존재하지 않는 리소스에 액세스하거나 이러한 리소스를 삭제하려고 하면 발생합니다. HTTP 상태 코드 400을 반환합니다.
ResourceAlreadyExistsException 클라이언트가 Amazon ES 도메인에 이미 존재하는 리소스를 만들려고 하는 경우 발생합니다. HTTP 상태 코드 400을 반환합니다.
AccessDeniedException
ConflictException