---
title: "GET /copy-jobs/{copyJobId}"
method: GET
path: "/copy-jobs/{copyJobId}"
---

# GET /copy-jobs/{copyJobId}

`GET /copy-jobs/{copyJobId}`

Returns metadata associated with creating a copy of a resource.

## Path parameters

- `copyJobId` string, required

## Response `200`

Success

- DescribeCopyJobOutput
  - `CopyJob` object — Contains detailed information about a copy job.
    - `AccountId` string — The account ID that owns the copy job.
    - `CopyJobId` string — Uniquely identifies a copy job.
    - `SourceBackupVaultArn` string — An Amazon Resource Name (ARN) that uniquely identifies a source copy vault; for example, <code>arn:aws:backup:us-east-1:123456789012:vault:aBackupVault</code>.
    - `SourceRecoveryPointArn` string — An ARN that uniquely identifies a source recovery point; for example, <code>arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45</code>.
    - `DestinationBackupVaultArn` string — An Amazon Resource Name (ARN) that uniquely identifies a destination copy vault; for example, <code>arn:aws:backup:us-east-1:123456789012:vault:aBackupVault</code>.
    - `DestinationRecoveryPointArn` string — An ARN that uniquely identifies a destination recovery point; for example, <code>arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45</code>.
    - `ResourceArn` string — The Amazon Web Services resource to be copied; for example, an Amazon Elastic Block Store (Amazon EBS) volume or an Amazon Relational Database Service (Amazon RDS) database.
    - `CreationDate` string, date-time — The date and time a copy job is created, in Unix format and Coordinated Universal Time (UTC). The value of <code>CreationDate</code> is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.
    - `CompletionDate` string, date-time — The date and time a copy job is completed, in Unix format and Coordinated Universal Time (UTC). The value of <code>CompletionDate</code> is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.
    - `State` 'CREATED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'PARTIAL' — The current state of a copy job.
    - `StatusMessage` string — A detailed message explaining the status of the job to copy a resource.
    - `BackupSizeInBytes` integer — The size, in bytes, of a copy job.
    - `IamRoleArn` string — Specifies the IAM role ARN used to copy the target recovery point; for example, <code>arn:aws:iam::123456789012:role/S3Access</code>.
    - `CreatedBy` RecoveryPointCreator — Contains information about the backup plan and rule that Backup used to initiate the recovery point backup.
      - `BackupPlanId` string — Uniquely identifies a backup plan.
      - `BackupPlanArn` string — An Amazon Resource Name (ARN) that uniquely identifies a backup plan; for example, <code>arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50</code>.
      - `BackupPlanVersion` string — Version IDs are unique, randomly generated, Unicode, UTF-8 encoded strings that are at most 1,024 bytes long. They cannot be edited.
      - `BackupRuleId` string — Uniquely identifies a rule used to schedule the backup of a selection of resources.
    - `ResourceType` string — The type of Amazon Web Services resource to be copied; for example, an Amazon Elastic Block Store (Amazon EBS) volume or an Amazon Relational Database Service (Amazon RDS) database.
    - `ParentJobId` string — This uniquely identifies a request to Backup to copy a resource. The return will be the parent (composite) job ID.
    - `IsParent` boolean — This is a boolean value indicating this is a parent (composite) copy job.
    - `CompositeMemberIdentifier` string — This is the identifier of a resource within a composite group, such as nested (child) recovery point belonging to a composite (parent) stack. The ID is transferred from the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax"> logical ID</a> within a stack.
    - `NumberOfChildJobs` integer — This is the number of child (nested) copy jobs.
    - `ChildJobsInState` object — This returns the statistics of the included child (nested) copy jobs.
    - `ResourceName` string — This is the non-unique name of the resource that belongs to the specified backup.

## Other responses

- `480` — ResourceNotFoundException
- `481` — InvalidParameterValueException
- `482` — MissingParameterValueException
- `483` — ServiceUnavailableException

---

[API](https://skmtc.net/aws/apis/backup.md) · [All operations](https://skmtc.net/aws/apis/backup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/backup/versions/386d8a5f8871/schema)