---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# HttpRequestData - スコープ指定

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

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](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=australia&pubname=australia-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(文字列キー文字列値) {#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(文字列キー, 文字列値) {#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(文字列キー) {#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=australia&pubname=australia-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(文字列名) {#ariaid-title7}

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

接続属性の詳細については、次を参照してください。 [統合ハブの接続属性の作成](https://www.servicenow.com/docs/access?context=create-connection-attributes&version=australia&pubname=australia-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(文字列キー) {#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(文字列キー) {#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(文字列コンテンツ) {#ariaid-title21}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| コンテンツ | 文字列 | 要求で送信するコンテンツ。 |
[表 : 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(文字列ディレクティブ) {#ariaid-title23}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| ディレクティブ | 文字列 | 署名をヘッダーに適用するか、クエリパラメーターとして適用するか。 次の値が含まれます。 * `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(文字列エンドポイント) {#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(数値の有効期限) {#ariaid-title25}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| 有効期限 | 番号 | 署名の有効期限が切れるまでの時間。 単位：秒 |
[表 : 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(文字列リージョン) {#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(文字列サービス) {#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');