Skip to main content
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Especifique um URN para um endpoint de serviços de plataforma StorageGRID

PDFs

Ao criar um endpoint de serviços de plataforma, você deve especificar um Nome de Recurso Único (URN). Você usará o URN para referenciar o endpoint ao criar um arquivo XML de configuração para o serviço de plataforma. O URN de cada endpoint deve ser único.

StorageGRID valida os endpoints dos serviços da plataforma à medida que você os cria. Antes de criar um endpoint de serviço da plataforma, confirme que o recurso especificado no endpoint existe e que ele pode ser acessado.

Elementos URN

O URN para um endpoint de serviços de plataforma deve começar com arn:aws ou urn:mysite, conforme mostrado a seguir:

  • Se o serviço estiver hospedado na Amazon Web Services (AWS), use arn:aws

  • Se o serviço estiver hospedado no Google Cloud Platform (GCP), use arn:aws

  • Se o serviço estiver hospedado localmente, use urn:mysite

Por exemplo, se você estiver especificando o URN para um CloudMirror endpoint hospedado no StorageGRID, o URN pode começar com urn:sgws.

O próximo elemento do URN especifica o tipo de serviço de plataforma, da seguinte forma:

Serviço Tipo

CloudMirror replicação

s3

Notificações

sns, kafka, ou webhook

Integração de pesquisa

es

Por exemplo, para continuar especificando o URN para um CloudMirror endpoint hospedado no StorageGRID, você adicionaria s3 para obter urn:sgws:s3.

Para a maioria dos endpoints, o elemento final do URN identifica o recurso de destino específico no URI de destino, por exemplo, sns-topic-name.

Para endpoints de webhook, o recurso de destino é o próprio URI de destino.

Serviço Recurso específico

CloudMirror replicação

bucket-name

Notificações

sns-topic-name ou kafka-topic-name

Nota: Para endpoints de webhook, o elemento final do URN pode ser qualquer string, desde que o URN do endpoint seja único.

Integração de pesquisa

domain-name/index-name/type-name

Observação: Se o cluster Elasticsearch não estiver configurado para criar índices automaticamente, você deve criar o índice manualmente antes de criar o endpoint.

URNs para serviços hospedados na AWS e no GCP

Para entidades AWS e GCP, o URN completo é um ARN AWS válido. Por exemplo:

  • CloudMirror replicação:

    arn:aws:s3:::bucket-name

  • Notificações:

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

  • Integração de pesquisa:

    arn:aws:es:region:account-id:domain/domain-name/index-name/type-name
    Observação Para um endpoint de integração de pesquisa da AWS, o domain-name deve incluir a string literal domain/, conforme mostrado aqui.

URNs para serviços hospedados localmente

Ao usar serviços hospedados localmente em vez de serviços em nuvem, você pode especificar o URN de qualquer forma que crie um URN válido e exclusivo, desde que o URN inclua os elementos obrigatórios na terceira e na última posição. Você pode deixar os elementos indicados como opcionais em branco ou especificá-los de qualquer forma que ajude você a identificar o recurso e tornar o URN exclusivo. Por exemplo:

  • CloudMirror replicação:

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

    Para um CloudMirror endpoint hospedado no StorageGRID, você pode especificar um URN válido que comece com urn:sgws:

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

  • Notificações:

    Especifique um endpoint do Amazon Simple Notification Service:

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

    Especifique um endpoint do Kafka:

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

    Especifique um endpoint de webhook:

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

  • Integração de pesquisa:

    urn:mysite:es:optional:optional:domain-name/index-name/type-name
    Observação Para endpoints de integração de pesquisa hospedados localmente, o domain-name elemento pode ser qualquer string, desde que o URN do endpoint seja único.