为平台服务端点指定 URN
创建平台服务端点时,必须指定唯一资源名称( URN )。在为平台服务创建配置 XML 时,您将使用 URN 引用此端点。每个端点的 URN 必须是唯一的。
StorageGRID 会在您创建平台服务端点时对其进行验证。在创建平台服务端点之前,请确认此端点中指定的资源存在且可访问。
urn 元素
平台服务端点的 URN 必须以 arn : AWS
或 urn : mysite
开头,如下所示:
-
如果此服务托管在 Amazon Web Services ( AWS )上,请使用
arn : AWS
。 -
如果此服务托管在 Google Cloud Platform ( GCP )上,请使用
arn : AWS
。 -
如果服务托管在本地,请使用
urn : mysite
例如,如果要为 StorageGRID 上托管的 CloudMirror 端点指定 URN ,则 URN 可能以 urn : sgws
开头。
URN 的下一个元素用于指定平台服务的类型,如下所示:
服务 | Type |
---|---|
CloudMirror 复制 |
S3 |
通知 |
SnS |
搜索集成 |
ES |
例如,要继续为 StorageGRID 上托管的 CloudMirror 端点指定 URN ,您应添加 s 3
以获取 urn : sgws : S3
。
URN 的最后一个元素用于标识目标 URI 上的特定目标资源。
服务 | 特定资源 |
---|---|
CloudMirror 复制 |
分段名称 |
通知 |
Sns-topic-name |
搜索集成 |
|
AWS 和 GCP 上托管的服务的 urns
对于 AWS 和 GCP 实体,完整的 URN 是有效的 AWS ARN 。例如:
-
CloudMirror 复制:
arn:aws:s3:::bucket-name
-
通知:
arn:aws:sns:region:account-id:topic-name
-
搜索集成:
arn:aws:es:region:account-id:domain/domain-name/index-name/type-name
对于 AWS 搜索集成端点, domain-name
必须包含文字字符串domain/
,如下所示。
用于本地托管服务的 urns
使用本地托管的服务而非云服务时,只要 URN 在第三个和最后一个位置包含所需的元素,您就可以以任何方式指定 URN 以创建有效且唯一的 URN 。您可以将可选元素留空,也可以通过任何方式指定这些元素,以帮助您标识资源并使 URN 具有唯一性。例如:
-
CloudMirror 复制:
urn:mysite:s3:optional:optional:bucket-name
对于 StorageGRID 上托管的 CloudMirror 端点,您可以指定以
urn : sgws
开头的有效 URN :urn:sgws:s3:optional:optional:bucket-name
-
通知:
urn:mysite:sns:optional:optional:sns-topic-name
-
搜索集成:
urn:mysite:es:optional:optional:domain-name/index-name/type-name
对于本地托管的搜索集成端点,只要端点的 URN 是唯一的, domain-name
element 就可以是任意字符串。