Preparación para las transferencias de datos de dispositivo

Indicador de fase de preparación para transferencia de dispositivo

En este tema, se describen las tareas asociadas a la preparación del trabajo de importación de datos basada en dispositivo. El rol de patrocinador de proyecto normalmente realiza estas tareas. Consulte Roles y responsabilidades.

Nota

Solo puede ejecutar los comandos de la CLI de Oracle Cloud Infrastructure desde un host de Linux. Esto difiere de la ejecución de comandos de la CLI para otros servicios de Oracle Cloud Infrastructure en una variedad de sistemas operativos de host. Los comandos basados en dispositivo requieren validación, algo que solo está disponible en hosts de Linux.

Instalación y uso de la interfaz de línea de comandos de Oracle Cloud Infrastructure

La interfaz de línea de comandos (CLI) de Oracle Cloud Infrastructure proporciona un juego de herramientas basadas en la línea de comandos para configurar y ejecutar los trabajos de importación de datos basada en dispositivo. Use la CLI de Oracle Cloud Infrastructure como alternativa a la ejecución de comandos desde la consola. A veces, debe usar la CLI para completar determinadas tareas, ya que no hay equivalente de consola.

Versión mínima necesaria de la CLI

La versión mínima de la CLI necesaria para la importación de datos basada en aplicaciones es la 2.12.1.

Determinación de las versiones de CLI

Acceda a la siguiente URL para ver la versión disponible actualmente de la CLI:

https://github.com/oracle/oci-cli/blob/master/CHANGELOG.rst

Introduzca el siguiente comando en el símbolo del sistema para ver la versión de la CLI instalada actualmente en la máquina:

oci --version

Si tiene una versión en su máquina anterior a la versión disponible actualmente, instale la versión más reciente.

Nota

Actualice siempre a la última versión de la CLI. La CLI no se actualiza automáticamente y solo puede acceder a las funciones de la CLI nuevas o actualizadas instalando la versión actual.

Requisitos del sistema operativo Linux

Consulte Requisitos para obtener una lista de los sistema operativos de Linux que soporten la CLI.

Instalación de la CLI

La instalación y la configuración de las CLI se describen detalladamente en Interfaz de línea de comandos (CLI).

Uso de la CLI

Puede especificar las opciones de la CLI mediante los siguientes comandos:

  • --option value o

  • --option=value

La sintaxis básica de la CLI es:

oci dts resource action options

Esta sintaxis se aplica a lo siguiente:

  • oci dts es el nombre abreviado del comando de la CLI.

  • job es un ejemplo de resource.

  • create es un ejemplo de action.

  • Otras cadenas son options.

El siguiente comando para crear un trabajo de transferencia muestra una construcción típica del comando de la CLI.

oci dts job create --compartment-id ocid1.compartment.oc1..exampleuniqueID --bucket MyBucket --display-name MyApplianceImportJob --device-type appliance
Nota

En los ejemplos anteriores, proporcione un nombre descriptivo para el trabajo de transferencia con la opción ‑‑display‑name. Evite introducir información confidencial.

Acceso a la ayuda de la interfaz de línea de comandos

Todos los comandos de ayuda de la CLI tienen un componente de ayuda asociado al que puede acceder desde la línea de comandos. Para ver la ayuda, introduzca cualquier comando seguido de la opción --help o -h. Por ejemplo:


oci dts job --help
			
NAME
  dts_job -

DESCRIPTION
  Transfer disk or appliance job operations

AVAILABLE COMMANDS
  o change-compartment
  o close
  o create
  o delete
  o detach-devices-details
  ...

Al ejecutar la opción de ayuda (--help o -h) para un comando especificado, se muestran todos los comandos y opciones subordinados para ese nivel de CLI. Si desea acceder a la ayuda de la CLI de un comando subordinado específico, inclúyalo en la cadena de la CLI; por ejemplo:


oci dts job create --help
			
NAME
  dts_job_create -

DESCRIPTION
  Creates a new transfer disk or appliance job.

USAGE
  oci dts job create [OPTIONS]

REQUIRED PARAMETERS
  --bucket [text]

Upload bucket name

--compartment-id, -c [text]

Compartment OCID

--device-type [text]

Creación de usuarios, grupos y políticas de IAM necesarios

Cada servicio en Oracle Cloud Infrastructure se integra con IAM para la autenticación y autorización.

Para usar Oracle Cloud Infrastructure, se le debe conceder el tipo de acceso necesario en una política  escrita por un administrador, tanto si utiliza la consola como la API de REST con un SDK, una CLI u otra herramienta. Si intenta realizar una acción y obtiene un mensaje que indica que no tiene permiso o no está autorizado, confirme con el administrador el tipo de acceso que se le ha otorgado y en qué compartimento  debe trabajar.

El acceso a los recursos se proporciona a grupos mediante políticas y, a continuación, lo heredan los usuarios asignados a esos grupos. La transferencia de datos requiere la creación de dos grupos distintos:

  • Administradores de transferencia de datos que pueden crear y gestionar trabajos de transferencia.

  • Usuarios de carga de transferencia de datos que pueden cargar datos en Object Storage. Para la seguridad de sus datos, los permisos para los usuarios de carga permiten al personal de Oracle cargar objetos estándar y de varias partes en su nombre e inspeccionar metadatos de objetos y cubos. Los permisos no permiten al personal de Oracle inspeccionar los datos reales.

