View a markdown version of this page

Fazendo e assinando solicitações OpenSearch de serviço - OpenSearch Serviço Amazon

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Fazendo e assinando solicitações OpenSearch de serviço

Mesmo se você configurar uma política de acesso totalmente aberta baseada em recursos, todas as solicitações para a API de configuração do OpenSearch serviço devem ser assinadas. Se suas políticas especificarem funções ou usuários do IAM, as solicitações para as OpenSearch APIs também precisarão ser assinadas usando o AWS Signature versão 4. O método de assinatura é diferente dependendo da API:

  • Para fazer chamadas para a API OpenSearch de configuração do serviço, recomendamos que você use um dos AWS SDKs. Os SDKs simplificam muito o processo e podem economizar uma quantidade significativa de tempo em comparação com a criação e assinatura das suas próprias solicitações. Os endpoints da API de configuração usam o formato a seguir:

    es.region.amazonaws.com/2021-01-01/

    Por exemplo, a seguinte solicitação faz uma alteração de configuração no domínio movies, mas é necessário que você a assine (não recomendado):

    POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/movies/config
{
  "ClusterConfig": {
    "InstanceType": "c5.xlarge.search"
  }
}

    Se você usar um dos SDKs, como Boto 3, o SDK gerencia automaticamente a assinatura de solicitações:

    import boto3

client = boto3.client(es)
response = client.update_domain_config(
  DomainName='movies',
  ClusterConfig={
    'InstanceType': 'c5.xlarge.search'
  }
)

    Para obter um código de exemplo Java, consulte Usando o AWS SDKs para interagir com o Amazon OpenSearch Service.

  • Para fazer chamadas para as OpenSearch APIs, você deve assinar suas próprias solicitações. As APIs do OpenSearch usam o formato a seguir:

    domain-id.region.es.amazonaws.com

    Por exemplo, a seguinte solicitação procura o índice movies para thor:

    GET https://my-domain.us-east-1.es.amazonaws.com/movies/_search?q=thor
nota

O serviço ignora parâmetros passados em URLs para solicitações HTTP POST assinadas com o Signature versão 4.