Geben Sie eine URN für einen StorageGRID Plattformdienste-Endpunkt an
Beim Erstellen eines Plattformdienste-Endpunkts müssen Sie einen eindeutigen Ressourcennamen (URN) angeben. Der URN wird verwendet, um auf den Endpunkt zu verweisen, wenn eine Konfigurations-XML für den Plattformdienst erstellt wird. Der URN für jeden Endpunkt muss eindeutig sein.
StorageGRID validiert Plattformdienste-Endpunkte bei deren Erstellung. Vor dem Erstellen eines Plattformdienste-Endpunkts sollte bestätigt werden, dass die im Endpunkt angegebene Ressource existiert und erreichbar ist.
URN-Elemente
Die URN für einen Plattformdienste-Endpunkt muss entweder mit arn:aws oder urn:mysite beginnen, wie folgt:
-
Wenn der Dienst auf Amazon Web Services (AWS) gehostet wird, verwenden Sie
arn:aws -
Wenn der Dienst auf der Google Cloud Platform (GCP) gehostet wird, verwenden Sie
arn:aws -
Wenn der Dienst lokal gehostet wird, verwenden Sie
urn:mysite
Wenn Sie beispielsweise die URN für einen CloudMirror Endpunkt angeben, der auf StorageGRID gehostet wird, könnte die URN mit urn:sgws beginnen.
Das nächste Element der URN spezifiziert die Art des Plattformdienstes wie folgt:
| Service | Typ |
|---|---|
CloudMirror Replikation |
|
Benachrichtigungen |
|
Suchintegration |
|
Um beispielsweise die URN für einen CloudMirror-Endpunkt auf StorageGRID weiter anzugeben, würde s3 hinzugefügt, um urn:sgws:s3 zu erhalten.
Bei den meisten Endpunkten identifiziert das letzte Element der URN die spezifische Zielressource unter dem Ziel-URI, zum Beispiel sns-topic-name.
Bei Webhook-Endpunkten ist die Zielressource die Ziel-URI selbst.
| Service | Spezifische Ressource |
|---|---|
CloudMirror Replikation |
|
Benachrichtigungen |
Hinweis: Bei Webhook-Endpunkten kann das letzte Element der URN eine beliebige Zeichenkette sein, solange die URN des Endpunkts eindeutig ist. |
Suchintegration |
Hinweis: Wenn der Elasticsearch Cluster nicht so konfiguriert ist, dass Indizes automatisch erstellt werden, muss der Index manuell erstellt werden, bevor der Endpunkt erstellt wird. |
URNs für Dienste, die auf AWS und GCP gehostet werden
Für AWS- und GCP-Entitäten ist die vollständige URN ein gültiger AWS ARN. Beispiel:
-
CloudMirror Replikation:
arn:aws:s3:::bucket-name
-
Benachrichtigungen:
arn:aws:sns:region:account-id:topic-name
-
Suchintegration:
arn:aws:es:region:account-id:domain/domain-name/index-name/type-name
Für einen AWS-Suchintegrationsendpunkt muss domain-namedie Zeichenkettedomain/wörtlich enthalten sein, wie hier gezeigt.
URNs für lokal gehostete Dienste
Bei der Verwendung lokal gehosteter Dienste anstelle von Cloud-Diensten kann die URN auf beliebige Weise angegeben werden, solange sie gültig und eindeutig ist und die erforderlichen Elemente an der dritten und letzten Stelle enthält. Die mit „optional“ gekennzeichneten Elemente können leer gelassen oder auf eine Weise angegeben werden, die hilft, die Ressource zu identifizieren und die URN eindeutig zu machen. Beispiel:
-
CloudMirror Replikation:
urn:mysite:s3:optional:optional:bucket-name
Für einen CloudMirror Endpoint auf StorageGRID kann eine gültige URN angegeben werden, die mit
urn:sgwsbeginnt:urn:sgws:s3:optional:optional:bucket-name
-
Benachrichtigungen:
Einen Amazon Simple Notification Service Endpunkt angeben:
urn:mysite:sns:optional:optional:sns-topic-name
Einen Kafka-Endpunkt angeben:
urn:mysite:kafka:optional:optional:kafka-topic-name
Einen Webhook-Endpunkt angeben:
urn:mysite:webhook:optional:optional:webhook-name
-
Suchintegration:
urn:mysite:es:optional:optional:domain-name/index-name/type-name
Bei lokal gehosteten Suchintegrationsendpunkten kann das domain-nameElement eine beliebige Zeichenkette sein, solange die URN des Endpunkts eindeutig ist.