El administrador de datos es responsable de generar las claves RSA necesarias para los usuarios de carga temporales. Estas claves nunca deben compartirse entre usuarios.

Para obtener más información sobre la creación de grupos, consulte Gestión de grupos.

Un administrador crea estos grupos con las siguientes políticas:

  • El grupo de administradores de transferencias de datos requiere una política de autorización que incluye lo siguiente:

    Allow group group_name to manage data-transfer-jobs in compartment compartment_name
    Allow group group_name to manage objects in compartment compartment_name
    Allow group group_name to manage buckets in compartment compartment_name

    También puede consolidar las políticas manage buckets y manage objects en lo siguiente:

    Allow group group_name to manage object-family in compartment compartment_name
  • El grupo de usuarios de carga de transferencia de datos requiere una política de autorización que incluya lo siguiente:

    Allow group group_name to manage buckets in compartment compartment_name where all { request.permission='BUCKET_READ', target.bucket.name='<bucket_name>' }
    Allow group group_name to manage objects in compartment compartment_name where all { target.bucket.name='<bucket_name>', any { request.permission='OBJECT_CREATE', request.permission='OBJECT_OVERWRITE', request.permission='OBJECT_INSPECT' }}

Para activar notificaciones, agregue las siguientes políticas:

Allow group group name to manage ons-topics in tenancy
Allow group group name to manage ons-subscriptions in tenancy
Allow group group name to manage cloudevents-rules in tenancy
Allow group group name to inspect compartments in tenancy

Consulte Notificaciones y Visión general de los eventos para obtener más información.

A continuación, el administrador de Oracle Cloud Infrastructure agrega un usuario a cada uno de los grupos de transferencia de datos creados. Para obtener más información sobre la creación de usuarios, consulte Gestión de usuarios.

Importante

Por motivos de seguridad, se recomienda crear un único usuario de carga de transferencia de datos de IAM para cada trabajo de transferencia y, a continuación, suprimir ese usuario una vez cargados los datos en Oracle Cloud Infrastructure.

Solicitud de derecho de dispositivo

Si su arrendamiento no tiene derechos para utilizar el dispositivo de transferencia de datos, debe solicitar el derecho de dispositivo de transferencia de datos antes de crear un trabajo de transferencia basada en dispositivo.

Importante

El comprador o administrador principal, con grado de vicepresidente o superior, recibe una notificación por correo electrónico y debe firmar un documento de condiciones. Después de que Oracle haya confirmado la firma del documento, puede crear un trabajo de transferencia basado en dispositivo. El correo electrónico para DocuSign no se envía al solicitante a menos que sea el comprador principal o el administrador, con grado de vicepresidente o superior.

El envío de las condiciones puede tardar hasta 24 horas.

Para solicitar el derecho de dispositivo de transferencia de datos mediante la consola

Abra la página Trabajo de transferencia y haga clic en Solicitud en la parte superior. De lo contrario, se le pedirá que solicite el derecho al crear el primer trabajo de transferencia basada en dispositivo.

Una vez solicitado, el estado de la solicitud se puede visualizar en la parte superior de la página Trabajo de transferencia. Por ejemplo:

Derecho de dispositivo de transferencia de datos: otorgado.

La aprobación del derecho de dispositivo de transferencia de datos puede tardar un poco. Una vez que Oracle recibe la solicitud, se envía un acuerdo de términos y condiciones al propietario de la cuenta mediante DocuSign para usar el dispositivo. La solicitud de derecho se aprueba una vez que se recibe la firma. El derecho de dispositivo de transferencia de datos es un derecho de arrendamiento que necesita solicitar una vez para cada arrendamiento.

Para solicitar el derecho de dispositivo de transferencia de datos mediante la CLI
oci dts appliance request-entitlement --compartment-id compartment_id --name name --email email

name es el nombre del solicitante.

email es la dirección de correo electrónico del solicitante.

Por ejemplo:

oci dts appliance request-entitlement --compartment-id ocid.compartment.oc1..exampleuniqueID --name "John Doe" --email jdoe@mycompany.com
					
{
  "data": {
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "creation-time": "2019-12-18T18:29:15+00:00",
	"defined-tags": {},
	"display-name": null,
	"freeform-tags": {},
	"id": "ocid1.datatransferapplianceentitlement.oc1..exampleuniqueID",
	"lifecycle-state": "CREATING",
	"lifecycle-state-details": "REQUESTED",
	"requestor-email": "jdoe@mycompany.com",
	"requestor-name": "John Doe",
    "update-time": "2019-12-20T19:04:09+00:00"
  }
}
Para mostrar el estado de una solicitud de derecho de dispositivo de transferencia de datos mediante la CLI
oci dts appliance show-entitlement --compartment-id compartment_id

Por ejemplo:

oci dts appliance show-entitlement --compartment-id ocid.compartment.oc1..exampleuniqueID 
{
  "data": {
    "compartment-id": ""ocid.compartment.oc1..exampleuniqueID",
    "defined-tags": null,
    "display-name": null,
    "freeform-tags": null,
    "id": null,
    "lifecycle-state": "ACTIVE",
    "lifecycle-state-details": "APPROVED",
    "requestor-email": "jdoe@mycompany.com",
    "requestor-name": "John Doe"
  }
}

Establecimiento de la política de derecho de dispositivo de transferencia de datos

Utilice la siguiente política para permitir a los usuarios de un grupo específico solicitar un derecho de dispositivo de transferencia de datos en su arrendamiento.

Allow group <group_name> to {DTA_ENTITLEMENT_CREATE} in tenancy

