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

为 StorageGRID 平台服务端点指定 URN

创建平台服务端点时,必须指定唯一资源名称 (URN)。为平台服务创建配置 XML 时,将使用 URN 引用端点。每个端点的 URN 必须是唯一的。

StorageGRID 在创建平台服务端点时会对其进行验证。在创建平台服务端点之前,请确认端点中指定的资源存在且可以访问。

URN 元素

平台服务端点的 URN 必须以 arn:awsurn:mysite 开头,如下所示:

  • 如果服务托管在Amazon Web Services (AWS)上,请使用 arn:aws

  • 如果服务托管在Google Cloud Platform (GCP)上,请使用 arn:aws

  • 如果服务是本地托管的,请使用 urn:mysite

例如,如果要为托管在 StorageGRID 上的 CloudMirror 端点指定 URN,则 URN 可能以 `urn:sgws`开头。

URN 的下一个元素指定了平台服务的类型,如下所示:

服务 类型

CloudMirror 复制

s3

通知

snskafka,或 webhook

搜索集成

es

例如,要继续为托管在 StorageGRID 上的 CloudMirror 端点指定 URN,您可以添加 s3`以获得 `urn:sgws:s3

对于大多数端点,URN 的最后一个元素标识目标 URI 处的特定目标资源,例如 sns-topic-name

对于 Webhook 端点,目标资源本身就是目标 URI。

服务 特定资源

CloudMirror 复制

bucket-name

通知

sns-topic-namekafka-topic-name

注意: 对于 Webhook 端点,只要端点的 URN 是唯一的,URN 的最后一个元素可以是任何字符串。

搜索集成

domain-name/index-name/type-name

注意: 如果 Elasticsearch 集群*未*配置为自动创建索引,则必须在创建端点之前手动创建索引。

AWS 和 GCP 上托管的服务的 URN

对于 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/,如下所示。

本地托管服务的 URN

使用本地托管服务而不是云服务时,您可以以任何方式指定 URN,以创建有效且唯一的 URN,只要 URN 在第三个和最终位置中包含所需的元素即可。您可以将可选元素留空,也可以以任何方式指定它们,以帮助您识别资源并使 URN 唯一。例如:

  • CloudMirror 复制:

    urn:mysite:s3:optional:optional:bucket-name

    对于托管在 StorageGRID 上的 CloudMirror 端点,您可以指定一个有效的 URN,其开头为 urn:sgws

    urn:sgws:s3:optional:optional:bucket-name
  • 通知:

    指定 Amazon Simple Notification Service 端点:

    urn:mysite:sns:optional:optional:sns-topic-name

    请指定 Kafka 终结点:

    urn:mysite:kafka:optional:optional:kafka-topic-name

    指定 Webhook 端点:

    urn:mysite:webhook:optional:optional:webhook-name
  • 搜索集成:

    urn:mysite:es:optional:optional:domain-name/index-name/type-name
    备注 对于本地托管的搜索集成端点,只要端点的 URN 是唯一的,该 `domain-name`元素可以是任何字符串。