翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # StartSearchResultExportJob このオペレーションは、検索ジョブの結果を指定された S3 バケットにエクスポートするジョブを開始します。 ## リクエストの構文 ``` PUT /export-search-jobs HTTP/1.1 Content-type: application/json { "ClientToken": "string", "ExportSpecification": { ... }, "RoleArn": "string", "SearchJobIdentifier": "string", "Tags": { "string" : "string" } } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [ClientToken](#API_BKS_StartSearchResultExportJob_RequestSyntax) ** べき等性の複数の同一の呼び出しを許可するには、このパラメータを含めます。クライアントトークンは、それを使用する最初のリクエストが完了してから 8 時間有効です。この時間が経過すると、同じトークンを持つリクエストは新しいリクエストとして処理されます。タイプ: 文字列必須: いいえ ** [ExportSpecification](#API_BKS_StartSearchResultExportJob_RequestSyntax) ** この仕様には、送信先バケットの必須文字列が含まれています。オプションで、送信先プレフィックスを含めることができます。型: [ExportSpecification](API_BKS_ExportSpecification.md) オブジェクト **注: **このオブジェクトは共用体です。このオブジェクトのメンバーは 1 つだけ指定または取得できます。必須: はい ** [RoleArn](#API_BKS_StartSearchResultExportJob_RequestSyntax) ** このパラメータは、検索結果のエクスポートジョブを開始するために使用されるロールの ARN を指定します。タイプ: 文字列長さの制限: 最小長は 20 です。最大長は 2,048 です。パターン: `arn:(?:aws|aws-cn|aws-us-gov):iam::[a-z0-9-]+:role/(.+)` 必須: いいえ ** [SearchJobIdentifier](#API_BKS_StartSearchResultExportJob_RequestSyntax) ** 検索ジョブを指定する一意の文字列。タイプ: 文字列必須: はい ** [Tags](#API_BKS_StartSearchResultExportJob_RequestSyntax) ** 追加するタグは任意です。タグは、リソースの管理、フィルタリング、検索に使用できるキーと値のペアです。使用可能な文字は、UTF-8の文字、数字、スペース、および以下の文字です。\$1 - = . \$1 : /。タイプ: 文字列間のマッピング必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "ExportJobArn": "string", "ExportJobIdentifier": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [ExportJobArn](#API_BKS_StartSearchResultExportJob_ResponseSyntax) ** これは、新しいエクスポートジョブに属する一意の ARN (Amazon リソースネーム) です。タイプ: 文字列 ** [ExportJobIdentifier](#API_BKS_StartSearchResultExportJob_ResponseSyntax) ** これは、新しいエクスポートジョブを指定する一意の識別子です。タイプ: 文字列 ## エラーすべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する十分なアクセス権限がありません。 ** message ** このアクションを実行する十分なアクセス権限がありません。 HTTP ステータスコード: 403 ** ConflictException ** この例外は、以前に成功したオペレーションとの競合が検出された場合に発生します。これは通常、前のオペレーションが現在のリクエストを処理するホストに伝達する時間がない場合に発生します。この例外に対して推奨されるレスポンスは、再試行 (適切なバックオフロジックを使用) です。 ** message ** リソースを更新または削除すると、整合性のない状態になる可能性があります。 ** resourceId ** 影響を受けるリソースの識別子。 ** resourceType ** 影響を受けるリソースのタイプ。 HTTP ステータスコード: 409 ** InternalServerException ** 内部サーバーエラーが発生しました。リクエストを再実行します。 ** message ** リクエストの処理中に予期しないエラーが発生しました。 ** retryAfterSeconds ** 秒数後に呼び出しを再試行します。 HTTP ステータスコード: 500 ** ResourceNotFoundException ** このリクエストではリソースが見つかりませんでした。 ARN やタイプなどのリソース情報が正しく存在していることを確認し、リクエストを再試行してください。 ** message ** リクエストが、存在しないリソースを参照しています。 ** resourceId ** 影響を受けるリソースの仮定識別子。 ** resourceType ** 影響を受けるリソースの仮定タイプ。 HTTP ステータスコード: 404 ** ServiceQuotaExceededException ** 許可されたクォータ制限を超えたため、リクエストが拒否されました。 ** message ** サービスクォータが制限を超えたため、このリクエストは失敗しました。 ** quotaCode ** これはクォータタイプに固有のコードです。 ** resourceId ** リソースの識別子。 ** resourceType ** リソースのタイプ。 ** serviceCode ** これは、クォータを持つ元のサービスに固有のコードです。 HTTP ステータスコード: 402 ** ThrottlingException ** リクエストのスロットリングにより、リクエストが拒否されました。 ** message ** リクエストのスロットリングにより、リクエストは失敗しました。 ** quotaCode ** これは、クォータを持つ元のサービスに固有のコードです。 ** retryAfterSeconds ** 秒数後に呼び出しを再試行します。 ** serviceCode ** これは、元のサービスに固有のコードです。 HTTP ステータスコード: 429 ** ValidationException ** 入力が、サービスで指定された制約を満たしていません。 ** message ** 入力が、Amazon サービスで指定された制約を満たしていません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StartSearchResultExportJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StartSearchResultExportJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StartSearchResultExportJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StartSearchResultExportJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StartSearchResultExportJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StartSearchResultExportJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StartSearchResultExportJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StartSearchResultExportJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StartSearchResultExportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StartSearchResultExportJob)