Elegibilidad de derechos del dispositivo

Es posible que se deniegue su solicitud de derecho de un dispositivo de transferencia de datos en su arrendamiento si es un cliente de prueba gratuita. Si se deniega la solicitud, cambie a una cuenta completa. También puede ponerse en contacto con el gestor de soporte al cliente de Oracle o los Servicios de Soporte Oracle para determinar las opciones para obtener el derecho.

Creación de cubos de Object Storage

El servicio Object Storage se utiliza para cargar los datos en Oracle Cloud Infrastructure. Object Storage almacena objetos en un contenedor denominado cubo dentro de un compartimento  en su arrendamiento. Para obtener más información sobre la creación del cubo para almacenar datos cargados, consulte Gestión de cubos.

Configuración de los valores del firewall

El número de puerto del firewall es 443 para todos los métodos de transferencia de datos.

Asegúrese de que el firewall del entorno local se puede comunicar con el Data Transfer Service que se ejecuta en los rangos de direcciones IP para la región OCI en función de la siguiente tabla. Asegúrese también de que existe acceso abierto al rango de direcciones IP de Object Storage. Solo tiene que configurar este acceso IP para la región a la que está asociado el trabajo de transferencia de datos.

Región

Data Transfer

Object Storage

Este de Estados Unidos (Ashburn)

140.91.0.0/16

134.70.24.0/21

Oeste de EEUU (Phoenix)

129.146.0.0/16

134.70.8.0/21

Alemania central (Fráncfort)

130.61.0.0/16

134.70.40.0/21

Sur de Reino Unido (Londres)

132.145.0.0/16

134.70.56.0/21

Este de Brasil (São Paulo)

140.204.0.0/16

134.70.84.0/22

Oeste de India (Mumbai)

140.204.0.0/16

134.70.76.0/22

Este de Japón (Tokio)

140.204.0.0/16

134.70.80.0/22

Centro de Corea del Sur (Seúl)

140.204.0.0/16

134.70.96.0/22

Centro de Japón (Osaka)

140.204.0.0/16

134.70.112.0/22

Sudeste de Canadá (Toronto)

140.204.0.0/16

134.70.116.0/22

Creación de trabajos de transferencia

En esta sección se describe cómo crear un trabajo de transferencia como parte de la preparación para la transferencia de datos. Consulte Trabajos de transferencia de importación de dispositivo para obtener más información sobre todas las tareas relacionadas con los trabajos de transferencia.

Un trabajo de transferencia representa la recopilación de archivos que desea transferir y señala la intención de cargar dichos archivos en Oracle Cloud Infrastructure. Identifique el compartimento y el cubo de Object Storage en los que Oracle va a cargar los datos. Cree el trabajo de transferencia en el mismo compartimento que el cubo de carga y proporcione un nombre legible al trabajo de transferencia.

Nota

Se recomienda crear un compartimento para cada trabajo de transferencia para minimizar el acceso necesario al arrendamiento.

Al crear un trabajo de transferencia, se devuelve un ID de trabajo correspondiente que se especifica en otras tareas de transferencia. Por ejemplo:

ocid1.datatransferjob.region1.phx..unique_ID
Para crear un trabajo de transferencia con la consola
  1. Abra el menú de navegación y haga clic en Migración. En Data Transfer, haga clic en Importaciones.

  2. Seleccione el compartimento designado que va a utilizar para las transferencias de datos en la lista.

    Se muestra una lista de trabajos de transferencia que ya se han creado.

  3. Haga clic en Crear trabajo de transferencia.

    Aparece el cuadro de diálogo Crear trabajo de transferencia.

  4. Introduzca un nombre de trabajo. Evite introducir información confidencial. A continuación, seleccione Cargar cubo en la lista.

  5. Seleccione Dispositivo para Tipo de dispositivo de transferencia.

  6. Haga clic en Crear trabajo de transferencia.

Para crear un trabajo de transferencia con la CLI

Utilice el comando oci dts job create y los parámetros necesarios para crear un trabajo de transferencia de importación del dispositivo

oci dts job create --bucket bucket --compartment-id compartment_id --display-name display_name --device-type appliance [OPTIONS]

Para obtener una lista completa de indicadores y opciones de variables para los comandos de la CLI, consulte Referencia de la línea de comandos.

Por ejemplo:

oci dts job create --bucket MyBucket1 --compartment-id ocid.compartment.oc1..exampleuniqueID --display-name MyApplianceImportJob --device-type appliance
				
{
  "data": {
    "attached-transfer-appliance-labels": [],
    "attached-transfer-device-labels": [],
    "attached-transfer-package-labels": [],
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "creation-time": "2019-12-18T19:43:58+00:00",
    "defined-tags": {},
    "device-type": "APPLIANCE",
    "display-name": "MyApplianceImportJob",
    "freeform-tags": {},
    "id": "ocid1.datatransferjob.oc1..exampleuniqueID",
    "label": "JAKQVAGJF",
    "lifecycle-state": "INITIATED",
    "upload-bucket-name": "MyBucket1"
  },
  "etag": "2--gzip"
}

Si lo desea, puede especificar una o más etiquetas definidas o de formato libre al crear un trabajo de transferencia. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos.

Etiquetas definidas

Para especificar etiquetas definidas al crear un trabajo:

oci dts job create --bucket bucket --compartment-id compartment_id --display-name display_name --device-type appliance --defined-tags '{ "tag_namespace": { "tag_key":"value" }}'

