受管結構描述

Cloud Directory 讓快速開發應用程式變得更加容易，藉此使用受管結構描述。透過受管結構描述，您就能建立目錄，然後更快速地從該目錄開始建立和擷取物件。如需詳細資訊，請參閱 建立您的目錄。

本服務目前擁有一個受管結構描述，稱為 QuickStartSchema。您可以利用類型連結等架構，藉此建置豐富的階層式資料模型，並建立各物件間的關係。接著，您便能周遊這些階層，進而在資料中查詢任何資訊。

QuickStartSchema​ 受管結構描述會以下列 JSON 格式呈現：

QuickStartSchema: {
    "facets": {
        "DynamicObjectFacet": {
            "facetStyle": "DYNAMIC"
        },
        "DynamicTypedLinkFacet": {
            "facetAttributes": {
                "DynamicTypedLinkAttribute": {
                    "attributeDefinition": {
                        "attributeRules": {},
                        "attributeType": "VARIANT",
                        "isImmutable": false
                    },
                    "requiredBehavior": "REQUIRED_ALWAYS"
                }
            },
            "identityAttributeOrder": [
                "DynamicAttribute"
            ]
        }
    }
}

QuickStartSchema ARN

QuickStartSchema 受管結構描述會採用下列 ARN：

String QUICK_START_SCHEMA_ARN = "arn:aws:clouddirectory:::schema/managed/quick_start/1.0/001" ;

舉例來說，您可以使用此 ARN 來建立名為 ExampleDirectory​ 的目錄，如下所示：

CreateDirectoryRequest createDirectoryRequest = new CreateDirectoryRequest()
    .withName("ExampleDirectory") // Directory name
    .withSchemaArn(QUICK_START_SCHEMA_ARN);

面向樣式

本服務擁有兩種不同的樣式 (Static​ 和 Dynamic)，可供您定義任何指定面向。

靜態面向

靜態面向是最佳選擇，當您擁有資料模型的所有細節 (如屬性及其資料類型的清單)，並且您還想定義屬性的限制條件 (如必要或唯一欄位)。Cloud Directory 會在您的物件建立或變更期間強制執行資料約束和規則檢查。

動態面向

若您選擇使用動態面向，即可視需要彈性地變更屬性數量，或是變更屬性內存放的資料值。在建立或變更物件期間，Cloud Directory 不會強制執行任何資料限制和規則檢查。

一旦建立具有動態面向的結構描述，您就能定義建立物件時所需的任何屬性。Cloud Directory 會接受索引鍵/值組形式的屬性，並將其存放至提供的物件上。

您可以將動態面向新增至新的或現有的結構描述。此外，您也可以在單一結構描述內結合使用靜態和動態面向，進而在目錄內善用每種面向樣式的優點，從中獲益。

當您使用動態面向建立任何屬性時，系統即會將這些屬性建立為 Variant​ 資料類型。若要儲存定義為Variant資料類型，您可以使用 Cloud Directory 支援的任何基本資料類型值 (如String或Binary。日後，您也能將屬性值變更為另一種資料類型；系統並不會強制驗證資料。

您可以透過動態面向來定義下列類型的物件：

• NODE

• LEAF_NODE

• POLICY

如需有關受管理的結構描述、動態 Facet 或變體資料類型的其他詳細資料，以及查看範例使用案例，請參閱如何使用 AWS 受管結構描述，快速開發應 Amazon Cloud Directory 程式在 Amazon Cloud Directory 部落格中。