AWS SDK for JavaScript v2 はサポート終了となりました。[AWS SDK for JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/) に移行することをお勧めします。その他の詳細、移行方法については、こちらの[発表内容](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)を参照してください。

# カスタムエンドポイントの指定
<a name="specifying-endpoints"></a>

SDK for JavaScript での API メソッドへの呼び出しは、サービスエンドポイント URI に対して行われます。デフォルトでは、これらのエンドポイントは、コードで設定されたリージョンから構築されています。ただし、API コールにカスタムエンドポイントを指定する必要がある場合もあります。

## エンドポイント文字列フォーマット
<a name="w2aac16c25b5"></a>

エンドポイント値は、次の形式の文字列である必要があります。

 ** `https://{service}.{region}.amazonaws.com` ** 

## ap-northeast-3 リージョンのエンドポイント
<a name="w2aac16c25c11"></a>

日本の `ap-northeast-3` リージョンは、[https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/EC2.html#describeRegions-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/EC2.html#describeRegions-property) などのリージョン列挙 API によって返されません。このリージョンのエンドポイントを定義するには、前に説明した形式に従います。したがって、このリージョンの Amazon EC2 エンドポイントは次のようになります。

 `ec2.ap-northeast-3.amazonaws.com` 

## MediaConvert のエンドポイント
<a name="w2aac16c25c13"></a>

MediaConvert で使用するには、カスタムエンドポイントを作成する必要があります。各顧客アカウントには独自のエンドポイントが割り当てられており、これを使用する必要があります。以下に示しているのは、MediaConvert でカスタムエンドポイントを使用する方法の例です。

```
// Create MediaConvert service object using custom endpoint
var mcClient = new AWS.MediaConvert({endpoint: 'https://abcd1234.mediaconvert.us-west-1.amazonaws.com'});

var getJobParams = {Id: 'job_ID'};

mcClient.getJob(getJobParams, function(err, data)) {
   if (err) console.log(err, err.stack); // an error occurred
   else console.log(data); // successful response
};
```

アカウントの API エンドポイントを取得するには、API リファレンスの「[https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/MediaConvert.html#describeEndpoints-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/MediaConvert.html#describeEndpoints-property)」を参照してください。

カスタムエンドポイント URI のリージョンと同じリージョンをコードに指定してください。リージョン設定とカスタムエンドポイント URI が一致しないと、API コールが失敗する可能性があります。

MediaConvert の詳細については、API リファレンスまたは「[AWS Elemental MediaConvert ユーザーガイド](https://docs.aws.amazon.com/mediaconvert/latest/ug/)」**の「[https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/MediaConvert.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/MediaConvert.html) クラス」を参照してください。