Por ejemplo:

oci dts job create --bucket MyBucket1 --compartment-id ocid.compartment.oc1..exampleuniqueID --display-name MyApplianceImportJob --device-type appliance --defined-tags '{"Operations": {"CostCenter": "01"}}'
				
{
"data": {
  "attached-transfer-appliance-labels": [],
  "attached-transfer-device-labels": [],
  "attached-transfer-package-labels": [],
  "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
  "creation-time": "2019-12-18T19:43:58+00:00",
  "defined-tags": {
    "operations": {
      "costcenter": "01"
    }
  },
  "device-type": "APPLIANCE",
  "display-name": "MyApplianceImportJob",
  "freeform-tags": {},
  "id": "ocid1.datatransferjob.oc1..exampleuniqueID",
  "label": "JAKQVAGJF",
  "lifecycle-state": "INITIATED",
  "upload-bucket-name": "MyBucket1"
  },
  "etag": "2--gzip"
}
Etiquetas de formato libre

Para especificar etiquetas de formato libre al crear un trabajo:

oci dts job create --bucket bucket --compartment-id compartment_id --display-name display_name --device-type appliance --freeform-tags '{ "tag_key":"value" }'				

Por ejemplo:

oci dts job create --bucket MyBucket1 --compartment-id ocid.compartment.oc1..exampleuniqueID --display-name MyApplianceImportJob --device-type appliance --freeform-tags '{"Pittsburg_Team":"brochures"}'
				
{
"data": {
  "attached-transfer-appliance-labels": [],
  "attached-transfer-device-labels": [],
  "attached-transfer-package-labels": [],
  "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
  "creation-time": "2019-12-18T19:43:58+00:00",
  "defined-tags": {},
  "device-type": "APPLIANCE",
  "display-name": "MyApplianceImportJob",
  "freeform-tags": {
	"Pittsburg_Team": "brochures"
  },
  "id": "ocid1.datatransferjob.oc1..exampleuniqueID",
  "label": "JAKQVAGJF",
  "lifecycle-state": "INITIATED",
  "upload-bucket-name": "MyBucket1"
  },
  "etag": "2--gzip"
}
Nota

Los usuarios crean espacios de nombres de etiquetas y claves de etiquetas con los permisos necesarios. Estos elementos deben existir antes de poder especificarlos al crear un trabajo. Consulte Trabajar con etiquetas definidas para obtener más información.

Varias etiquetas

Para especificar varias etiquetas, separe con comas los pares de clave/valor con formato JSON:

oci dts job create --bucket bucket --compartment-id compartment_id --display-name display_name --device-type appliance --freeform-tags '{ "tag_key":"value" }', '{ "tag_key":"value" }'

Notificaciones

Para incluir notificaciones, incluya la opción --setup-notifications. Consulte Configuración de notificaciones de trabajos de transferencia desde la CLI para obtener más información sobre esta función.

Obtención de ID de trabajos de transferencia

Cada trabajo de transferencia que cree tiene un ID único en Oracle Cloud Infrastructure. Por ejemplo:

ocid1.datatransferjob.oc1.phx.exampleuniqueID

Deberá reenviar este ID de trabajo de transferencia al administrador de datos.

Para obtener el ID del trabajo de transferencia mediante la consola
  1. Abra el menú de navegación y haga clic en Migración. En Data Transfer, haga clic en Importaciones.

  2. Seleccione el Compartimento en la lista.

    Se muestran los trabajos de transferencia de ese compartimento.

  3. Haga clic en el enlace situado debajo de Trabajos de transferencia para el trabajo de transferencia cuyos detalles desea ver.

    También puede hacer clic en el icono Acciones (icono Acciones) y, a continuación, en Ver detalles.

    Aparece la página Detalles de ese trabajo de transferencia.

  4. Busque el campo OCID en la página Detalles y haga clic en Mostrar para mostrarlo o en Copiar para copiarlo en la computadora.

Para obtener el ID de trabajo de transferencia mediante la CLI

Utilice el comando oci dts job list y los parámetros necesarios para mostrar los trabajos de transferencia de importación del dispositivo en su arrendamiento.

oci dts job list --compartment-id compartment_id [OPTIONS]

Para obtener una lista completa de indicadores y opciones de variables para los comandos de la CLI, consulte Referencia de la línea de comandos.

Por ejemplo:

oci dts job list --compartment-id ocid.compartment.oc1..exampleuniqueID
					
{
  "data": [
    {
      "creation-time": "2019-12-18T19:43:58+00:00",
      "defined-tags": {},
      "device-type": "APPLIANCE",
      "display-name": "MyApplianceImportJob",
      "freeform-tags": {},
      "id": "ocid1.datatransferjob.oc1..exampleuniqueID",
      "label": "JAKQVAGJF",
      "lifecycle-state": "INITIATED",
      "upload-bucket-name": "MyBucket1"
    },
    {
      "creation-time": "2019-10-03T16:52:26+00:00",
      "defined-tags": {},
      "device-type": "DISK",
      "display-name": "MyDiskImportJob",
      "freeform-tags": {},
      "id": "ocid1.datatransferjob.oc1..exampleuniqueID",
      "label": "J2AWEOL5T",
      "lifecycle-state": "INITIATED",
      "upload-bucket-name": "MyBucket2"
    }
  ]
}

El ID de cada trabajo de transferencia se incluye en la devolución:

"id": "ocid.compartment.oc1..exampleuniqueID"
Consejo

