翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # StartCopyJob ジョブを開始し、指定したリソースの 1 回限りのコピーを作成します。 連続バックアップをサポートしません。 が[ジョブオペレーションのコピーを再試行](https://docs.aws.amazon.com/aws-backup/latest/devguide/recov-point-create-a-copy.html#backup-copy-retry)する方法については、「ジョブの AWS Backup 再試行のコピー」を参照してください。 ## リクエストの構文 ``` PUT /copy-jobs HTTP/1.1 Content-type: application/json { "DestinationBackupVaultArn": "string", "IamRoleArn": "string", "IdempotencyToken": "string", "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "RecoveryPointArn": "string", "SourceBackupVaultName": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [DestinationBackupVaultArn](#API_StartCopyJob_RequestSyntax) ** たとえば、`arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault` などのコピーするバックアップボールトを一意に識別する Amazon リソースネーム (ARN) です。 タイプ: 文字列 必須: はい ** [IamRoleArn](#API_StartCopyJob_RequestSyntax) ** たとえば、`arn:aws:iam::123456789012:role/S3Access` などのターゲットリカバリポイントのコピーに使用する IAM ロール ARN を指定します。 タイプ: 文字列 必須: はい ** [IdempotencyToken](#API_StartCopyJob_RequestSyntax) ** 別の `StartCopyJob` への同じコール間を区別するために使用できる顧客が選択した文字列。同じ冪等性トークンで成功したリクエストを再試行すると、アクションは実行されず、成功メッセージが表示されます。 タイプ: 文字列 必須: いいえ ** [Lifecycle](#API_StartCopyJob_RequestSyntax) ** 復旧ポイントがコールドストレージに移行するまでの期間、または削除されるまでの期間を日数で指定します。 コールドストレージに移行するバックアップは、最低 90 日間コールドストレージに保存する必要があります。したがって、コンソール上での保持期間の設定は、コールドへの移行 (日数) 設定から 90 日長くする必要があります。バックアップがコールドに移行された後で、コールドへの移行 (日数) の設定を変更することはできません。 コールドストレージに移行できるリソースタイプは、「[Feature availability by resource](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) table. AWS Backup ignores this expression for other resource types」に記載されています。 既存のライフサイクルと保持期間を削除し、復旧ポイントを無期限に保持するには、`MoveToColdStorageAfterDays` と `DeleteAfterDays` に -1 を指定します。 型: [Lifecycle](API_Lifecycle.md) オブジェクト 必須: いいえ ** [RecoveryPointArn](#API_StartCopyJob_RequestSyntax) ** たとえば、arn:aws:backup:us-east-1:123456789012:recovery-point:1eb3456789012:recovery-point:1eb3456789012:recovery-point: 1eb3456789012 などのコピージョブに使用するリカバリポイントを一意に識別する ARN。 タイプ: 文字列 必須: はい ** [SourceBackupVaultName](#API_StartCopyJob_RequestSyntax) ** バックアップを保存する論理ソースコンテナの名前。バックアップボールトは、作成に使用したアカウントと作成先の AWS リージョンに固有の名前で識別されます。 タイプ: 文字列 Pattern: `^[a-zA-Z0-9\-\_]{2,50}$` 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "CopyJobId": "string", "CreationDate": number, "IsParent": boolean } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [CopyJobId](#API_StartCopyJob_ResponseSyntax) ** コピージョブを一意に識別する。 タイプ: 文字列 ** [CreationDate](#API_StartCopyJob_ResponseSyntax) ** コピージョブが作成された日時 (Unix 時刻形式および協定世界時 (UTC))。`CreationDate`の値はミリ秒単位の精度です。たとえば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前12:11:30.087 を表します。 タイプ: タイムスタンプ ** [IsParent](#API_StartCopyJob_ResponseSyntax) ** これは親 (複合) バックアップジョブであることを示す、返されたブール値です。 タイプ: ブール値 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** InvalidParameterValueException ** パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。 ** Context ** ** Type ** HTTP ステータスコード: 400 ** InvalidRequestException ** リクエストへの入力に何らかの問題が発生していることを示します。たとえば、パラメータのタイプが間違っています。 ** Context ** ** Type ** HTTP ステータスコード: 400 ** LimitExceededException ** たとえば、リクエストで許可されるアイテムの最大数などのリクエストの制限を超えました。 ** Context ** ** Type ** HTTP ステータスコード: 400 ** MissingParameterValueException ** 必須パラメータがないことを示します。 ** Context ** ** Type ** HTTP ステータスコード: 400 ** ResourceNotFoundException ** アクションに必要なリソースは存在しません。 ** Context ** ** Type ** HTTP ステータスコード: 400 ** ServiceUnavailableException ** サーバーの一時的障害のため、リクエストは失敗しました。 ** Context ** ** Type ** HTTP ステータスコード: 500 ## その他の参照資料 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartCopyJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartCopyJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartCopyJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartCopyJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartCopyJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartCopyJob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartCopyJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartCopyJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartCopyJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartCopyJob)