---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# HttpRequestData -- Umfang

# HttpRequestData -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 10 Minuten Lesedauer

Die HttpRequestData Die API bietet Methoden zum Erstellen und Bearbeiten einer REST-Anforderung, bevor eine Signatur angewendet und an einen Endpunkt gesendet wird.  
Generieren Sie ausgehende Signaturanforderungen mithilfe dieser APIs in der folgenden Reihenfolge:

1. HttpRequestData : API-Anforderung erstellen.
2. Anmeldeinformationen : Erstellen Sie ein Anmeldeinformationsobjekt, oder aktualisieren Sie ein vorhandenes. Verwenden Sie die Anmeldeinformationen, um die Anforderung über zu signieren AnforderungsAuthAPI Klasse.
3. AnforderungsAuthAPI : Signieren Sie die Anforderung, und geben Sie ein HttpRequestAuthedData-Objekt zurück.
4. HttpRequestAuthedData : Ruft Informationen zur signierten Anforderung ab.
5. GlideHTTPRequest : Signierte Anforderung senden.
{#HttpRequestDataAPI__ol_gvv_22t_tjb}

Bevor Sie diese APIs verwenden, müssen Sie dies tun [Konfigurieren Sie einen Authentifizierungsalgorithmus](https://www.servicenow.com/docs/access?context=configure-authentication-algorithm&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)Um die Anforderung zu signieren und den Anmeldeinformationen zuzuordnen, die zur Authentifizierung der Anforderung verwendet werden.

Verwenden Sie diese API in bereichsbezogenen Skripts mit `sn_auth `Namespace-Bezeichner. Sie können diese Klasse mit dem Konstruktor instanziieren oder ein HttpRequestData-Objekt von zurückgeben GetHttpRequestData() Methode in AnforderungsAuthAPI Klasse.

## HttpRequestData -- HttpRequestData() {#ariaid-title2}

Instanziiert ein HttpRequestData-Objekt.
{#HttpRD-HttpRD__table_qmp_t4x_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#HttpRD-HttpRD__table_qmp_t4x_sjb}  

    var httpRequestData = new sn_auth.HttpRequestData();

## HttpRequestData -- addHeader(Zeichenfolgenwert für Zeichenfolgenschlüssel) {#ariaid-title3}

Fügt dem Objekt „HttpRequestData" einen Header hinzu.
{#HttpRD-addHeader_S_S__table_u2f_lsx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| key | Zeichenfolge | Name des HTTP-Headers. |
| Wert | Zeichenfolge | Wert des HTTP-Headers. |
[Tabelle : 2. Parameter]

{#HttpRD-addHeader_S_S__table_u2f_lsx_sjb} {#HttpRD-addHeader_S_S__table_v2f_lsx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 3. Rückgaben]

{#HttpRD-addHeader_S_S__table_v2f_lsx_sjb}  
In diesem Beispiel wird eine REST-Anforderungsnutzlast erstellt.

    var endpoint= "https://s3.amazonaws.com";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod("PUT");
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addHeader('x-amz-acl', 'public-read' );

## HttpRequestData -- addQueryParam(Zeichenfolgenschlüssel, Zeichenfolgenwert) {#ariaid-title4}

Fügt dem Objekt „HttpRequestData" einen Abfrageparameter hinzu.
{#HttpRD-addQueryParam_S_S__table_u2f_lsx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| key | Zeichenfolge | Name des Abfrageparameters. |
| Wert | Zeichenfolge | Wert des Abfrageparameters. |
[Tabelle : 4. Parameter]

{#HttpRD-addQueryParam_S_S__table_u2f_lsx_sjb} {#HttpRD-addQueryParam_S_S__table_lbc_nsx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 5. Rückgaben]

{#HttpRD-addQueryParam_S_S__table_lbc_nsx_sjb}  

    var endpoint= "https://third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addQueryParam('api_version', 'v2 );
    ​

## HttpRequestData -- deleteHeader (Zeichenfolgenschlüssel) {#ariaid-title5}

Entfernt einen Header aus dem Objekt „HttpRequestData".
{#HttpRD-deleteHeader_S__table_rrt_4sx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| key | Zeichenfolge | Name des zu entfernenden HTTP-Headers. |
[Tabelle : 6. Parameter]

{#HttpRD-deleteHeader_S__table_rrt_4sx_sjb} {#HttpRD-deleteHeader_S__table_srt_4sx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 7. Rückgaben]

{#HttpRD-deleteHeader_S__table_srt_4sx_sjb}  

    var endpoint= "https://s3.amazonaws.com";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.deleteHeader('x-amz-acl');

## HttpRequestData -- getConnectionAliasID() {#ariaid-title6}

Gibt die sys_ID des Alias für Verbindungen und Anmeldeinformationen zurück, der mit verknüpft ist IntegrationHubREST-Schritt.
Sie können die sys_ID an übergeben ConnectionInfoProvider API zum Abrufen von Informationen zur Verbindung.  
Hinweis:  
Sie können diese Methode nur in verwenden IntegrationHubREST-Schritt. Weitere Informationen finden Sie unter [REST-Schritt](https://www.servicenow.com/docs/access?context=rest-request-action-designer&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US).
{#HttpRD-getConnectionAliasID__table_oxs_qsx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 8. Parameter]

{#HttpRD-getConnectionAliasID__table_oxs_qsx_sjb} {#HttpRD-getConnectionAliasID__table_pxs_qsx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | SYS_ID des Alias-Datensatzes aus der Tabelle „Aliasse für Verbindungen und Anmeldeinformationen" \[sys_alias\], die der Anforderung zugeordnet ist. |
[Tabelle : 9. Rückgaben]

{#HttpRD-getConnectionAliasID__table_pxs_qsx_sjb}  

    var httpRequestData = new sn_auth.HttpRequestData();
    var id = httpRequestData.getConnectionAliasID();
     
    var credential = new sn_cc.ConnectionInfoProvider().
    var connectionInfo = credential.getConnectionInfo(id);

## HttpRequestData -- getConnectionExtendedAttribute(Zeichenfolgenname) {#ariaid-title7}

Gibt den Wert eines Verbindungsattributs zurück, das dem Alias für Verbindungen und Anmeldeinformationen zugeordnet ist, der zugeordnet ist IntegrationHubREST-Schritt.
Hinweis:  
Sie können diese Methode nur in verwenden IntegrationHubREST-Schritt. Weitere Informationen finden Sie unter [REST-Schritt](https://www.servicenow.com/docs/access?context=rest-request-action-designer&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US).

Weitere Informationen zu Verbindungsattributen finden Sie unter [Erstellen Sie Verbindungsattribute für IntegrationHub](https://www.servicenow.com/docs/access?context=create-connection-attributes&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)an.
{#HttpRD-getConnectionExtendedAttribute_S__table_kjk_tsx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Name des Verbindungsattributs. |
[Tabelle : 10. Parameter]

{#HttpRD-getConnectionExtendedAttribute_S__table_kjk_tsx_sjb} {#HttpRD-getConnectionExtendedAttribute_S__table_ljk_tsx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Wert des Verbindungsattributs. |
[Tabelle : 11. Rückgaben]

{#HttpRD-getConnectionExtendedAttribute_S__table_ljk_tsx_sjb}  
Dieses Beispiel gibt den Wert eines Verbindungsattributs zurück, der auf dem Alias für Verbindungen und Anmeldeinformationen festgelegt ist, der dem REST-Schritt zugeordnet ist.

    var httpRequestData = new sn_auth.HttpRequestData();​
    gs.info("API Version is: " + httpRequestData.getConnectionExtendedAttribute('api_version'));

## HttpRequestData -- getContent() {#ariaid-title8}

Gibt den Inhalt der Anforderung im Objekt „HttpRequestData" zurück.
{#HttpRD-getContent__table_ivs_xsx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 12. Parameter]

{#HttpRD-getContent__table_ivs_xsx_sjb} {#HttpRD-getContent__table_jvs_xsx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Inhalt der Anforderung. |
[Tabelle : 13. Rückgaben]

{#HttpRD-getContent__table_jvs_xsx_sjb}  

    var endpoint= "https://s3.amazonaws.com";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addHeader('x-amz-acl' , 'public-read' );
    var ct = httpRequestData.getContent();

Ausgabe:

    Action=SendMessage&MessageBody=This is a test message

## HttpRequestData -- getDate() {#ariaid-title9}

Gibt das Datum zurück, an dem die Anforderung signiert wurde.
{#HttpRD-getDate__table_jf4_zsx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 14. Parameter]

{#HttpRD-getDate__table_jf4_zsx_sjb} {#HttpRD-getDate__table_kf4_zsx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Die Differenz zwischen dem 1. Januar 1970 UTC und dem Zeitpunkt, zu dem die Anforderung signiert wurde. Einheit: Millisekunden |
[Tabelle : 15. Rückgaben]

{#HttpRD-getDate__table_kf4_zsx_sjb}  

    var endpoint= "https://s3.amazonaws.com";​
    var httpRequestData = new sn_auth.HttpRequestData();​
    httpRequestData.setEndpoint(endpoint);​
    httpRequestData.addQueryParam("list-type", "2");​
    httpRequestData.setService('s3');​
    httpRequestData.setHttpMethod('get');​

    gs.info( "Date: " + httpRequestData.getDate());

Ausgabe:

    Date: 1349333576093

## HttpRequestData -- getDirective() {#ariaid-title10}

Gibt zurück, ob die Signatur auf die Anforderung im Header oder als Abfrageparameter angewendet wird.
Standardmäßig wendet das System die Signatur auf den Header an. Sie können die Signatur als Abfrageparameter mit anwenden SetDirective() API.
{#HttpRD-getDirective__table_rjy_btx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 16. Parameter]

{#HttpRD-getDirective__table_rjy_btx_sjb} {#HttpRD-getDirective__table_sjy_btx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Gibt an, ob die Signatur auf den Header oder als Abfrageparameter angewendet wird. Werte: * HEADER: Die Signatur wird auf den Anforderungsheader angewendet. * ABFRAGE: Die Signatur wird als Abfrageparameter angewendet. {#HttpRD-getDirective__ul_xdw_v5b_5jb} |
[Tabelle : 17. Rückgaben]

{#HttpRD-getDirective__table_sjy_btx_sjb}  

    var endpoint= "https://s3.amazonaws.com";​
    var httpRequestData = new sn_auth.HttpRequestData();​
    httpRequestData.setEndpoint(endpoint);​
    httpRequestData.addQueryParam("list-type", "2");​
    httpRequestData.setService('s3');​
    httpRequestData.setHttpMethod('get');​

    gs.info( "Signature applied to: " + httpRequestData.getDirective() );

Ausgabe:

    Signature applied to: HEADER

## HttpRequestData -- getEndpoint() {#ariaid-title11}

Gibt den für die Anforderung festgelegten Endpunkt zurück.
{#HttpRD-getEndpoint__table_pwp_dtx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 18. Parameter]

{#HttpRD-getEndpoint__table_pwp_dtx_sjb} {#HttpRD-getEndpoint__table_qwp_dtx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Endpunkt für die Anforderung festgelegt. |
[Tabelle : 19. Rückgaben]

{#HttpRD-getEndpoint__table_qwp_dtx_sjb}  

    var endpoint= "https://s3.amazonaws.com";​
    var httpRequestData = new sn_auth.HttpRequestData();​
    httpRequestData.setEndpoint(endpoint);​
    httpRequestData.addQueryParam("list-type", "2");​
    httpRequestData.setService('s3');​
    httpRequestData.setHttpMethod('get');​
    httpRequestData.setDirective("query");​
    ​
    gs.info( "Endpoint is: " + httpRequestData.getEndpoint() );

Ausgabe:

    Endpoint is: https://s3.amazonaws.com

## HttpRequestData -- getExpiry() {#ariaid-title12}

Gibt die Zeit in Sekunden zurück, bevor die Signatur abläuft, beginnend mit dem Zeitpunkt, zu dem die Anforderung mit signiert wurde GenerateAuth() Methode in AnforderungsAuthAPI Klasse.
Der Ablauf wird normalerweise vom Drittparteiservice festgelegt, an den Sie die Anforderung senden. Dieser überschreibt jeden von festgelegten Wert Ablauf festlegen () Methode. Beispiel: Wenn der Ablauf vom Drittparteiservice auf 900 Sekunden festgelegt ist und Sie verwenden Ablauf festlegen () Methode zum Festlegen des Ablaufs auf 300 Sekunden GetExpiry() Methode gibt 900 Sekunden zurück.
{#HttpRD-getExpiry__table_vr1_ftx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 20. Parameter]

{#HttpRD-getExpiry__table_vr1_ftx_sjb} {#HttpRD-getExpiry__table_wr1_ftx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Zeit, bevor die Signatur abläuft. Einheit: Sekunden |
[Tabelle : 21. Rückgaben]

{#HttpRD-getExpiry__table_wr1_ftx_sjb}  

    var endpoint= "https://s3.amazonaws.com";​
    var httpRequestData = new sn_auth.HttpRequestData();​
    httpRequestData.setEndpoint(endpoint);​
    httpRequestData.addQueryParam("list-type", "2");​
    httpRequestData.setService('s3');​
    httpRequestData.setHttpMethod('get');​
    httpRequestData.setDirective("query");​
    httpRequestData.setExpiry(300);

    gs.info("Signature expires in: " + httpRequestData.getExpiry());

Ausgabe:

    Signature expires in: 300

## HttpRequestData -- getHeader (Zeichenfolgenschlüssel) {#ariaid-title13}

Gibt den Wert zurück, der dem angegebenen HTTP-Header zugeordnet ist.
{#HttpRD-getHeader_S__table_hg4_gtx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| key | Zeichenfolge | Name des HTTP-Headers. |
[Tabelle : 22. Parameter]

{#HttpRD-getHeader_S__table_hg4_gtx_sjb} {#HttpRD-getHeader_S__table_ig4_gtx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Wert des angegebenen HTTP-Headers. |
[Tabelle : 23. Rückgaben]

{#HttpRD-getHeader_S__table_ig4_gtx_sjb}  

    var endpoint= "https://third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addHeader('x-amz-acl', 'public-read' );
    ​

    gs.info( "Header value is: " + httpRequestData.getHeader('x-amz-acl') );

Ausgabe:

    Header value is: public-read

## HttpRequestData -- getHeaderMap() {#ariaid-title14}

Gibt ein Objekt zurück, das die in der Anforderung enthaltenen Header enthält.
{#HttpRD-getHeaderMap__table_shk_3tx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 24. Parameter]

{#HttpRD-getHeaderMap__table_shk_3tx_sjb} {#HttpRD-getHeaderMap__table_thk_3tx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Schlüssel-Wert-Paare, die alle Header definieren, die der Anforderung zugeordnet sind. Jedes Schlüssel-Wert-Paar enthält diese Teile: * Schlüssel: Zeichenfolge. Name des Headers. * Wert: Zeichenfolge. Wert des Headers. {#HttpRD-getHeaderMap__ul_adn_4qh_5jb} |
[Tabelle : 25. Rückgaben]

{#HttpRD-getHeaderMap__table_thk_3tx_sjb}  

    var endpoint= "https://third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addHeader('x-amz-acl', 'public-read' );
    httpRequestData.addHeader('content-type', 'application/json' );

    var map = httpRequestData.getHeaderMap();

    for(var x in map) {
        var y = map[x]

        gs.info(x, y);
    }

Ausgabe:

    *** Script: x-amz-acl
    *** Script: content-type

## HttpRequestData -- getHost() {#ariaid-title15}

Gibt den in der Anforderung verwendeten Host zurück.
{#HttpRD-getHost__table_i4j_ktx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 26. Parameter]

{#HttpRD-getHost__table_i4j_ktx_sjb} {#HttpRD-getHost__table_j4j_ktx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | In der Anforderung verwendeter Host. |
[Tabelle : 27. Rückgaben]

{#HttpRD-getHost__table_j4j_ktx_sjb}  

    var endpoint= "https://third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setHost('myHost')
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addHeader('x-amz-acl' , 'public-read' );

    gs.info("Host is: " + httpRequestData.getHost());

Ausgabe:

    Host is: myHost

## HttpRequestData -- getHttpMethod() {#ariaid-title16}

Gibt die in der Anforderung verwendete HTTP-Methode zurück.
{#HttpRD-getHttpMethod__table_xyl_mtx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 28. Parameter]

{#HttpRD-getHttpMethod__table_xyl_mtx_sjb} {#HttpRD-getHttpMethod__table_yyl_mtx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | In der Anforderung verwendete HTTP-Methode. |
[Tabelle : 29. Rückgaben]

{#HttpRD-getHttpMethod__table_yyl_mtx_sjb}  

    var endpoint= "https://third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addHeader('x-amz-acl', 'public-read' );
    ​

    gs.info("HTTP method is: " + httpRequestData.getHttpMethod());

Ausgabe:

    HTTP method is: PUT

## HttpRequestData -- getQueryParam (Zeichenfolgenschlüssel) {#ariaid-title17}

Gibt den Wert des angegebenen Abfrageparameters zurück.
{#HttpRD-getQueryParam_S__table_lhh_ptx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| key | Zeichenfolge | Name des Abfrageparameters, dessen Wert abgerufen werden soll. |
[Tabelle : 30. Parameter]

{#HttpRD-getQueryParam_S__table_lhh_ptx_sjb} {#HttpRD-getQueryParam_S__table_mhh_ptx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Wert des Abfrageparameters. |
[Tabelle : 31. Rückgaben]

{#HttpRD-getQueryParam_S__table_mhh_ptx_sjb}  

    var endpoint= "https://third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addQueryParam('api_version', 'v2' );

    gs.info("API version is: " + httpRequestData.getQueryParam('api_version'));

Ausgabe:

    API version is: v2

## HttpRequestData -- getQueryParamMap() {#ariaid-title18}

Gibt ein Objekt zurück, das die in der Anforderung enthaltenen Abfrageparameter enthält.
{#HttpRD-getQueryParamMap__table_pk3_rtx_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 32. Parameter]

{#HttpRD-getQueryParamMap__table_pk3_rtx_sjb} {#HttpRD-getQueryParamMap__table_qk3_rtx_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Schlüssel-Wert-Paare, die die Abfrageparameter definieren, die der Anforderung zugeordnet sind. Jedes Schlüssel-Wert-Paar enthält diese Teile: * Schlüssel: Zeichenfolge. Name des Abfrageparameters. * Wert: Zeichenfolge. Wert des Abfrageparameters. {#HttpRD-getQueryParamMap__ul_adn_4qh_5jb} |
[Tabelle : 33. Rückgaben]

{#HttpRD-getQueryParamMap__table_qk3_rtx_sjb}  

    var endpoint= "https://third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addQueryParam('api_version', 'v2' );
    httpRequestData.addQueryParam('limit', '1000' );
    httpRequestData.addQueryParam('offset', '1' );


    var map = httpRequestData.getQueryParamMap();
    gs.info("api_version is: " + map['api_version']);

Ausgabe:

    api_version is: v2

## HttpRequestData -- getRegion() {#ariaid-title19}

Gibt die Region für die Anforderung zurück, die beim Signieren verwendet wird.
{#HttpRD-getRegion__table_djf_g5x_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 34. Parameter]

{#HttpRD-getRegion__table_djf_g5x_sjb} {#HttpRD-getRegion__table_ejf_g5x_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Name der Region. |
[Tabelle : 35. Rückgaben]

{#HttpRD-getRegion__table_ejf_g5x_sjb}  

    var endpoint= "https://third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);

    gs.info("Region is: " + httpRequestData.getRegion());

Ausgabe:

    Region is: us-east-1

## HttpRequestData -- getService() {#ariaid-title20}

Gibt den in der Anforderung definierten Service zurück.
{#HttpRD-getService__table_iqr_h5x_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 36. Parameter]

{#HttpRD-getService__table_iqr_h5x_sjb} {#HttpRD-getService__table_jqr_h5x_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | In der Anforderung definierter Service. |
[Tabelle : 37. Rückgaben]

{#HttpRD-getService__table_jqr_h5x_sjb}  

    var endpoint= "https://s3.amazonaws.com";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');

    gs.info("Service is: " + httpRequestData.getService());

Ausgabe:

    Service is: s3

## HttpRequestData -- setContent(Zeichenfolgeninhalt) {#ariaid-title21}

Definiert den Inhalt, der in der Anforderung gesendet werden soll.
Hinweis:  
Diese Methode wird in Skripteinbindungen oder MID-Serverskripts nicht unterstützt.
{#HttpRD-setContent_S__table_u5g_j5x_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Content | Zeichenfolge | Inhalt, der in der Anforderung gesendet werden soll. |
[Tabelle : 38. Parameter]

{#HttpRD-setContent_S__table_u5g_j5x_sjb} {#HttpRD-setContent_S__table_v5g_j5x_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 39. Rückgaben]

{#HttpRD-setContent_S__table_v5g_j5x_sjb}  

    var endpoint= "https://s3.amazonaws.com";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "This is a test message";
    httpRequestData.setContent(content);

## HttpRequestData -- setDate(Nummerndatum) {#ariaid-title22}

Definiert das Datum der Anforderung, die zum Signieren verwendet wird.
Verwenden Sie diese Methode nur, wenn Sie testen, ob die Signatur basierend auf einem Zeitstempel korrekt erstellt wurde. In der Produktion verwendet die Signaturanforderung die Zeit, zu der Sie die Signatur generiert haben. Das manuelle Festlegen dieses Werts kann dazu führen, dass die Signaturanforderung fehlschlägt.
{#HttpRD-setDate_N__table_xzg_pcy_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Datum | Nummer | Die Differenz zwischen dem 1. Januar 1970 UTC und dem Datum, das zum Signieren der Anforderung verwendet wird. Einheit: Millisekunden |
[Tabelle : 40. Parameter]

{#HttpRD-setDate_N__table_xzg_pcy_sjb} {#HttpRD-setDate_N__table_yzg_pcy_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 41. Rückgaben]

{#HttpRD-setDate_N__table_yzg_pcy_sjb}  

    var endpoint= "https://s3.amazonaws.com";​
    var httpRequestData = new sn_auth.HttpRequestData();​
    httpRequestData.setEndpoint(endpoint);​
    httpRequestData.addQueryParam("list-type", "2");​
    httpRequestData.setService('s3');​
    httpRequestData.setHttpMethod('get');
    httpRequestData.setDate(1349333576093);

## HttpRequestData -- setDirective (Zeichenfolgenanweisung) {#ariaid-title23}

Definiert, ob die Signatur auf die Anforderung in einem Header oder als Abfrageparameter angewendet werden soll.
{#HttpRD-setDirective_S__table_nxn_rcy_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Richtlinie | Zeichenfolge | Gibt an, ob die Signatur auf den Header oder als Abfrageparameter angewendet werden soll. Werte: * `Abfrage `: Wendet Signatur als Abfrageparameter an. * `Header `: Wendet Signatur auf den Anforderungsheader an. {#HttpRD-setDirective_S__ul_w2m_lzb_5jb} Standard: Header |
[Tabelle : 42. Parameter]

{#HttpRD-setDirective_S__table_nxn_rcy_sjb} {#HttpRD-setDirective_S__table_oxn_rcy_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 43. Rückgaben]

{#HttpRD-setDirective_S__table_oxn_rcy_sjb}  

    var endpoint= "https://s3.amazonaws.com";​
    var httpRequestData = new sn_auth.HttpRequestData();​
    httpRequestData.setEndpoint(endpoint);​
    httpRequestData.addQueryParam("list-type", "2");​
    httpRequestData.setService('s3');​
    httpRequestData.setHttpMethod('get');​
    httpRequestData.setDirective("query");​

## HttpRequestData -- setEndpoint (Zeichenfolgenendpunkt) {#ariaid-title24}

Definiert den Endpunkt, an den die Anforderung gesendet werden soll.
{#HttpRD-setEndpoint_S__table_rcx_scy_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| endpoint | Zeichenfolge | Endpunkt, an den die Anforderung gesendet werden soll. Der Endpunkt kann Abfrageparameter, Pfad und Version enthalten. |
[Tabelle : 44. Parameter]

{#HttpRD-setEndpoint_S__table_rcx_scy_sjb} {#HttpRD-setEndpoint_S__table_scx_scy_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 45. Rückgaben]

{#HttpRD-setEndpoint_S__table_scx_scy_sjb}  

    var endpoint="https://third-party-endpoint/path-parameters/version";

    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);

## HttpRequestData -- setExpiry(Nummernablauf) {#ariaid-title25}

Legt die Zeit fest, bis die Signatur abläuft, wenn die Anforderung mit signiert wird GenerateAuth() Methode in AnforderungsAuthAPI Klasse.
Der Ablauf wird normalerweise vom Drittparteiservice festgelegt, an den Sie die Anforderung senden. Dieser überschreibt jeden von festgelegten Wert Ablauf festlegen () Methode. Beispiel: Wenn der Ablauf vom Drittparteiservice auf 900 Sekunden festgelegt ist und Sie verwenden Ablauf festlegen () Methode zum Festlegen des Ablaufs auf 300 Sekunden GetExpiry() Methode gibt 900 Sekunden zurück.
{#HttpRD-setExpiry_N__table_wbj_5cy_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| expiry | Nummer | Zeit, bis die Signatur abläuft. Einheit: Sekunden |
[Tabelle : 46. Parameter]

{#HttpRD-setExpiry_N__table_wbj_5cy_sjb} {#HttpRD-setExpiry_N__table_xbj_5cy_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 47. Rückgaben]

{#HttpRD-setExpiry_N__table_xbj_5cy_sjb}  

    var endpoint= "https://s3.amazonaws.com";​
    var httpRequestData = new sn_auth.HttpRequestData();​
    httpRequestData.setEndpoint(endpoint);​
    httpRequestData.addQueryParam("list-type", "2");​
    httpRequestData.setService('s3');​
    httpRequestData.setHttpMethod('get');​
    httpRequestData.setExpiry(300);​

## HttpRequestData -- setHost(Zeichenfolgenhost) {#ariaid-title26}

Definiert den in der Anforderung verwendeten Host.
{#HttpRD-setHost_S__table_yzh_wcy_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| host | Zeichenfolge | Name des HTTP-Anforderungs-Hosts. |
[Tabelle : 48. Parameter]

{#HttpRD-setHost_S__table_yzh_wcy_sjb} {#HttpRD-setHost_S__table_zzh_wcy_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 49. Rückgaben]

{#HttpRD-setHost_S__table_zzh_wcy_sjb}  

    var endpoint= "https:third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setHost('myHost')
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);
    httpRequestData.addHeader('x-amz-acl', 'public-read' );

## HttpRequestData -- setHttpMethod(Zeichenfolge httpMethod) {#ariaid-title27}

Legt die in der Anforderung zu verwendende HTTP-Methode fest.
{#HttpRD-setHttpMethod_S__table_kwx_ycy_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| HttpMethod | Zeichenfolge | In der Anforderung zu verwendende HTTP-Methode. |
[Tabelle : 50. Parameter]

{#HttpRD-setHttpMethod_S__table_kwx_ycy_sjb} {#HttpRD-setHttpMethod_S__table_lwx_ycy_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 51. Rückgaben]

{#HttpRD-setHttpMethod_S__table_lwx_ycy_sjb}  

    var endpoint= "https://third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');

## HttpRequestData -- setRegion (Zeichenfolgenregion) {#ariaid-title28}

Definiert die Region, die für die Anforderung beim Signieren verwendet werden soll.
{#HttpRD-setRegion_S__table_wby_1dy_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| region | Zeichenfolge | Die Region, die zum Signieren der Anforderung verwendet werden soll. Verfügbare Werte werden durch die Anforderungen der Drittpartei-API bestimmt. |
[Tabelle : 52. Parameter]

{#HttpRD-setRegion_S__table_wby_1dy_sjb} {#HttpRD-setRegion_S__table_xby_1dy_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 53. Rückgaben]

{#HttpRD-setRegion_S__table_xby_1dy_sjb}  

    var endpoint= "https:third-party-endpoint";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');
    httpRequestData.setRegion('us-east-1');
    httpRequestData.setHttpMethod('put');
    var content = "Action=SendMessage&MessageBody=This is a test message";
    httpRequestData.setContent(content);

## HttpRequestData -- setService (Zeichenfolgenservice) {#ariaid-title29}

Definiert den Service für die Anforderung.
{#HttpRD-setService_S__table_yvs_2dy_sjb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| service | Zeichenfolge | Der Service für die Anforderung. |
[Tabelle : 54. Parameter]

{#HttpRD-setService_S__table_yvs_2dy_sjb} {#HttpRD-setService_S__table_zvs_2dy_sjb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 55. Rückgaben]

{#HttpRD-setService_S__table_zvs_2dy_sjb}  

    var endpoint= "https://s3.amazonaws.com";
    var httpRequestData = new sn_auth.HttpRequestData();
    httpRequestData.setEndpoint(endpoint);
    httpRequestData.setService('s3');