Al crear un trabajo de transferencia mediante la CLI de oci dts job create, el ID de trabajo de transferencia se muestra en lo que devuelve la CLI. También puede ejecutar la CLI de oci dts job show para ese trabajo específico para obtener el ID.

Configuración de notificaciones de trabajo de transferencia desde la CLI

Puede generar notificaciones que envíen mensajes sobre los cambios en un trabajo de transferencia nuevo o existente a través de la CLI. Al usar esta función se crea un tema, una suscripción a una lista de direcciones de correo electrónico y una regla que le envía notificaciones sobre todos los eventos relacionados con las actividades del trabajo de exportación y los cambios en el estado. Este método proporciona una forma más práctica de generar notificaciones adaptadas a los trabajos de transferencia basados en dispositivos.

El comando de la CLI para configurar las notificaciones de trabajos de transferencia varía en función de si está creando un nuevo trabajo de transferencia o actualizando un trabajo de exportación existente. En ambos casos, al ejecutar el comando de la CLI se le solicita que introduzca las direcciones de correo electrónico de cada suscriptor de notificación como una lista separada por comas. A cada destinatario se le envía un correo electrónico con un enlace para confirmar que desea recibir las notificaciones.

Se le pedirá que introduzca esas direcciones de correo electrónico que desea incluir en las notificaciones, separadas por comas (","). Cuando termine la lista, agregue dos puntos (":") seguidos de su propia dirección de correo electrónico: user1@mycompany.com,user2@mycompany.com : myemail@mycompany.com.

Para ambos comandos de notificación, se devuelve lo siguiente:

If the commands fail to run, you can use the OCI CLI to do the setup manually:
export ROOT_COMPARTMENT_OCID=ocidv1:tenancy:oc1:exampleuniqueID
oci ons topic create --compartment-id $ROOT_COMPARTMENT_OCID --name DTSExportTopic --description "Topic for data transfer service export jobs"
oci ons subscription create --protocol EMAIL --compartment-id $ROOT_COMPARTMENT_OCID --topic-id $TOPIC_OCID --endpoint $EMAIL_ID
oci events rule create --display-name DTSExportRule --is-enabled true --compartment-id $ROOT_COMPARTMENT_OCID --actions '{"actions":[{"actionType":"ONS","topicId":"$TOPIC_OCID","isEnabled":true}]}' --condition '{"eventType":["com.oraclecloud.datatransferservice.addapplianceexportjob","com.oraclecloud.datatransferservice.deleteapplianceexportjob","com.oraclecloud.datatransferservice.updateapplianceexportjob","com.oraclecloud.datatransferservice.moveapplianceexportjob"]}' --description "Rule for data transfer service to send notifications for export jobs"
Creating topic for export
		

Para configurar notificaciones al crear un trabajo de transferencia mediante la CLI

Para configurar notificaciones al crear un trabajo de transferencia, incluya la opción --setup-notifications en la CLI:

oci dts job create --bucket bucket_name --compartment-id compartment_id --display-name display_name --device-type appliance ... --setup-notifications

Para configurar notificaciones para un trabajo de exportación existente mediante la CLI

Para configurar notificaciones para un trabajo de transferencia existente:

oci dts job setup-notifications --job-id job_id

Por ejemplo:

oci dts job setup-notifications --job-id ocid1.datatransferjob.oc1..exampleuniqueID

If the commands fail to run, you can use the OCI CLI to do the setup manually:
oci ons topic create --compartment-id ocid1.tenancy.oc1..exampleuniqueID --name MyImportJob --description "Topic for data transfer service import job with OCID ocid1.datatransferjob.oc1..exampleuniqueID"
oci ons subscription create --protocol EMAIL --compartment-id $ROOT_COMPARTMENT_OCID --topic-id $TOPIC_OCID --subscription_endpoint $EMAIL_ID
oci events rule create --display-name MyImportJob --is-enabled true--compartment-id ocid1.tenancy.oc1..exampleuniqueID --actions '{"actions":[{"actionType":"ONS","topicId":"$TOPIC_OCID","isEnabled":true}]}' --condition '{"eventType":"com.oraclecloud.datatransferservice.*transferjob","data":{"resourceId":"ocid1.datatransferjob.oc1..exampleuniqueID"}}' --description "Rule for data transfer service to send notifications for an import job with OCID ocid1.datatransferjob.oc1..exampleuniqueID"
Creating topic DTSImportJobTopic_2pwaqq

{
  "data": {
    "api-endpoint": "https://cell1.notification.us-phoenix-1.oraclecloud.com",
    "compartment-id": "ocid1.tenancy.oc1..exampleuniqueID",
    "defined-tags": {},
    "description": "Topic for data transfer service import job with OCID ocid1.datatransferjob.oc1..exampleuniqueID",
    "etag": null,
    "freeform-tags": {},
    "lifecycle-state": "ACTIVE",
    "name": "DTSImportJobTopic_2pwaqq",
    "time-created": "2020-07-15T18:26:07.179000+00:00",
    "topic-id": "ocid1.onstopic.oc1..exampleuniqueID"
  },
  "etag": "2e5a567d"
}

