View a markdown version of this page

StartJob - Amazon Location Service
ユースケースリクエストを理解するレスポンスを理解する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

StartJob

StartJob オペレーションは、新しい Amazon Location データ処理ジョブを開始します。アクションタイプ、入力および出力 Amazon S3 の場所、およびサービスにバケットへのアクセスを許可する IAM 実行ロールを指定します。オペレーションは、ジョブの進行状況のモニタリングに使用できるジョブ識別子、Amazon リソースネーム (ARN)、および初期ステータスを返します。

リクエストの ActionOptionsパラメータを使用して、追加機能をStartJobリクエストできます。これらの機能により、データ処理と結果のオプションが強化されます。

ValidateAddress ジョブの場合、位置機能には世界測地系 (WGS 84) 形式の緯度と経度の座標が含まれます。CountrySpecificAttributes には、キャリアルート情報、国勢調査データ、郵便番号など、各国固有の追加データが含まれます。

詳細については、Amazon Location Service API リファレンスのStartJob」を参照してください。

この API のリクエスト、レスポンス、CLI コマンドの例については、「ジョブの開始方法」を参照してください。

ユースケース

  • データ移行とシステム統合: システム間を移行するとき、または複数のデータソースを統合データベースに統合するときに、大量のアドレスデータをクリーンアップして標準化します。

  • マーケティングキャンペーンの準備: ダイレクトメールキャンペーンを開始する前に、顧客の住所データベースを検証して、返されるメールコストを削減し、配信の成功率を向上させます。

  • データベースのメンテナンスとコンプライアンス: 既存のお客様の住所データベースを定期的に検証して、データ品質基準を維持し、配送と物流のコンプライアンス要件を満たします。

リクエストを理解する

StartJob リクエストには、ジョブアクション、データの場所、アクセス許可を指定する設定の詳細が必要です。この設定により、データの処理方法と結果の保存場所が決まります。

リクエストには、次のパラメータが含まれます。

ジョブアクションとアクセス許可

オペレーションタイプとアクセス許可を定義する必須パラメータ。

  • Action: 実行するオペレーションのタイプ。現在は、ValidateAddress のみがサポートされます。

  • ExecutionRoleArn: ジョブの実行中に Amazon Location が Amazon S3 バケットにアクセスするために引き受ける IAM ロール ARN。

入力設定

入力データの読み取り場所とその形式を指定する必須パラメータ。

  • InputOptions: 入力データ設定を含むオブジェクト。

    • Location: 入力ファイルが保存されている Amazon S3 ARN または URI。

    • Format: 入力データ形式。現在は、Parquet のみがサポートされます。

出力設定

結果を書き込む場所とその形式を指定する必須パラメータ。

  • OutputOptions: 出力データ設定を含むオブジェクト。

    • Location: 出力ファイルが書き込まれる Amazon S3 ARN または URI。

    • Format: データ形式を出力します。現在は、Parquet のみがサポートされます。

任意指定のパラメータ

追加のジョブ設定と機能を提供するパラメータ。

  • Name: 識別しやすい人間が読めるジョブ名。パターン に一致する 1～100 文字にする必要があります[-._\w]+。

  • ClientToken: 同じジョブが複数回作成されないようにするべき等性トークン。パターン に一致する 1～64 文字にする必要があります^[!-~]+$。

  • ActionOptions: 指定されたアクションの追加機能を含むオブジェクト。

    • ValidateAddress: 検証に固有のオプションを含むオブジェクト。

      • AdditionalFeatures: 結果に含める特徴量名の配列。有効な値:

        • Position: 検証されたアドレスごとに WGS 84 形式の緯度と経度が含まれます。

        • CountrySpecificAttributes: キャリアルート情報、国勢調査データ、郵便番号など、各国固有の追加データが含まれます。

レスポンスを理解する

StartJob レスポンスは、新しく作成されたジョブをモニタリングおよび管理するための重要な情報を提供します。これらの値を使用してジョブの進行状況を追跡し、処理の完了時に結果を取得します。

レスポンスには、次のフィールドが含まれます。

ジョブ識別

作成されたジョブの一意の識別子。

  • JobId: モニタリングと管理オペレーションに使用される一意のジョブ識別子。

  • JobArn: 内のジョブを一意に識別する ARN AWS。

ジョブのステータスとタイミング

初期ステータスと作成タイムスタンプ。

  • Status: 初期ジョブのステータス。常に新しく作成されたジョブPending用。

  • CreatedAt: ISO 8601 形式のジョブ作成タイムスタンプ。