---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# HttpRequestData - スコープ指定

# HttpRequestData - スコープ指定 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：29分

HttpRequestData API は、署名を適用してエンドポイントに送信する前に REST 要求を構築および操作するためのメソッドを提供します。  
次の順序でこれらの API を使用して、送信署名要求を生成します。

1. HttpRequestData：API 要求を構築します。
2. AuthCredential：資格情報オブジェクトを作成するか、既存のオブジェクトを更新します。資格情報を使用して、RequestAuthAPI クラスで要求に署名します。
3. RequestAuthAPI：要求に署名し、HttpRequestAuthedData オブジェクトを返します。
4. HttpRequestAuthedData：署名された要求に関する情報を取得します。
5. GlideHTTPRequest：署名された要求を送信します。
{#HttpRequestDataAPI__ol_gvv_22t_tjb}

これらの API を使用する前に、認証 [アルゴリズムを構成し](https://www.servicenow.com/docs/access?context=configure-authentication-algorithm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) て要求に署名し、要求の認証に使用する認証情報に関連付ける必要があります。

この API は、`sn_auth` 名前空間識別子を持つスコープ対象スクリプト内で使用します。コンストラクタを使用してこのクラスをインスタンス化することも、RequestAuthAPI クラスの getHttpRequestData() メソッドから HttpRequestData オブジェクトを返すこともできます。

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

HttpRequestData オブジェクトをインスタンス化します。
{#HttpRD-HttpRD__table_qmp_t4x_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#HttpRD-HttpRD__table_qmp_t4x_sjb}  

    var httpRequestData = new sn_auth.HttpRequestData();

## HttpRequestData - addHeader(文字列 key, 文字列 value) {#ariaid-title3}

ヘッダーを HttpRequestData オブジェクトに追加します。
{#HttpRD-addHeader_S_S__table_u2f_lsx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| key | 文字列 | HTTP ヘッダーの名前。 |
| value | 文字列 | HTTP ヘッダーの値。 |
[表 : 2. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 3. 返される内容]

{#HttpRD-addHeader_S_S__table_v2f_lsx_sjb}  
この例では、REST 要求のペイロードを作成します。

    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(文字列 key, 文字列 value) {#ariaid-title4}

クエリーパラメーターを HttpRequestData オブジェクトに追加します。
{#HttpRD-addQueryParam_S_S__table_u2f_lsx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| key | 文字列 | クエリーパラメーターの名前。 |
| value | 文字列 | クエリーパラメーターの値。 |
[表 : 4. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 5. 返される内容]

{#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(文字列 key) {#ariaid-title5}

ヘッダーを HttpRequestData オブジェクトから削除します。
{#HttpRD-deleteHeader_S__table_rrt_4sx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| key | 文字列 | 削除する HTTP ヘッダーの名前。 |
[表 : 6. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 7. 返される内容]

{#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}

統合ハブ REST ステップに関連付けられた接続および資格情報エイリアスの sys_id を返します。
その sys_id を ConnectionInfoProvider API に渡すと、接続に関する情報を取得できます。  
注:  
このメソッドは、統合ハブ REST ステップでのみ使用できます。詳細については、「 [REST ステップ](https://www.servicenow.com/docs/access?context=rest-request-action-designer&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US)」を参照してください。
{#HttpRD-getConnectionAliasID__table_oxs_qsx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 8. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 要求に関連付けられた接続および資格情報エイリアス \[sys_alias\] テーブルのエイリアスレコードの sys_id。 |
[表 : 9. 返される内容]

{#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(文字列 name) {#ariaid-title7}

統合ハブ REST ステップに関連付けられた接続および資格情報エイリアスに関連付けられた接続属性の値を返します。
注:  
このメソッドは、統合ハブ REST ステップでのみ使用できます。詳細については、「 [REST ステップ](https://www.servicenow.com/docs/access?context=rest-request-action-designer&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US)」を参照してください。

接続属性の詳細については、「 [Integration Hub の接続属性を作成する](https://www.servicenow.com/docs/access?context=create-connection-attributes&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)」を参照してください。
{#HttpRD-getConnectionExtendedAttribute_S__table_kjk_tsx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| name | 文字列 | 接続属性の名前。 |
[表 : 10. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 接続属性の値。 |
[表 : 11. 返される内容]

{#HttpRD-getConnectionExtendedAttribute_S__table_ljk_tsx_sjb}  
この例では、REST ステップに関連付けられた接続および資格情報エイリアスで設定された接続属性の値を返します。

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

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

HttpRequestData オブジェクト内の要求の内容を返します。
{#HttpRD-getContent__table_ivs_xsx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 12. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 要求の内容。 |
[表 : 13. 返される内容]

{#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();

出力：

    Action=SendMessage&MessageBody=This is a test message

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

要求が署名された日付を返します。
{#HttpRD-getDate__table_jf4_zsx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 14. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 数字 | 1970 年 1 月 1 日 (UTC) と要求が署名された日の差。 単位：ミリ秒 |
[表 : 15. 返される内容]

{#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());

出力：

    Date: 1349333576093

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

署名がヘッダー内の要求に適用されるか、クエリーパラメーターとして適用されるかを返します。
デフォルトでは、署名がヘッダーに適用されます。setDirective() API を使用すると、署名をクエリーパラメーターとして適用できます。
{#HttpRD-getDirective__table_rjy_btx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 16. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 署名がヘッダーに適用されるか、クエリーパラメーターとして適用されるか。 次の値が含まれます。 * HEADER：署名は要求ヘッダーに適用されます。 * QUERY：署名はクエリーパラメーターとして適用されます。 {#HttpRD-getDirective__ul_xdw_v5b_5jb} |
[表 : 17. 返される内容]

{#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() );

出力：

    Signature applied to: HEADER

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

要求のエンドポイントセットを返します。
{#HttpRD-getEndpoint__table_pwp_dtx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 18. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 要求のエンドポイントセット。 |
[表 : 19. 返される内容]

{#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() );

出力：

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

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

RequestAuthAPI クラスの generateAuth() メソッドを使用して要求が署名されたときから署名の有効期限が切れるまでの時間を秒単位で返します。
有効期限は通常、要求の送信先のサードパーティサービスによって設定され、setExpiry() メソッドによって設定された値を上書きします。たとえば、サードパーティのサービスによって有効期限が 900 秒に設定されているときに、setExpiry() メソッドを使用して有効期限を 300 秒に設定した場合、getExpiry() メソッドは 900 秒を返します。
{#HttpRD-getExpiry__table_vr1_ftx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 20. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 数字 | 署名の有効期限が切れるまでの時間。 単位：秒 |
[表 : 21. 返される内容]

{#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());

出力：

    Signature expires in: 300

## HttpRequestData - getHeader(文字列 key) {#ariaid-title13}

指定された HTTP ヘッダーに関連付けられた値を返します。
{#HttpRD-getHeader_S__table_hg4_gtx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| key | 文字列 | HTTP ヘッダーの名前。 |
[表 : 22. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 指定された HTTP ヘッダーの値。 |
[表 : 23. 返される内容]

{#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') );

出力：

    Header value is: public-read

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

要求に含まれるヘッダーを含むオブジェクトを返します。
{#HttpRD-getHeaderMap__table_shk_3tx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 24. パラメーター]

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

| タイプ | 説明 |
|-|-|
| オブジェクト | 要求に関連付けられたすべてのヘッダーを定義するキーと値のペア。 キーと値のペアにはそれぞれ次の要素が含まれています。 * キー：文字列ヘッダーの名前。 * 値：文字列。ヘッダーの値。 {#HttpRD-getHeaderMap__ul_adn_4qh_5jb} |
[表 : 25. 返される内容]

{#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);
    }

出力：

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

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

要求で使用されているホストを返します。
{#HttpRD-getHost__table_i4j_ktx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 26. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 要求で使用されているホスト。 |
[表 : 27. 返される内容]

{#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());

出力：

    Host is: myHost

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

要求で使用されている HTTP メソッドを返します。
{#HttpRD-getHttpMethod__table_xyl_mtx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 28. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 要求で使用されている HTTP メソッド。 |
[表 : 29. 返される内容]

{#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());

出力：

    HTTP method is: PUT

## HttpRequestData - getQueryParam(文字列 key) {#ariaid-title17}

指定されたクエリーパラメーターの値を返します。
{#HttpRD-getQueryParam_S__table_lhh_ptx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| key | 文字列 | 値を取得するクエリーパラメーターの名前。 |
[表 : 30. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | クエリーパラメーターの値。 |
[表 : 31. 返される内容]

{#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'));

出力：

    API version is: v2

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

要求に含まれるクエリーパラメーターを含むオブジェクトを返します。
{#HttpRD-getQueryParamMap__table_pk3_rtx_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 32. パラメーター]

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

| タイプ | 説明 |
|-|-|
| オブジェクト | 要求に関連付けられたクエリーパラメーターを定義するキーと値のペア。 キーと値のペアにはそれぞれ次の要素が含まれています。 * キー：文字列クエリーパラメーターの名前。 * 値：文字列。クエリーパラメーターの値。 {#HttpRD-getQueryParamMap__ul_adn_4qh_5jb} |
[表 : 33. 返される内容]

{#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']);

出力：

    api_version is: v2

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

署名に使用される要求のリージョンを返します。
{#HttpRD-getRegion__table_djf_g5x_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 34. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | リージョンの名前。 |
[表 : 35. 返される内容]

{#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());

出力：

    Region is: us-east-1

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

要求で定義されているサービスを返します。
{#HttpRD-getService__table_iqr_h5x_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 36. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 要求で定義されているサービス。 |
[表 : 37. 返される内容]

{#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());

出力：

    Service is: s3

## HttpRequestData - setContent(文字列 content) {#ariaid-title21}

要求で送信する内容を定義します。
注:  
このメソッドは、スクリプトインクルードと MID Server スクリプトではサポートされていません。
{#HttpRD-setContent_S__table_u5g_j5x_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| content | 文字列 | 要求で送信する内容。 |
[表 : 38. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 39. 返される内容]

{#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(数字の日付) {#ariaid-title22}

署名に使用される要求の日付を定義します。
このメソッドは、署名がタイムスタンプに基づいて正しく作成されているかどうかをテストする場合にのみ使用します。本番環境では、署名要求は署名を生成した時間を使用します。この値を手動で設定すると、署名要求が失敗する可能性があります。
{#HttpRD-setDate_N__table_xzg_pcy_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| date | 数字 | 1970 年 1 月 1 日 (UTC) と要求への署名に使用された日付の差。 単位：ミリ秒 |
[表 : 40. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 41. 返される内容]

{#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(文字列 directive) {#ariaid-title23}

署名をヘッダー内の要求に適用するか、クエリーパラメーターとして適用するかを定義します。
{#HttpRD-setDirective_S__table_nxn_rcy_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| directive | 文字列 | 署名をヘッダーに適用するか、クエリーパラメーターとして適用するか。 次の値が含まれます。 * `query`：署名をクエリーパラメーターとして適用します。 * `header`：署名を要求ヘッダーに適用します。 {#HttpRD-setDirective_S__ul_w2m_lzb_5jb} デフォルト：header |
[表 : 42. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 43. 返される内容]

{#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(文字列 endpoint) {#ariaid-title24}

要求の送信先のエンドポイントを定義します。
{#HttpRD-setEndpoint_S__table_rcx_scy_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| endpoint | 文字列 | 要求の送信先のエンドポイント。エンドポイントには、クエリーパラメーター、パス、およびバージョンを含めることができます。 |
[表 : 44. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 45. 返される内容]

{#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(数字 expiry) {#ariaid-title25}

RequestAuthAPI クラスの generateAuth() メソッドを使用して要求が署名されてから署名の有効期限が切れるまでの時間を設定します。
有効期限は通常、要求の送信先のサードパーティサービスによって設定され、setExpiry() メソッドによって設定された値を上書きします。たとえば、サードパーティのサービスによって有効期限が 900 秒に設定されているときに、setExpiry() メソッドを使用して有効期限を 300 秒に設定した場合、getExpiry() メソッドは 900 秒を返します。
{#HttpRD-setExpiry_N__table_wbj_5cy_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| expiry | 数字 | 署名の有効期限が切れるまでの時間。 単位：秒 |
[表 : 46. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 47. 返される内容]

{#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(文字列 host) {#ariaid-title26}

要求で使用されるホストを定義します。
{#HttpRD-setHost_S__table_yzh_wcy_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| host | 文字列 | HTTP 要求ホストの名前。 |
[表 : 48. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 49. 返される内容]

{#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(文字列 httpMethod) {#ariaid-title27}

要求で使用する HTTP メソッドを設定します。
{#HttpRD-setHttpMethod_S__table_kwx_ycy_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| httpMethod | 文字列 | 要求で使用する HTTP メソッド。 |
[表 : 50. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 51. 返される内容]

{#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(文字列 region) {#ariaid-title28}

要求に署名する際に使用するリージョンを定義します。
{#HttpRD-setRegion_S__table_wby_1dy_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| region | 文字列 | 要求の署名に使用するリージョン。使用可能な値は、サードパーティ API の要件によって決まります。 |
[表 : 52. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 53. 返される内容]

{#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(文字列 service) {#ariaid-title29}

要求のサービスを定義します。
{#HttpRD-setService_S__table_yvs_2dy_sjb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| service | 文字列 | 要求のサービス。 |
[表 : 54. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 55. 返される内容]

{#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');