Enter email addresses to subscribe to as a comma separated list. Example: jdoe@mycompany.com,rroe@mycompany.com : jsmith@mycompany.com
Creating subscription for jsmith@mycompany.com
{
  "data": {
    "compartment-id": "ocid1.tenancy.oc1..exampleuniqueID",
    "created-time": 1594837577401,
    "defined-tags": {},
    "deliver-policy": "{\"maxReceiveRatePerSecond\":0,\"backoffRetryPolicy\":{\"initialDelayInFailureRetry\":60000,\"maxRetryDuration\":7200000,\"policyType\":\"EXPONENTIAL\"}}",
    "endpoint": "jsmith@mycompany.com",
    "etag": "cac2f405",
    "freeform-tags": {},
    "id": "ocid1.onssubscription.oc1..exampleuniqueID",
    "lifecycle-state": "PENDING",
    "protocol": "EMAIL",
    "topic-id": "ocid1.onstopic.oc1..exampleuniqueID"
  },
  "etag": "cac2f405"
}

Creating rule DTSImportJobRule_2pwaqq
{
  "data": {
    "actions": {
    "actions": [
      {
        "action-type": "ONS",
        "description": null,
        "id": "ocid1.eventaction.oc1..exampleuniqueID",
        "is-enabled": true,
        "lifecycle-message": null,
        "lifecycle-state": "ACTIVE",
        "topic-id": "ocid1.onstopic.oc1..exampleuniqueID"
      }
    ]
  },
    "compartment-id": "ocid1.tenancy.oc1..exampleuniqueID",
    "condition": "{\"eventType\":\"com.oraclecloud.datatransferservice.*transferjob\",\"data\":{\"resourceId\":\"ocid1.datatransferjob.oc1..exampleuniqueID\"}}",
    "defined-tags": {},
    "description": "Rule for data transfer service to send notifications for an import job with OCID ocid1.datatransferjob.oc1..exampleuniqueID",
    "display-name": "DTSImportJobRule_2pwaqq",
    "freeform-tags": {},
    "id": "ocid1.eventrule.oc1..exampleuniqueID",
    "is-enabled": true,
    "lifecycle-message": null,
    "lifecycle-state": "ACTIVE",
    "time-created": "2020-07-15T18:26:18.307000+00:00"
  },
  "etag": "aff873bfb4015b49902b97c7a6cc40588bf89b9e3deeb27b77ecce6d7a99768a"
}

Preparación de archivos de configuración de carga

El patrocinador de proyecto es responsable de crear u obtener los archivos de configuración que permiten la carga de datos de usuario en el dispositivo de importación. Envíe estos archivos de configuración al administrador de datos, donde se pueden colocar en el host de control (si hay hosts de datos y control independientes). El archivo config es para el administrador de transferencia de datos, el usuario de IAM con la autorización y los permisos para crear y gestionar trabajos de transferencia. El archivo config_upload_user es para el usuario de carga de transferencia de datos, el usuario temporal de IAM que Oracle utiliza para cargar sus datos en su nombre.

Cree un directorio base de Oracle Cloud Infrastructure y dos archivos de configuración con las credenciales necesarias.

Creación del directorio de transferencia de datos

Cree un directorio de Oracle Cloud Infrastructure (.oci) en el mismo equipo host de control en el que está instalada la CLI de Oracle Cloud Infrastructure. Por ejemplo:

mkdir /root/.oci/

Los dos archivos de configuración (config y config_upload_user) se colocan en la ubicación que seleccione.

Nota

Puede almacenar los archivos de configuración en cualquier lugar del host de control. El directorio root solo se proporciona como ejemplo.

Creación del archivo de configuración del administrador de transferencia de datos

El archivo de configuración del administrador de transferencia de datos contiene las credenciales necesarias para trabajar con Oracle Cloud Infrastructure. Puede crear este archivo mediante una CLI de configuración o manualmente con un editor de texto.

Uso de la CLI de configuración

Ejecute la utilidad de la línea de comandos oci setup config para recorrer el proceso de configuración por primera vez. El comando le solicita la información necesaria para el archivo de configuración y las claves públicas/privadas de API. El cuadro de diálogo de configuración genera un par de claves de API y crea el archivo de configuración.

Para obtener más información sobre cómo buscar la información necesaria, consulte:

Configuración manual

Si desea configurar las claves públicas/privadas de API y escribir su propio archivo de configuración, consulte Archivo de configuración SDK y CLI.

Consejo

Utilice el comando oci setup keys para generar un par de claves e incluirlas en el archivo de configuración.

Cree el archivo de configuración del administrador de transferencia de datos /root/.oci/config con la siguiente estructura:

[DEFAULT]
user=<The OCID for the data transfer administrator>
fingerprint=<The fingerprint of the above user's public key>
key_file=<The _absolute_ path to the above user's private key file on the host machine>
tenancy=<The OCID for the tenancy that owns the data transfer job and bucket>
region=<The region where the transfer job and bucket should exist. Valid values are: 
supported regions>.

donde supported regions son las regiones que se muestran en Regiones soportadas.

Por ejemplo:

[DEFAULT]
user=ocid1.user.oc1..unique_ID
fingerprint=4c:1a:6f:a1:5b:9e:58:45:f7:53:43:1f:51:0f:d8:45
key_file=/home/user/ocid1.user.oc1..exampleuniqueID.pem
tenancy=ocid1.tenancy.oc1..unique_ID
region=us-phoenix-1

Para el administrador de transferencia de datos, puede crear un solo archivo de configuración que contenga diferentes secciones de perfil con las credenciales para varios usuarios. A continuación, utilice la opción --profile para especificar qué perfil utilizar en el comando A continuación se muestra un ejemplo de un archivo de configuración de administrador de transferencias de datos con diferentes secciones de perfil:

