本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # OpenSearch \$1 建立網域 建立 Amazon OpenSearch Service 網域。OpenSearch 網域會封裝處理 OpenSearch 請求的 OpenSearch 引擎執行個體。Amazon OpenSearch Service 支援 OpenSearch 和舊版 Elasticsearch OSS (最高為 7.10，該軟體的最終開放原始碼版本)。 **完整分類：**部署 \$1 進階堆疊元件 \$1 OpenSearch \$1 建立網域 ## 變更類型詳細資訊 **** | | | | --- |--- | | 變更類型 ID | ct-281et7bs9ep4s | | 目前版本 | 2.0 | | 預期的執行持續時間 | 360 分鐘 | | AWS 核准 | 必要 | | 客戶核准 | 非必要 | | 執行模式 | 自動化 | ## 其他資訊 ### 建立 OpenSearch Service 網域 #### 使用主控台建立 OpenSearch 網域 AMS 主控台中此變更類型的螢幕擷取畫面： ![\[Amazon OpenSearch Service domain creation details, including ID, execution mode, and classification.\]](http://docs.aws.amazon.com/zh_tw/managedservices/latest/ctref/images/guiCreateOpenSearchDomainCT.png) 運作方式： 1. 導覽至**建立 RFC** 頁面：在 AMS 主控台的左側導覽窗格中，按一下 **RFCs**以開啟 RFCs清單頁面，然後按一下**建立 RFC**。 1. 在預設**瀏覽變更類型檢視中選擇熱門的變更類型** (CT)，或在**依類別選擇**檢視中選擇 CT。 + **依變更類型瀏覽**：您可以在**快速建立**區域中按一下熱門的 CT，以立即開啟**執行 RFC** 頁面。請注意，您無法透過快速建立選擇較舊的 CT 版本。 若要排序 CTs，請使用**卡片**或**資料表**檢視中的所有**變更類型**區域。在任一檢視中，選取 CT，然後按一下**建立 RFC** 以開啟**執行 RFC** 頁面。如果適用，**建立較舊版本**選項會顯示在**建立 RFC** 按鈕旁。 + **依類別選擇**：選取類別、子類別、項目和操作，如果適用，CT 詳細資訊方塊會開啟，其中包含**使用較舊版本建立**的選項。按一下**建立 RFC** 以開啟**執行 RFC** 頁面。 1. 在**執行 RFC** 頁面上，開啟 CT 名稱區域以查看 CT 詳細資訊方塊。需要**主旨** （如果您在**瀏覽變更類型**檢視中選擇 CT，則會為您填入）。開啟**其他組態**區域以新增 RFC 的相關資訊。 在**執行組態**區域中，使用可用的下拉式清單或輸入必要參數的值。若要設定選用的執行參數，請開啟**其他組態**區域。 1. 完成後，請按一下**執行**。如果沒有錯誤，**RFC 成功建立**的頁面會顯示已提交的 RFC 詳細資訊，以及初始的**執行輸出**。 1. 開啟**執行參數**區域以查看您提交的組態。重新整理頁面以更新 RFC 執行狀態。或者，取消 RFC 或使用頁面頂端的選項建立 RFC 的副本。 #### 使用 CLI 建立 OpenSearch 網域 運作方式： 1. 使用內嵌建立 （您發出包含所有 RFC 和執行參數的`create-rfc`命令） 或範本建立 （您建立兩個 JSON 檔案，一個用於 RFC 參數，另一個用於執行參數），並使用兩個檔案作為輸入發出`create-rfc`命令。此處說明這兩種方法。 1. 使用傳回的 RFC ID 提交 RFC： `aws amscm submit-rfc --rfc-id ID`命令。 監控 RFC： `aws amscm get-rfc --rfc-id ID`命令。 若要檢查變更類型版本，請使用下列命令： ``` aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID ``` **注意** 您可以將任何`CreateRfc`參數與任何 RFC 搭配使用，無論它們是否為變更類型結構描述的一部分。例如，若要在 RFC 狀態變更時取得通知，請將此行新增至請求的 `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` RFC 參數部分 （而非執行參數）。如需所有 CreateRfc 參數的清單，請參閱 [AMS 變更管理 API 參考](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html)。 *內嵌建立*： 使用內嵌提供的執行參數發出建立 RFC 命令 （在內嵌提供執行參數時逸出引號），然後提交傳回的 RFC ID。例如，您可以將內容取代為類似以下內容： ``` aws amscm create-rfc \ --change-type-id "ct-281et7bs9ep4s" \ --change-type-version "2.0" --title "Create OpenSearch domain" \ --execution-parameters "{\"Description\":\"Create OS domain\",\"VpcId\":\"vpc-317a9856\",\"Name\": \"OpenSearchDomain\",\"StackTemplateId\": \"stm-szccoe01000000000\",\"TimeoutInMinutes\": 60,\"Parameters\":{\"DomainName\":\"opensearchdomain\",\"EngineVersion\":\"OpenSearch_7.10\",\"DedicatedMasterCount\": \"3\",\"DedicatedMasterType\": \"r5.xlarge.search\",\"InstanceType\": \"r5.xlarge.search\",\"InstanceCount\": 2\"EBSIops\": \"0\",\"EBSVolumeSize\": 100\"EBSVolumeType\": \"gp2\",\"SubnetIds\":[\"subnet-d3cf52f9\"]}}" \ ``` *範本建立*： 1. 將此變更類型的執行參數 JSON 結構描述輸出至 JSON 檔案；此範例會將其命名為 CreateOpenSearchDomainParams.json: ``` aws amscm get-change-type-version --change-type-id "ct-281et7bs9ep4s" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateOpenSearchDomainParams.json ``` 1. 修改並儲存 CreateOpenSearchDomainParams 檔案。請參閱以下範例；請務必修改這些參數，以符合您的特定需求。 ``` { "Description": "OpenSearch Service Domain", "VpcId": "vpc-317a9856", "Name": "open_search", "StackTemplateId": "stm-szccoe02000000000", "TimeoutInMinutes": 60, "Parameters": { "DomainName": "my-opensearch-domain", "EngineVersion": "OpenSearch_2.3", "DedicatedMasterCount": "3", "DedicatedMasterType": "r6g.large.search", "InstanceType": "r6g.large.search", "InstanceCount": "2", "EBSVolumeSize": "35", "EBSVolumeType": "gp3", "SubnetIds": [ "subnet-0123456789abcdefg" ] } } ``` 1. 將 RFC 範本輸出至目前資料夾中的檔案；此範例會將其命名為 CreateOpenSearchDomainRfc.json: ``` aws amscm create-rfc --generate-cli-skeleton > CreateOpenSearchDomainRfc.json ``` 1. 修改並儲存 CreateOpenSearchDomainRfc.json 檔案。例如，您可以將內容取代為類似以下內容： ``` { "ChangeTypeId": "ct-281et7bs9ep4s", "ChangeTypeVersion": "1.0", "Title": "Create OpenSearch domain" } ``` 1. 建立 RFC，指定 CreateOpenSearchDomainRfc 檔案和 CreateOpenSearchDomainParams 檔案： ``` aws amscm create-rfc --cli-input-json file://CreateOpenSearchDomainRfc.json --execution-parameters file://CreateOpenSearchDomainParams.json ``` 您會在回應中收到新 RFC 的 ID，並且可以使用它來提交和監控 RFC。在您提交之前，RFC 會保持在編輯狀態，不會啟動。 #### 提示 此變更類型會取代先前的變更類型 ct-0azen3a9anxzj。 ## 執行輸入參數 如需執行輸入參數的詳細資訊，請參閱 [變更類型的結構描述 ct-281et7bs9ep4s](schemas.md#ct-281et7bs9ep4s-schema-section)。 ## 範例：必要參數 ``` { "Description": "Test description", "VpcId": "vpc-12345678", "Name": "teststak", "StackTemplateId": "stm-szccoe02000000000", "TimeoutInMinutes": 60, "Parameters": { "DomainName": "testdomain", "EngineVersion": "Elasticsearch_7.10", "DedicatedMasterCount": "0", "DedicatedMasterType": "r6g.large.search", "InstanceType": "r6g.large.search", "InstanceCount": 1, "EBSIops": "1000", "EBSThroughput": "125", "EBSVolumeSize": 100, "EBSVolumeType": "gp2", "SubnetIds": [ "subnet-12345678", "subnet-13456789" ] } } ``` ## 範例：所有參數 ``` { "Description": "Test description", "VpcId": "vpc-12345678", "Name": "teststak", "StackTemplateId": "stm-szccoe02000000000", "TimeoutInMinutes": 60, "Tags": [ { "Key": "foo", "Value": "bar" }, { "Key": "testkey", "Value": "testvalue" } ], "Parameters": { "DomainName": "testdomain", "EngineVersion": "Elasticsearch_7.10", "DedicatedMasterCount": "0", "DedicatedMasterType": "r6g.large.search", "InstanceType": "r6g.large.search", "InstanceCount": 1, "ZoneAwarenessEnabled": "false", "EBSIops": "1000", "EBSThroughput": "125", "EBSVolumeSize": 100, "EBSVolumeType": "gp2", "EncryptionKey": "default", "AutomatedSnapshotStartHour": "", "AllowExplicitIndex": "true", "IndicesFieldDataCacheSize": "20", "MaxClauseCount": "512", "SubnetIds": [ "subnet-12345678" ] } } ```