本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
类型定义架构
以下各节详细介绍了用于类型定义的架构。
$id
$id 元素标识架构定义。它必须遵循以下结构：
从
/schema-versions/URI 前缀开始包括
definition架构类型使用正斜杠 (
/) 作为 URI 路径分隔符包括架构标识，片段之间用句点分隔 (
.)使用
@字符分隔架构 ID 和版本以 semver 版本结尾，使用句点 (
.) 分隔版本片段
架构标识必须以长度为 3-12 个字符的根命名空间开头，然后是可选的子命名空间和名称。
semver 版本包括主要版本（最多 3 位数）、次要版本（最多 3 位数）和可选的补丁版本（最多 4 位数）。
注意
您不能使用保留的命名空间或 aws matter
例示例 $id
/schema-version/capability/aws.Recording@1.0
$ref
$ref 元素引用系统中现有的类型定义。它遵循与$id元素相同的约束。
注意
类型定义或功能必须与$ref文件中提供的值相同。
例示例 $ref
/schema-version/definition/aws.capability@1.0
名称
名称元素是一个字符串，表示架构文档中的实体名称。它通常包含缩写，必须遵循以下规则：
仅包含字母数字字符、句点 (.)、正斜杠 (/)、连字符 (-) 和空格
-
以字母开头
最多 192 个字符
Amazon Web Services 控制台用户界面和文档中使用名称元素。
例示例名称
Door Lock On/Off Wi-Fi Network Management PM2.5 Concentration Measurement RTCSessionController Energy EVSE
删除实例快照
标题元素是架构文档所代表的实体的描述性字符串。它可以包含任何字符，可在文档中使用。
例标题示例
Real-time Communication (RTC) Session Controller Energy EVSE Capability
description
该description元素详细解释了架构文档所代表的实体。它可以包含任何字符，可在文档中使用。
例示例描述
Electric Vehicle Supply Equipment (EVSE) is equipment used to charge an Electric Vehicle (EV) or Plug-In Hybrid Electric Vehicle. This capability provides an interface to the functionality of Electric Vehicle Supply Equipment (EVSE) management.
extrinsiCID
该extrinsicId元素表示在 Amazon Web Services 物联网系统之外管理的标识符。对于 Matter 能力，它会映射到clusterIdattributeIdcommandIdeventId、、fieldId、或，具体取决于上下文。
extrinsicId可以是字符串化的十进制整数（1-10 位数），也可以是字符串化的十六进制整数（0x 或 0X 前缀，后面是 1-8 个十六进制数字）。
注意
对于 AWS，供应商 ID (VID) 为 0x1577，对于 Matter，则为 0。系统确保自定义架构不会使用这些 VIDs 为功能保留的内容。
例示例 extinSICID
0018 0x001A 0x15771002
外在特性
该extrinsicProperties元素包含一组在外部系统中定义但保留在数据模型中的属性。对于 Matter 功能，它映射到 ZCL 集群、属性、命令或事件中不同的未建模或部分建模的元素。
外在属性必须遵循以下限制：
属性名称必须是字母数字，不含空格或特殊字符
属性值可以是任何 JSON 架构值
最多 20 处房产
该系统支持多种功能extrinsicProperties，包括access、apiMaturity、clicliFunctionName、和其他。这些属性便于 ACL 进行数据模型转换 AWS （反之亦然）。
注意
功能的action、event、和struct字段元素支持外部属性property，但不支持能力或集群本身。