[DEFAULT]
user=ocid1.user.oc1..exampleuniqueID
fingerprint=4c:1a:6f:a1:5b:9e:58:45:f7:53:43:1f:51:0f:d8:45
key_file=/home/user/ocid1.user.oc1..exampleuniqueID.pem
tenancy=ocid1.tenancy.oc1..exampleuniqueID
region=us-phoenix-1
[PROFILE1]
user=ocid1.user.oc1..exampleuniqueID
fingerprint=4c:1a:6f:a1:5b:9e:58:45:f7:53:43:1f:51:0f:d8:45
key_file=/home/user/ocid1.user.oc1..exampleuniqueID.pem
tenancy=ocid1.tenancy.oc1..exampleuniqueID
region=us-ashburn-1

De forma predeterminada, el perfil DEFAULT se usa para todos los comandos de la CLI. Por ejemplo:

oci dts job create --compartment-id ocid.compartment.oc1..exampleuniqueID --bucket MyBucket --display-name MyDisplay --device-type appliance

En cambio, puede emitir cualquier comando de la CLI con la opción --profile para especificar un perfil de administrador de transferencia de datos diferente. Por ejemplo:

oci dts job create --compartment-id ocid.compartment.oc1..exampleuniqueID --bucket MyBucket --display-name MyDisplay --device-type appliance --profile MyProfile

Utilizando el archivo de configuración de ejemplo anterior, profile_name sería profile1.

Si ha creado dos archivos de configuración independientes, utilice el siguiente comando para especificar el archivo de configuración que se utilizará:

oci dts job create --compartment-id compartment_id --bucket bucket_name --display-name display_name --config 
                
                

Creación del archivo de configuración del usuario de carga de transferencia de datos

El archivo de configuración config_upload_user es para el usuario de carga de transferencia de datos, el usuario temporal de IAM que Oracle utiliza para cargar sus datos en su nombre. Cree este archivo de configuración con la siguiente estructura:

[DEFAULT]
user=<The OCID for the data transfer upload user>
fingerprint=<The fingerprint of the above user's public key>
key_file=<The _absolute_ path to the above user's private key file on the host machine>
tenancy=<The OCID for the tenancy that owns the data transfer job and bucket>
region=<The region where the transfer job and bucket should exist. Valid values are: 
supported regions>.

donde supported regions son las regiones que se muestran en Regiones soportadas.

Entradas del archivo de configuración

La siguiente tabla muestra las entradas básicas que se necesitan para cada archivo de configuración y dónde obtener la información para cada entrada.

Nota

El servicio Data Transfer no admite frases de contraseña en los archivos de claves tanto para el administrador de transferencia de datos como para el usuario de carga de transferencia de datos.

Entrada

Descripción y dónde obtener el valor

¿Necesario?

user

OCID del administrador de transferencia de datos o del usuario de carga de transferencia de datos, según el perfil que esté creando. Para obtener el valor, consulte Claves y OCID necesarios.

fingerprint

Huella del par de claves que se utiliza. Para obtener el valor, consulte Claves y OCID necesarios.

key_file

Ruta completa y nombre de archivo de la clave privada.

Importante: el par de claves debe estar en formato PEM. Para obtener instrucciones sobre la generación de un par de claves en formato PEM, consulte Claves y OCID necesarios.

tenancy

OCID de su arrendamiento. Para obtener el valor, consulte Claves y OCID necesarios.

region

Región de Oracle Cloud Infrastructure. Consulte Regiones y dominios de disponibilidad.

Consulte Regiones soportadas para conocer las regiones que soportan Data Transfer.

Puede verificar las credenciales de usuario de carga de transferencia de datos con el siguiente comando:

oci dts job verify-upload-user-credentials --bucket bucket_name

Solicitud del dispositivo de importación

En esta sección se describe cómo solicitar un dispositivo de importación de Oracle para copiar los datos en Oracle Cloud Infrastructure. Consulte Dispositivos de importación para obtener información completa sobre todas las tareas relacionadas con los trabajos de transferencia.

Los clientes de Oracle Cloud Infrastructure pueden utilizar dispositivos de importación para migrar datos de forma gratuita. Solo se le cobrará el uso de Object Storage cuando los datos se hayan transferido correctamente al cubo designado. Todas las solicitudes de dispositivos requieren aprobación de Oracle.

Consejo

Para ahorrar tiempo, identifique los datos que desea cargar y realice preparaciones de copia de datos antes de solicitar el dispositivo de importación.

La creación de una solicitud del dispositivo devuelve una etiqueta de dispositivo asignada por Oracle. Por ejemplo:

