Skip to main content
简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

为平台服务端点指定 URN

贡献者
PDF

创建平台服务端点时，必须指定唯一资源名称（ 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

搜索集成

domain-name/index-name/type-name

  • 注意： * 如果 Elasticsearch 集群已配置为 * 不 * 自动创建索引，则必须在创建端点之前手动创建索引。

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 就可以是任意字符串。