

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon MQ for ActiveMQ 代理程式組態
<a name="amazon-mq-broker-configuration-parameters"></a>

 組態使用 XML 格式 (類似於 ActiveMQ 的 `activemq.xml` 檔案)，包含 ActiveMQ 代理程式的所有設定。您可以在建立任何代理程式之前建立組態。然後，您可以將組態套用至一或多個代理程式。

**重要**  
對組態進行變更，*不會*立即將變更套用至代理程式。若要套用變更，您必須等待下一個維護時段或[重新啟動代理程式](amazon-mq-rebooting-broker.md)。  
您只能使用 `DeleteConfiguration` API **刪除**組態。如需詳細資訊，請參閱《*Amazon MQ API 參考*》中的[組態](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html)。

## 屬性
<a name="configuration-attributes"></a>

代理程式組態具有多個屬性，例如：
+ 名稱 (`MyConfiguration`)
+ ID (`c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Amazon 資源名稱 (ARN) (`arn:aws:mq:us-east-2:123456789012:configuration:c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)

如需組態屬性的完整清單，請參閱 *Amazon MQ REST API 參考*中的以下各節：
+ [REST 操作 ID：組態](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration.html)
+ [REST 操作 ID：組態](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configurations.html)

如需組態修訂屬性的完整清單，請參閱以下各節：
+ [REST 操作 ID：組態修訂](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revision.html)
+ [REST 操作 ID：組態修訂](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revisions.html)

## 使用 Spring XML 組態檔案
<a name="working-with-spring-xml-configuration-files"></a>

系統會使用 [Spring XML](https://docs.spring.io/spring/docs/current/spring-framework-reference/) 檔案來設定 ActiveMQ 代理程式。您可以設定 ActiveMQ 代理程式的多個層面，例如預先定義的目的地、目的地政策、授權政策，以及外掛程式。Amazon MQ 會控制其中一些組態元素，例如網路傳輸和儲存。目前不支援其他組態選項，例如代理程式網路的建立。

在 Amazon MQ XML 結構描述中，指定了完整的一組支援組態選項。請使用下列連結下載支援結構描述的 zip 檔案。
+ [samples/amazon-mq-active-mq-5.19.1.xsd.zip](samples/amazon-mq-active-mq-5.19.1.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.18.4.xsd.zip](samples/amazon-mq-active-mq-5.18.4.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.17.6.xsd.zip](samples/amazon-mq-active-mq-5.17.6.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.16.7.xsd.zip](samples/amazon-mq-active-mq-5.16.7.xsd.zip) 
+  [samples/amazon-mq-active-mq-5.15.16.xsd.zip](samples/amazon-mq-active-mq-5.15.16.xsd.zip) 

您可以使用這些結構描述來驗證和清理組態檔案。Amazon MQ 也可讓您藉由上傳 XML 檔案來提供組態。當您上傳 XML 檔案時，Amazon MQ 會根據結構描述自動清除並移除無效及禁止的組態參數。

**注意**  
您只能對屬性使用靜態值。Amazon MQ 會從您的組態中清除包含 Spring 運算式、變數和元素參考的元素和屬性。