Skip to main content
È disponibile una versione più recente di questo prodotto.
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Specificare un URN per un endpoint dei servizi della piattaforma StorageGRID

PDF

Quando crei un endpoint dei servizi di piattaforma, devi specificare un Unique Resource Name (URN). Utilizzerai l'URN per fare riferimento all'endpoint quando crei un XML di configurazione per il servizio di piattaforma. L'URN per ciascun endpoint deve essere univoco.

StorageGRID convalida gli endpoint dei servizi di piattaforma mentre li crei. Prima di creare un endpoint dei servizi di piattaforma, conferma che la risorsa specificata nell'endpoint esista e sia raggiungibile.

Elementi URN

L'URN per un endpoint dei servizi della piattaforma deve iniziare con arn:aws o urn:mysite, come segue:

  • Se il servizio è ospitato su Amazon Web Services (AWS), usa arn:aws

  • Se il servizio è ospitato su Google Cloud Platform (GCP), usa arn:aws

  • Se il servizio è ospitato in locale, usa urn:mysite

Ad esempio, se stai specificando l'URN per un CloudMirror endpoint ospitato su StorageGRID, l'URN potrebbe iniziare con urn:sgws.

L'elemento successivo dell'URN specifica il tipo di servizio della piattaforma, come segue:

Servizio Tipo

replicazione CloudMirror

s3

Notifiche

sns, kafka, o webhook

Integrazione della ricerca

es

Ad esempio, per continuare a specificare l'URN per un endpoint CloudMirror ospitato su StorageGRID, aggiungeresti s3 per ottenere urn:sgws:s3.

Per la maggior parte degli endpoint, l'elemento finale dell'URN identifica la risorsa specifica di destinazione all'URI di destinazione, ad esempio sns-topic-name.

Per gli endpoint webhook, la risorsa di destinazione è l'URI di destinazione stesso.

Servizio Risorsa specifica

replicazione CloudMirror

bucket-name

Notifiche

sns-topic-name o kafka-topic-name

Nota: Per gli endpoint webhook, l'ultimo elemento dell'URN può essere una stringa qualsiasi, purché l'URN dell'endpoint sia univoco.

Integrazione della ricerca

domain-name/index-name/type-name

Nota: Se il cluster Elasticsearch non è configurato per creare automaticamente gli indici, devi creare l'indice manualmente prima di creare l'endpoint.

URN per i servizi ospitati su AWS e GCP

Per le entità AWS e GCP, l'URN completo è un ARN AWS valido. Ad esempio:

  • Replicazione CloudMirror:

    arn:aws:s3:::bucket-name

  • Notifiche:

    arn:aws:sns:region:account-id:topic-name

  • Integrazione della ricerca:

    arn:aws:es:region:account-id:domain/domain-name/index-name/type-name
    Nota Per un endpoint di integrazione della ricerca AWS, il domain-name deve includere la stringa letterale domain/, come mostrato qui.

URN per i servizi ospitati localmente

Quando utilizzi servizi ospitati localmente anziché servizi cloud, puoi specificare l'URN in qualsiasi modo crei un URN valido e univoco, purché l'URN includa gli elementi richiesti nella terza e ultima posizione. Puoi lasciare vuoti gli elementi indicati come opzionali, oppure puoi specificarli in qualsiasi modo ti aiuti a identificare la risorsa e a rendere l'URN univoco. Ad esempio:

  • Replicazione CloudMirror:

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

    Per un endpoint CloudMirror ospitato su StorageGRID, puoi specificare un URN valido che inizia con urn:sgws:

    urn:sgws:s3:optional:optional:bucket-name

  • Notifiche:

    Specifica un endpoint di Amazon Simple Notification Service:

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

    Specifica un endpoint Kafka:

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

    Specifica un endpoint webhook:

    urn:mysite:webhook:optional:optional:webhook-name

  • Integrazione della ricerca:

    urn:mysite:es:optional:optional:domain-name/index-name/type-name
    Nota Per gli endpoint di integrazione della ricerca ospitati localmente, l'elemento domain-name può essere qualsiasi stringa, purché l'URN dell'endpoint sia univoco.