Copy Jobs - Create

Riferimento

Servizio:: Cosmos DB Resource Provider

Versione API:: 2025-05-01-preview

Crea un processo di copia.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/copyJobs/{jobName}?api-version=2025-05-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string minLength: 3 maxLength: 50 pattern: ^[a-z0-9]+(-[a-z0-9]+)*	Nome dell'account del database Cosmos DB.
jobName	path	True	string pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$	Nome del processo di copia
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties	True	CopyJobProperties	Proprietà di un processo di copia

Risposte

Nome	Tipo	Descrizione
200 OK	CopyJobGetResults	Risposta CreateJob riuscita
201 Created	CopyJobGetResults	Risposta CreateJob riuscita
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	Impersonare l'account utente

Esempio

CosmosDBCopyJobCreate

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/copyJobs/j1?api-version=2025-05-01-preview

{
  "properties": {
    "jobProperties": {
      "jobType": "NoSqlRUToNoSqlRU",
      "tasks": [
        {
          "source": {
            "databaseName": "sourceDb1",
            "containerName": "sourceTable1"
          },
          "destination": {
            "databaseName": "destDB1",
            "containerName": "destTable1"
          }
        },
        {
          "source": {
            "databaseName": "sourceDb2",
            "containerName": "sourceTable2"
          },
          "destination": {
            "databaseName": "destDB2",
            "containerName": "destTable2"
          }
        }
      ]
    },
    "mode": "Offline"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "ab1b6f34-b33c-46b1-98c7-3a0a63fd0d16",
  "type": "Microsoft.DocumentDB/databaseAccounts/copyJobs",
  "properties": {
    "jobProperties": {
      "jobType": "NoSqlRUToNoSqlRU",
      "tasks": [
        {
          "source": {
            "databaseName": "sourceDb1",
            "containerName": "sourceTable1"
          },
          "destination": {
            "databaseName": "destDB1",
            "containerName": "destTable1"
          }
        },
        {
          "source": {
            "databaseName": "sourceDb2",
            "containerName": "sourceTable2"
          },
          "destination": {
            "databaseName": "destDB2",
            "containerName": "destTable2"
          }
        }
      ]
    },
    "status": "Running",
    "mode": "Offline",
    "processedCount": 0,
    "totalCount": 0,
    "lastUpdatedUtcTime": "2021-06-12T11:10:55.2780000Z",
    "duration": "00:00:00"
  }
}

Codice di stato:: 201

{
  "id": "ab1b6f34-b33c-46b1-98c7-3a0a63fd0d16",
  "type": "Microsoft.DocumentDB/databaseAccounts/copyJobs",
  "properties": {
    "jobProperties": {
      "jobType": "NoSqlRUToNoSqlRU",
      "tasks": [
        {
          "source": {
            "databaseName": "sourceDb1",
            "containerName": "sourceTable1"
          },
          "destination": {
            "databaseName": "destDB1",
            "containerName": "destTable1"
          }
        },
        {
          "source": {
            "databaseName": "sourceDb2",
            "containerName": "sourceTable2"
          },
          "destination": {
            "databaseName": "destDB2",
            "containerName": "destTable2"
          }
        }
      ]
    },
    "status": "Pending",
    "mode": "Offline",
    "processedCount": 0,
    "totalCount": 0,
    "lastUpdatedUtcTime": "2021-06-12T11:10:55.2780000Z",
    "duration": "00:00:00"
  }
}

Definizioni

Nome	Descrizione
AzureBlobContainer	Un contenitore BLOB di Azure
AzureBlobSourceSinkDetails	Un'origine dati/sink di Archiviazione BLOB di Azure
BlobToCassandraRUCopyJobProperties	Origine dell'archiviazione BLOB di Azure alle proprietà del processo di copia Cassandra di destinazione
BlobToCassandraRUCopyJobTask
CassandraRUToBlobCopyJobProperties	Origine delle proprietà del processo di copia di Archiviazione BLOB di Azure da Cassandra a destinazione
CassandraRUToBlobCopyJobTask
CassandraRUToCassandraRUCopyJobProperties	Source Cassandra to Destination Cassandra copy job properties
CassandraRUToCassandraRUCopyJobTask
CloudError	Risposta di errore dal servizio.
CopyJobGetResults	Processo di copia di Cosmos DB
CopyJobMode	Modalità di esecuzione del processo
CopyJobProperties	Proprietà di un processo di copia
CopyJobStatus	Stato del lavoro
CosmosDBCassandraTable	Tabella Cassandra di CosmosDB
CosmosDBMongoCollection	Raccolta Mongo di CosmosDB
CosmosDBMongoVCoreCollection	Raccolta Di CosmosDB Mongo vCore
CosmosDBNoSqlContainer	Contenitore NoSQL di CosmosDB
CosmosDBSourceSinkDetails	Dettagli origine dati/sink di CosmosDB
ErrorResponse	Risposta errore.
MongoRUToMongoRUCopyJobProperties	Source Mongo to Destination Mongo copy job properties
MongoRUToMongoRUCopyJobTask
MongoRUToMongoVCoreCopyJobProperties	Source Mongo to Destination Mongo vCore copy job properties
MongoRUToMongoVCoreCopyJobTask
MongoVCoreSourceSinkDetails	Dettagli dell'origine dati/sink Mongo vCore di CosmosDB
NoSqlRUToNoSqlRUCopyJobProperties	Proprietà del processo di copia SQL di origine in SQL di destinazione
NoSqlRUToNoSqlRUCopyJobTask

AzureBlobContainer

Object

Un contenitore BLOB di Azure

Nome	Tipo	Descrizione
containerName	string	Contenitore BLOB di Azure.

AzureBlobSourceSinkDetails

Object

Un'origine dati/sink di Archiviazione BLOB di Azure

Nome	Tipo	Descrizione
endpointUrl	string pattern: ^https?://[^/$.?# ]+.[^ ]*$	Endpoint del contenitore BLOB di Azure.

BlobToCassandraRUCopyJobProperties

Object

Origine dell'archiviazione BLOB di Azure alle proprietà del processo di copia Cassandra di destinazione

Nome	Tipo	Valore predefinito	Descrizione
destinationDetails	CosmosDBSourceSinkDetails		Dettagli dell'archivio dati Cassandra di destinazione
jobType	string: AzureBlobStorageToCassandraRU	NoSqlRUToNoSqlRU	Copia tipo di processo
sourceDetails	AzureBlobSourceSinkDetails		Dettagli dell'archivio dati del contenitore di Archiviazione di Azure
tasks	BlobToCassandraRUCopyJobTask[]		Copiare le attività del processo.

BlobToCassandraRUCopyJobTask

Object

Nome	Tipo	Descrizione
destination	CosmosDBCassandraTable	Tabella Cassandra di destinazione
processedCount	integer (int64)	Conteggio elaborato a livello di attività.
source	AzureBlobContainer	Contenitore BLOB di Azure di origine
totalCount	integer (int64)	Conteggio totale a livello di attività.

CassandraRUToBlobCopyJobProperties

Object

Origine delle proprietà del processo di copia di Archiviazione BLOB di Azure da Cassandra a destinazione

Nome	Tipo	Valore predefinito	Descrizione
destinationDetails	AzureBlobSourceSinkDetails		Dettagli dell'archivio dati Cassandra di destinazione
jobType	string: CassandraRUToAzureBlobStorage	NoSqlRUToNoSqlRU	Copia tipo di processo
sourceDetails	CosmosDBSourceSinkDetails		Dettagli dell'archivio dati Cassandra di origine
tasks	CassandraRUToBlobCopyJobTask[]		Copiare le attività del processo.

CassandraRUToBlobCopyJobTask

Object

Nome	Tipo	Descrizione
destination	AzureBlobContainer	Contenitore BLOB di Azure di destinazione
processedCount	integer (int64)	Conteggio elaborato a livello di attività.
source	CosmosDBCassandraTable	Tabella Cassandra di origine
totalCount	integer (int64)	Conteggio totale a livello di attività.

CassandraRUToCassandraRUCopyJobProperties

Object

Source Cassandra to Destination Cassandra copy job properties

Nome	Tipo	Valore predefinito	Descrizione
destinationDetails	CosmosDBSourceSinkDetails		Dettagli dell'archivio dati Cassandra di destinazione
jobType	string: CassandraRUToCassandraRU	NoSqlRUToNoSqlRU	Copia tipo di processo
sourceDetails	CosmosDBSourceSinkDetails		Dettagli dell'archivio dati Cassandra di origine
tasks	CassandraRUToCassandraRUCopyJobTask[]		Copiare le attività del processo.

CassandraRUToCassandraRUCopyJobTask

Object

Nome	Tipo	Descrizione
destination	CosmosDBCassandraTable	Tabella Cassandra di destinazione
processedCount	integer (int64)	Conteggio elaborato a livello di attività.
source	CosmosDBCassandraTable	Tabella Cassandra di origine
totalCount	integer (int64)	Conteggio totale a livello di attività.

CloudError

Object

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
error	ErrorResponse	Risposta errore.

CopyJobGetResults

Object

Processo di copia di Cosmos DB

Nome	Tipo	Descrizione
id	string	Identificatore univoco della risorsa dell'account del database.
name	string	Nome dell'account di database.
properties	CopyJobProperties	Proprietà di un processo di copia
type	string	Tipo di risorsa di Azure.

CopyJobMode

Enumerazione

Modalità di esecuzione del processo

Valore	Descrizione
Offline
Online

CopyJobProperties

Object

Proprietà di un processo di copia

Nome	Tipo	Descrizione
duration	string	Durata totale del processo
error	ErrorResponse	Risposta di errore per il processo con errori
jobProperties	BaseCopyJobProperties: BlobToCassandraRUCopyJobProperties CassandraRUToBlobCopyJobProperties CassandraRUToCassandraRUCopyJobProperties MongoRUToMongoRUCopyJobProperties MongoRUToMongoVCoreCopyJobProperties NoSqlRUToNoSqlRUCopyJobProperties	Proprietà lavoro
lastUpdatedUtcTime	string (date-time)	Ora ultimo aggiornamento (formato ISO-8601)
mode	CopyJobMode	Modalità di esecuzione del processo
processedCount	integer (int64)	Conteggio elaborato
status	CopyJobStatus	Stato del lavoro
totalCount	integer (int64)	Conteggio totale
workerCount	integer (int32) minimum: 0	Conteggio ruoli di lavoro

CopyJobStatus

Enumerazione

Stato del lavoro

Valore	Descrizione
Cancelled
Completed
Faulted
Partitioning
Paused
Pending
Running

CosmosDBCassandraTable

Object

Tabella Cassandra di CosmosDB

Nome	Tipo	Descrizione
keyspaceName	string	Keyspace di Azure Cosmos DB per Apache Cassandra.
tableName	string	Tabella di Azure Cosmos DB per Apache Cassandra.

CosmosDBMongoCollection

Object

Raccolta Mongo di CosmosDB

Nome	Tipo	Descrizione
collectionName	string	Raccolta di Azure Cosmos DB per MongoDB (UR).
databaseName	string	Database di Azure Cosmos DB per MongoDB (UR).

CosmosDBMongoVCoreCollection

Object

Raccolta Di CosmosDB Mongo vCore

Nome	Tipo	Descrizione
collectionName	string	Raccolta di Azure Cosmos DB per MongoDB (vCore).
databaseName	string	Database Azure Cosmos DB per MongoDB (vCore).

CosmosDBNoSqlContainer

Object

Contenitore NoSQL di CosmosDB

Nome	Tipo	Descrizione
containerName	string	Contenitore Azure Cosmos DB per NoSQL.
databaseName	string	Database Azure Cosmos DB per NoSQL.

CosmosDBSourceSinkDetails

Object

Dettagli origine dati/sink di CosmosDB

Nome	Tipo	Descrizione
remoteAccountName	string	Nome dell'account remoto in caso di trasferimento dei dati tra account.

ErrorResponse

Object

Risposta errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

MongoRUToMongoRUCopyJobProperties

Object

Source Mongo to Destination Mongo copy job properties

Nome	Tipo	Valore predefinito	Descrizione
destinationDetails	CosmosDBSourceSinkDetails		Dettagli dell'archivio dati Mongo di destinazione
jobType	string: MongoRUToMongoRU	NoSqlRUToNoSqlRU	Copia tipo di processo
sourceDetails	CosmosDBSourceSinkDetails		Dettagli dell'archivio dati Mongo di origine
tasks	MongoRUToMongoRUCopyJobTask[]		Copiare le attività del processo.

MongoRUToMongoRUCopyJobTask

Object

Nome	Tipo	Descrizione
destination	CosmosDBMongoCollection	Raccolta Mongo (UR) di destinazione
processedCount	integer (int64)	Conteggio elaborato a livello di attività.
source	CosmosDBMongoCollection	Raccolta Mongo (UR) di origine
totalCount	integer (int64)	Conteggio totale a livello di attività.

MongoRUToMongoVCoreCopyJobProperties

Object

Source Mongo to Destination Mongo vCore copy job properties

Nome	Tipo	Valore predefinito	Descrizione
destinationDetails	MongoVCoreSourceSinkDetails		Dettagli dell'archivio dati Mongo (vCore) di destinazione
jobType	string: MongoRUToMongoVCore	NoSqlRUToNoSqlRU	Copia tipo di processo
sourceDetails	CosmosDBSourceSinkDetails		Dettagli dell'archivio dati Mongo (UR) di origine
tasks	MongoRUToMongoVCoreCopyJobTask[]		Copiare le attività del processo.

MongoRUToMongoVCoreCopyJobTask

Object

Nome	Tipo	Descrizione
destination	CosmosDBMongoVCoreCollection	Raccolta Mongo (vCore) di destinazione
processedCount	integer (int64)	Conteggio elaborato a livello di attività.
source	CosmosDBMongoCollection	Raccolta Mongo (UR) di origine
totalCount	integer (int64)	Conteggio totale a livello di attività.

MongoVCoreSourceSinkDetails

Object

Dettagli dell'origine dati/sink Mongo vCore di CosmosDB

Nome	Tipo	Descrizione
connectionStringKeyVaultUri	string pattern: ^https?://[^/$.?# ]+.[^ ]*$	URI del segreto di Azure KeyVault contenente la stringa di connessione.
hostName	string

NoSqlRUToNoSqlRUCopyJobProperties

Object

Proprietà del processo di copia SQL di origine in SQL di destinazione

Nome	Tipo	Valore predefinito	Descrizione
destinationDetails	CosmosDBSourceSinkDetails		Dettagli dell'archivio dati SQL di destinazione
jobType	string: NoSqlRUToNoSqlRU	NoSqlRUToNoSqlRU	Copia tipo di processo
sourceDetails	CosmosDBSourceSinkDetails		Dettagli dell'archivio dati SQL di origine
tasks	NoSqlRUToNoSqlRUCopyJobTask[]		Copiare le attività del processo.

NoSqlRUToNoSqlRUCopyJobTask

Object

Nome	Tipo	Descrizione
destination	CosmosDBNoSqlContainer	Contenitore SQL di destinazione
processedCount	integer (int64)	Conteggio elaborato a livello di attività.
source	CosmosDBNoSqlContainer	Contenitore SQL di origine
totalCount	integer (int64)	Conteggio totale a livello di attività.

Condividi tramite

Copy Jobs - Create

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

CosmosDBCopyJobCreate

Esempio di richiesta

Risposta di esempio

Definizioni

AzureBlobContainer

AzureBlobSourceSinkDetails

BlobToCassandraRUCopyJobProperties

BlobToCassandraRUCopyJobTask

CassandraRUToBlobCopyJobProperties

CassandraRUToBlobCopyJobTask

CassandraRUToCassandraRUCopyJobProperties

CassandraRUToCassandraRUCopyJobTask

CloudError

CopyJobGetResults

CopyJobMode

CopyJobProperties

CopyJobStatus

CosmosDBCassandraTable

CosmosDBMongoCollection

CosmosDBMongoVCoreCollection

CosmosDBNoSqlContainer

CosmosDBSourceSinkDetails

ErrorResponse

MongoRUToMongoRUCopyJobProperties

MongoRUToMongoRUCopyJobTask

MongoRUToMongoVCoreCopyJobProperties

MongoRUToMongoVCoreCopyJobTask

MongoVCoreSourceSinkDetails

NoSqlRUToNoSqlRUCopyJobProperties

NoSqlRUToNoSqlRUCopyJobTask