XA8XM27EVH
Para solicitar un dispositivo mediante la consola
  1. Abra el menú de navegación y haga clic en Migración. En Data Transfer, haga clic en Importaciones.

    Seleccione el trabajo de transferencia para el que desea solicitar un dispositivo de importación.

  2. Haga clic en Solicitar dispositivo de transferencia en Dispositivos de transferencia.

    Aparece el cuadro de diálogo Solicitar dispositivo de transferencia.

  3. Proporcione los detalles de la dirección de envío a la que desea enviar el dispositivo de importación.

    • Nombre de la compañía:: obligatorio. Especifique el nombre de la compañía que posee los datos que se van a migrar a Oracle Cloud Infrastructure.

    • Nombre del destinatario:: obligatorio. Especifique el nombre del destinatario del dispositivo de importación.

    • Número de teléfono de destinatario:: obligatorio. Especifique el número de teléfono del destinatario.

    • Dirección de correo electrónico del destinatario:: obligatorio. Especifique la dirección de correo electrónico del destinatario.

    • A cargo de: parte intermediaria opcional responsable de transferir el envío del dispositivo de importación del proveedor de entrega al destinatario deseado.

    • Línea de dirección 1: obligatorio. Especifique el domicilio al que se envía el dispositivo de importación.

    • Línea de dirección 2: detalles identificativos de la dirección opcionales como información sobre edificio, oficina, unidad o planta.

    • Ciudad/localidad:: obligatorio. Especifique la ciudad o localidad.

    • Estado/Provincia/Región:: obligatorio. Especifique el estado, la provincia o la región.

    • Código postal:: especifique el código postal.

    • País:: obligatorio. Seleccione el país.

    • Capacidad mínima de almacenamiento: seleccione la capacidad mínima de almacenamiento del dispositivo (cuando hay más de una opción) que satisfaga sus necesidades. Los importes mostrados pueden variar según la región. Consulte Appliancepecificaciones para obtener más información. Después de enviar su solicitud, un representante de Oracle trabajará con usted para obtener el dispositivo que mejor se adapte a sus necesidades.

  4. Haga clic en Solicitar dispositivo de transferencia.
Para solicitar un dispositivo mediante la CLI

Utilice el comando oci dts Appliance request y los parámetros necesarios para solicitar un dispositivo de importación.

oci dts appliance request --job-id job_id --addressee addressee --care-of care_of --address1 address_line1 --city-or-locality city_or_locality --state-province-region state_province_region --country country --zip-postal-code zip_postal_code --phone-number phone_number --email email [OPTIONS]

Para obtener una lista completa de indicadores y opciones de variables para los comandos de la CLI, consulte Referencia de la línea de comandos.

Por ejemplo:

oci dts appliance request --job-id ocid1.datatransferjob.oc1..exampleuniqueID --addressee MyCompany --care-of "John Doe" --address1 "123 Main Street" --city-or-locality Anytown --state-province-region NY --country USA --zip-postal-code 12345 --phone-number 8005551212 --email john.doe@mycompany.com
				
{
  "data": {
    "appliance-delivery-tracking-number": null,
    "appliance-delivery-vendor": null,
    "appliance-return-delivery-tracking-number": null,
    "creation-time": "2020-05-20T22:08:13+00:00",
    "customer-received-time": null,
    "customer-returned-time": null,
    "customer-shipping-address": {
      "address1": "123 Main Street",
      "address2": null,
      "address3": null,
      "address4": null,
      "addressee": "MyCompany",
      "care-of": "John Doe",
      "city-or-locality": "Anytown",
      "country": "USA",
      "email": "john.doe@mycompany.com",
      "phone-number": "3115551212",
      "state-or-region": "NY",
      "zipcode": "12345"
    },
    "delivery-security-tie-id": null,
    "label": "XAKWEGKZ5T",
    "lifecycle-state": "REQUESTED",
    "next-billing-time": null,
    "return-security-tie-id": null,
    "serial-number": null,
    "transfer-job-id": "ocid1.datatransferjob.oc1..exampleuniqueID",
    "upload-status-log-uri": "JAKQVAGJF/XAKWEGKZ5T/upload_summary.txt"
  }
}

Cuando envía una solicitud de dispositivo, Oracle genera una etiqueta única (label": "XAKWEGKZ5T) para identificar el dispositivo de importación y su solicitud se envía a Oracle para su aprobación y procesamiento.

Configuración de notificaciones de solicitudes de dispositivo de importación desde la CLI

Puede generar notificaciones que envíen mensajes sobre los cambios en la solicitud del dispositivo de importación mediante el comando setup-notifications a través de la CLI. Al ejecutar este comando se crea un tema, una suscripción a la lista de direcciones de correo electrónico y también una regla que le envía notificaciones sobre todos los eventos relacionados con las actividades de la solicitud de dispositivo de importación y los cambios en el estado. Este método proporciona una forma más práctica de generar notificaciones adaptadas a las solicitudes de dispositivo de importación.

Al ejecutar el comando de la CLI se le solicita que introduzca las direcciones de correo electrónico de cada suscriptor de notificación como una lista separada por comas. A cada destinatario se le envía un correo electrónico con un enlace para confirmar que desea recibir las notificaciones.

Nota

La configuración de notificaciones desde la CLI afecta a todos los dispositivos de importación de su arrendamiento. No puede especificar notificaciones para los distintos dispositivos.

Configuración de notificaciones para una nueva solicitud de dispositivo de importación

Para incluir notificaciones de trabajo al solicitar un dispositivo de importación, incluya la opción --setup-notifications en la CLI:

oci dts appliance request --job-id job_id --addressee addressee --address1 address_line1 --city-or-locality city_or_locality --state-or-region state_or_region --country country --zip-code zip ... --setup-notifications

Configuración de notificaciones para una solicitud de dispositivo de importación existente

Para configurar notificaciones para una solicitud de dispositivo de importación existente, ejecute la CLI de appliance setup-notifications en el dispositivo:

oci dts appliance setup-notifications --appliance-label appliance_label

Notificación al administrador de datos

Cuando haya completado todas las tareas de este tema, proporcione al administrador de datos la siguiente información:

  • Credenciales de conexión de IAM

  • Archivos de configuración de la CLI de Oracle Cloud Infrastructure

  • ID del trabajo de transferencia

  • Etiqueta del dispositivo