Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Invio di richieste di configurazione in Amazon CloudSearch
Importante
Il modo più semplice per inviare richieste di configurazione consiste nell'utilizzare la CloudSearch console Amazon, gli strumenti a riga di CloudSearch comando di Amazon o il comando AWS SDK per Java, JavaScript,. NETPHP, Ruby o Python (Boto). Gli strumenti a riga di comando SDKs gestiscono il processo di firma per te e assicurano che le richieste di CloudSearch configurazione di Amazon vengano formate correttamente. Per ulteriori informazioni su AWSSDKs, consulta AWSSoftware Development Kits
Invia richieste di CloudSearch configurazione Amazon all' CloudSearch endpoint Amazon per la tua regione utilizzando il protocollo AWS Query. Per l'elenco corrente delle regioni e degli endpoint supportati, consulta Regioni ed endpoint.
AWSLe richieste di query sono HTTP o HTTPS le richieste inviate tramite HTTP GET o POST con un parametro Query denominato Action. È necessario specificare la API versione in tutte le richieste di configurazione e tale versione deve corrispondere alla API versione specificata al momento della creazione del dominio.
È necessario includere parametri di autorizzazione e una firma digitale in ogni richiesta. Amazon CloudSearch supporta la versione 4 di AWS Signature. Per istruzioni dettagliate sulla firma, consulta il processo di firma di Signature V4 nella AWS Guida generale.
Nota
Amazon CloudSearch limita le richieste eccessive al servizio di configurazione. La limitazione avviene per azione, quindi DescribeDomains le richieste eccessive non inducono Amazon CloudSearch a limitarle. DescribeIndexFields Il limite di richieste cambia in base alle esigenze del servizio, ma consente molte chiamate a ogni operazione all'ora.
Struttura di una richiesta di configurazione
Questo riferimento mostra le richieste CloudSearch di configurazione di Amazon comeURLs, che possono essere utilizzate direttamente in un browser. (Sebbene le GET richieste siano mostrate comeURLs, i valori dei parametri vengono mostrati non codificati per facilitarne la lettura. Tieni presente che devi URL codificare i valori dei parametri quando invii le richieste.) URLContiene tre parti:
Endpoint: punto di ingresso per un servizio Web su cui agire,
cloudsearch---us-east-1.amazonaws.com.rproxy.goskope.com.Azione: l'azione di configurazione di CloudSearch Amazon che desideri eseguire. Per l'elenco completo delle operazioni, consulta Azioni.
Parametri: qualsiasi parametro di richiesta richiesto per l'azione specificata. Ogni richiesta di query deve includere anche alcuni parametri comuni per gestire l'autenticazione. Per ulteriori informazioni, consulta Autenticazione delle richieste.
È necessario specificare il Version parametro in ogni richiesta CloudSearch di configurazione Amazon. La CloudSearch API versione attuale di Amazon è 2013-01-01.
Ad esempio, la seguente GET richiesta crea un nuovo dominio di ricerca chiamato movies:
https://cloudsearch.us-east-1.amazonaws.com ?Action=CreateDomain &DomainName=movies &Version=2013-01-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4 _request &X-Amz-Date=2012-07-12T21:41:29.094Z &X-Amz-SignedHeaders=host &X-Amz-Signature=c7600a00fea082dac002b247f9d6812f25195fbaf7f0a6fc4ce08a39666c6a10 3c8dcb
Autenticazione delle richieste
Le richieste inviate alla Configurazione API vengono autenticate utilizzando le chiavi di AWS accesso dell'utente. È necessario includere parametri di autorizzazione e una firma digitale in ogni richiesta. Amazon CloudSearch supporta la versione 4 di AWS Signature. Per istruzioni dettagliate sulla firma, consulta il processo di firma di Signature V4 nella AWS Guida generale.
Nota
Se hai appena iniziato a firmare AWS le tue richieste, dai un'occhiata a come SDKs implementano la firma. Il codice sorgente per la maggior parte di essi AWS SDKs è disponibile all'indirizzo https://github.com/aws.
Ad esempio, per creare una richiesta CreateDomain, avrai bisogno delle seguenti informazioni:
Region name: us-east-1 Service name: cloudsearch API version: 2013-01-01 Date: 2014-03-12T21:41:29.094Z Access key: AKIAIOSFODNN7EXAMPLE Secret key: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY Action: CreateDomain Action Parameters: DomainName=movies
La stringa di query standard per una richiesta CreateDomain ha il seguente aspetto:
Action=CreateDomain &DomainName=movies &Version=2013-01-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4 _request &X-Amz-Date=2012-07-12T21:41:29.094Z &X-Amz-SignedHeaders=host
La richiesta di firma finale ha il seguente aspetto:
https://cloudsearch.us-east-1.amazonaws.com ?Action=CreateDomain &DomainName=movies &Version=2013-01-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4 _request &X-Amz-Date=2014-03-12T21:41:29.094Z &X-Amz-SignedHeaders=host &X-Amz-Signature=c7600a00fea082dac002b247f9d6812f25195fbaf7f0a6fc4ce08a39666c6a10
