Registro del controlador de almacenamiento

Editar en línea

Las API de registro del controlador de almacenamiento proporcionan la posibilidad de especificar los controladores de almacenamiento que debe gestionar el sistema de gestión de PowerVC . Las prestaciones incluyen añadir un nuevo controlador de almacenamiento, eliminar controladores de almacenamiento, actualizar la información de registro para los controladores de almacenamiento existentes o recuperar información sobre los controladores de almacenamiento que se están gestionando actualmente. También se puede utilizar esta API para registrar un almacenamiento conectable.

Opciones de la API de registro del controlador de almacenamiento

Tabla 1. Opciones de la API de registro del controlador de almacenamiento
Método	URI	Descripción
POST	`/v3/{tenant_id}/os-hosts`	Registra o añade un controlador de almacenamiento.
DELETE	`/v3/{tenant_id}/os-hosts/{host_name}`	Anula el registro o elimina un controlador de almacenamiento gestionado.
PUT	`/v3/{tenant_id}/os-hosts/{host_name}`	Actualiza o edita un controlador de almacenamiento gestionado. Registra un almacenamiento secundario para Global Mirror para un proveedor de almacenamiento primario. Nota: Solo para IBM® Storwize ®. Ejemplo: `PUT https://<PowerVC IP>/powervc/openstack/volume/v3/<tenant ID>/os-hosts/<Primary storage name>`
GET	`/v3/{tenant_id}/os-hosts`	Muestra todos los controladores de almacenamiento que se gestionan.
GET	`/v3/{tenant_id}/os-hosts/{host_name}`	Muestra detalles de un controlador de almacenamiento gestionado.
POST	`/v3/{tenant_id}/os-hosts/connect`	Lista las agrupaciones de volúmenes disponibles en un controlador de almacenamiento.¹
POST	`/v3/{tenant_id}/os-hosts/connect`	Cuando Storwize está registrado con HyperSwap® habilitado, la API de `connect` muestra detalles de las agrupaciones de iguales y con capacidad para HyperSwap .
POST	`/v3/{tenant_id}/os-hosts/`	Habilita HyperSwap al registrar Storwize en PowerVC.
PUT	`/v3/{tenant_id}/os-hosts/{host_name}`	Habilita HyperSwap después de registrar Storwize en PowerVC.
POST	`/v3/<tenant_id>/storage-providers/<provider_id>/host-site-assignment`	Correlaciona los WWPN de puerto de host con la información del sitio de Storwize.
GET	`/v3/<tenant_id>/storage-providers/<provider_id>/host-site-assignment`	Muestra detalles de correlación entre los WWPN de puerto de host y los sitios de Storwize.
1: No soporta almacenamientos conectables.

Registrar o añadir un controlador de almacenamiento

Esta operación registra o añade el controlador de almacenamiento a la lista gestionada por PowerVC. Esta API toma la dirección IP y las credenciales para el controlador de almacenamiento en el cuerpo de solicitud y registra el controlador de almacenamiento con PowerVC.

Códigos de respuesta

Código de respuesta normal: OK (200)
Códigos de respuesta de error: Solicitud incorrecta (400), Error de servidor (500)

Parámetros de la petición

Tabla 2. Parámetros utilizados en las peticiones de registro de controlador de almacenamiento
Nombre	Estilo	Tipo	Descripción
`access_ip`²	cuerpo	serie	Dirección IP o el nombre de host para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`fc_ports`³	cuerpo	lista de series	Los nombres de puerto de destino del sistema de almacenamiento Hitachi a especificar en la plantilla de almacenamiento Hitachi. Cuando se despliega un volumen Hitachi con la plantilla de almacenamiento predeterminada, PowerVC utiliza estos puertos para correlacionar volúmenes con una máquina virtual. Algunas plataformas Hitachi pueden tener hasta 192 puertos de canal de fibra. Es posible que PowerVC no siempre asigne todos los puertos. Ejemplo: [CL4-B, CL4-C, CL8-A, CL8-B, CL9-A, CL9-B].
`hitachi_ldev_end`³	cuerpo	entero	El final del rango de dispositivos de sistema de almacenamiento Hitachi asignados al uso de PowerVC . El rango predeterminado de 0 a 65535 está permitido si una única instancia de gestión de PowerVC es el único usuario del controlador Hitachi. De lo contrario, especifique un rango de dispositivos que no estén en uso por otros sistemas.
`hitachi_ldev_start³`	cuerpo	entero	El inicio del rango de dispositivos de sistema de almacenamiento Hitachi asignados al uso de PowerVC . El rango predeterminado de 0 a 65535 está permitido si una única instancia de gestión de PowerVC es el único usuario del controlador Hitachi. De lo contrario, especifique un rango de dispositivos que no estén en uso por otros sistemas.
`user_id`²	cuerpo	serie	ID de usuario para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`password`²	cuerpo	serie	Condicional. La contraseña para conectarse al controlador de almacenamiento. Debe especificarse `password` o `private_key_data`. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`private_key_data`²	cuerpo	serie	Condicional. La clave privada SSH para conectarse al controlador de almacenamiento. Este atributo sólo es válido para el almacenamiento SVC y IBM Storwize v7000 .
`volume_backend_name`²	cuerpo	serie	El nombre del dispositivo de almacenamiento de reserva.
`volume_pool_name`²	cuerpo	serie	La agrupación de almacenamiento predeterminada.
`default_volume_type`²	cuerpo	serie	Opcional. Nombre de la plantilla de almacenamiento que se crea como valor predeterminado para el controlador de almacenamiento.
`ssh_port`²	cuerpo	entero	Opcional. El puerto TCP para conectarse a SSH en el controlador de almacenamiento.
`wbem_port`²	cuerpo	entero	Opcional - Solo EMC PowerMax. Puerto TCP para conectarse al proveedor EMC SMI-S para el almacenamiento EMC PowerMax. El valor predeterminado es 5989.
`storage_array_id`	cuerpo	serie	Necesario para el almacenamiento EMC PowerMax. Identificador de la matriz de almacenamiento de EMC PowerMax. Este valor puede determinarse invocando la API `/os-hosts/connect`.
`host_type`	cuerpo	serie	El tipo de sistema de almacenamiento que se va a configurar. Sólo se da soporte a estos valores: `svc`, ds8k , `emc_vmax`, `hitachi`o `generic` (solo almacenamiento conectable).
`host_display_name`	cuerpo	serie	El nombre especificado por el usuario que se otorga al controlador de almacenamiento. El valor predeterminado es el nombre abreviado del host resuelto.
`volume_driver`¹	cuerpo	serie	Nombre de la clase Python del controlador del volumen Cinder del proveedor.
`configuration_properties`¹	cuerpo	objeto	Propiedades específicas del controlador del archivo de configuración como, por ejemplo, el ID de usuario y la contraseña.
`auto_add_host_key`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir la huella dactilar SSH para el sistema (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar la huella dactilar SSH. El valor predeterminado es `True`. Nota: Este atributo sólo es para el almacenamiento SVC y Storwize v7000 .
`auto_add_certificate`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir el certificado X.509 (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar el certificado. El valor predeterminado es `True`. Nota: Este atributo sólo es para los tipos de almacenamiento EMC PowerMax y DS8000® .
Solo se utiliza en almacenamientos conectables. No se utiliza en almacenamientos conectables. Para especificar esta información, utilice `configuration_properties`. Solo es necesario cuando se utiliza almacenamiento Hitachi.

Ejemplo de registro de almacenamiento soportado de PowerVC :

{"host": { 
 "registration": {
  "host_display_name": "HDS", 
  "access_ip": "1.2.3.4", 
  "fc_ports": [
   "CL1-C",
   "Cl1-D"
  ],
   
  "hitachi_ldev_start": 2000,
  "host_type": "hitachi",
  
  
  "volume_pool_name": "PowerVC1",
  
  "user_id": "maintenance",
  "password": "passw0rd",
  "hitachi_ldev_end": 3000
  }
 }
}

Ejemplo de registro de almacenamiento conectable:

{"host": {
  "registration": { 
  "host_type": "generic", 
  "host_display_name": "My Provider 1", 
  "volume_driver": "cinder.volume.drivers.ibm.storwize_svc.StorwizeSVCDriver", 
  "configuration_properties": { 
   "san_login": "superuser", 
   "san_password": "passw0rd", 
   "san_ip": "192.168.1.9", 
   "storwize_svc_volpool_name" : 
   "powervc_npiv_pool"… 
   } 
  } 
 } 
}

Cuerpo de la respuesta

Tabla 3. Parámetros en la respuesta para el registro del controlador de almacenamiento
Nombre	Estilo	Tipo	Descripción
`access_ip`²	cuerpo	serie	Dirección IP o el nombre de host para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`user_id`²	cuerpo	serie	ID de usuario para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`volume_pool_name`²	cuerpo	serie	Nombre de la agrupación de almacenamiento que se utiliza de forma predeterminada para gestionar el almacenamiento.
`default_volume_type`	cuerpo	serie	Nombre de la plantilla de almacenamiento que se crea como valor predeterminado para el controlador de almacenamiento.
`ssh_port`²	cuerpo	entero	El puerto TCP que se utiliza para conectarse a SSH en el controlador de almacenamiento.
`wbem_port`²	cuerpo	entero	Opcional - Solo EMC PowerMax. Puerto TCP para conectarse al proveedor EMC SMI-S para el almacenamiento EMC PowerMax. El valor predeterminado es 5989.
`storage_array_id`	cuerpo	serie	Necesario para el almacenamiento EMC PowerMax. Identificador de la matriz de almacenamiento de EMC PowerMax. Este valor puede determinarse invocando la API `/os-hosts/connect`.
`host_type`	cuerpo	serie	El tipo de sistema de almacenamiento que se va a configurar. Sólo se da soporte a estos valores: `svc`, ds8k , `emc_vmax`, `hitachi`o `generic` (solo almacenamiento conectable).
`host_name`²	cuerpo	serie	Nombre exclusivo generado internamente para el controlador de almacenamiento registrado.
`host_display_name`	cuerpo	serie	Nombre especificado por el usuario que se proporciona al controlador de almacenamiento.
`volume_driver`¹	cuerpo	serie	Nombre de la clase Python del controlador del volumen Cinder del proveedor.
`registered_at`	cuerpo	serie	Fecha y hora en que se ha registrado el proveedor de almacenamiento con PowerVC.
`auto_add_host_key`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir la huella dactilar SSH para el sistema (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar la huella dactilar SSH. El valor predeterminado es `True`. Nota: Este atributo sólo es para el almacenamiento SVC y Storewize v7000 .
`auto_add_certificate`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir el certificado X.509 (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar el certificado. El valor predeterminado es `True`. Nota: Este atributo sólo es para los tipos de almacenamiento EMC PowerMax y DS8000 .
1: Solo se utiliza en almacenamientos conectables. 2: No se utiliza en almacenamientos conectables.

Respuesta de ejemplo al registrar el almacenamiento soportado de PowerVC :

{"host": { 
 "registration": { 
  "access_ip": "1.2.3.4",
  "user_id": "root",
  "volume_pool_name": "pool1",
  "host_type": "svc",
  "host_name": "myhostname", 
  "host_diplay_name": "My SVC 1",
  "ssh_port": 22, 
  "default_volume_type": "my dflt"
  }
 }
}

Respuesta de ejemplo cuando se registra un almacenamiento conectable:

{"host": {
 "registration": {
 "host_type": "generic",
 "host_display_name": "My Provider 1",
 "volume_driver": "cinder.volume.drivers.ibm.storwize_svc.StorwizeSVCDriver",
 "registered_at": "2013-10-19T16:06:53Z"
  } 
 } 
}

Anular el registro o eliminar un controlador de almacenamiento gestionado

Esta operación anula el registro o elimina un controlador de almacenamiento gestionado para que ya no esté gestionado por PowerVC. Esta API utiliza el nombre del controlador de almacenamiento en el URI como entrada y no utiliza ningún cuerpo de solicitud. La API no devuelve ningún cuerpo de respuesta.

Códigos de respuesta

Código de respuesta normal: Sin contenido (204)
Códigos de respuesta de error: Solicitud errónea (400), No encontrado (404), Error de servidor (500)

Actualización de un controlador de almacenamiento gestionado

Esta operación actualiza o edita la información de registro para un controlador de almacenamiento gestionado por PowerVC. Esta API utiliza el nombre del controlador de almacenamiento en el URI y los atributos que desea cambiar en el cuerpo como entrada. El cuerpo de respuesta contiene los atributos actualizados por la solicitud.

Códigos de respuesta

Código de respuesta normal: OK (200)
Códigos de respuesta de error: Solicitud errónea (400), No encontrado (404), Error de servidor (500)

Parámetros de la petición

Tabla 4. Parámetros en la solicitud para actualizar un controlador de almacenamiento
Nombre	Estilo	Tipo	Descripción
`access_ip`²	cuerpo	serie	Dirección IP o el nombre de host para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`user_id`²	cuerpo	serie	ID de usuario para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`password`²	cuerpo	serie	Condicional. La contraseña para conectarse al controlador de almacenamiento. Debe especificarse `password` o `private_key_data`. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`private_key_data`²	cuerpo	serie	Condicional. La clave privada SSH para conectarse al controlador de almacenamiento. Este atributo solo es válido para el almacenamiento SVC y Storwize v7000.
`volume_pool_name`²	cuerpo	serie	Nombre de la agrupación de almacenamiento que se va a utilizar de forma predeterminada para gestionar el almacenamiento.
`default_volume_type`²	cuerpo	serie	Opcional. Nombre de la plantilla de almacenamiento que se crea como valor predeterminado para el controlador de almacenamiento.
`ssh_port`²	cuerpo	entero	Opcional. El puerto TCP para conectarse a SSH en el controlador de almacenamiento.
`wbem_port`²	cuerpo	entero	Opcional - Solo EMC PowerMax. Puerto TCP para conectarse al proveedor EMC SMI-S para el almacenamiento EMC PowerMax. El valor predeterminado es 5989.
`storage_array_id`	cuerpo	serie	Necesario para el almacenamiento EMC PowerMax. Identificador de la matriz de almacenamiento de EMC PowerMax. Este valor puede determinarse invocando la API `/os-hosts/connect`.
`host_display_name`	cuerpo	serie	El nombre especificado por el usuario que se otorga al controlador de almacenamiento. El valor predeterminado es el nombre abreviado del host resuelto.
`configuration_properties`¹	cuerpo	objeto	Propiedades específicas del controlador del archivo de configuración como, por ejemplo, el ID de usuario y la contraseña.
`auto_add_host_key`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir la huella dactilar SSH para el sistema (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar la huella dactilar SSH. El valor predeterminado es `True`. Nota: Este atributo sólo es para el almacenamiento SVC y Storewize v7000 .
`auto_add_certificate`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir el certificado X.509 (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar el certificado. El valor predeterminado es `True`. Nota: Este atributo sólo es para los tipos de almacenamiento EMC Power Max y DS8000 .
`pvm_host_name`	cuerpo	serie	Opcional: sólo se aplica cuando el tipo de host de registro es ssp y cuando se conmuta el nodo de control a un host NovaLink . Para determinar el nombre de host, utilice la API nova GET /os-hosts. Puede especificar `pvm_host_name` o `hmc_uuids`.
`hmc_uuids`	cuerpo	lista de series	Opcional: solo se aplica cuando el tipo de host de registro es ssp. Esto muestra una lista de un uuid de HMC único, para la HMC que debería ser el proveedor nuevo de la API de gestión de la agrupación de almacenamiento compartido. Puede especificar `pvm_host_name` o `hmc_uuids`.
1: Solo se utiliza en almacenamientos conectables. 2: No se utiliza en almacenamientos conectables. Para especificar esta información, utilice `configuration_properties`.

Todos los atributos son opcionales en el cuerpo de solicitud. Ejemplo de actualización de almacenamiento soportado de PowerVC :

{"registration": { 
 "access_ip": "1.2.3.4",
 "user_id": "root", 
 "password": "mypassword",
 "private_key_data": "-----BEGIN RSA PRIVATE KEY-----\nMIIEogIBAAKCAQEAs...",
 "volume_pool_name": "pool1",
 "host_diplay_name": "My SVC 1", 
 "ssh_port": 22,
 "default_volume_type": "my dflt"
 }
}

Ejemplo de actualización de almacenamiento conectable:

{"registration": {
 "host_display_name": "My Provider 1",
 "configuration_properties": { "san_login": "superuser", "san_password": "passw0rd", … }
  } 
 } 
}

Cuerpo de la respuesta

Tabla 5. Parámetros en la respuesta para actualizar un controlador de almacenamiento
Nombre	Estilo	Tipo	Descripción
`access_ip`²	cuerpo	serie	Dirección IP o el nombre de host para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`user_id`²	cuerpo	serie	ID de usuario para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`volume_pool_name`²	cuerpo	serie	Nombre de la agrupación de almacenamiento que se utiliza de forma predeterminada para gestionar el almacenamiento.
`default_volume_type`²	cuerpo	serie	El nombre de la plantilla de almacenamiento que se utiliza para crear como valor predeterminado para el controlador de almacenamiento.
`ssh_port`²	cuerpo	entero	El puerto TCP que se utiliza para conectarse a SSH en el controlador de almacenamiento.
`wbem_port`²	cuerpo	entero	Opcional - Solo EMC PowerMax. Puerto TCP para conectarse al proveedor EMC SMI-S para el almacenamiento EMC PowerMax. El valor predeterminado es 5989.
`storage_array_id`	cuerpo	serie	Necesario para el almacenamiento EMC PowerMax. Identificador de la matriz de almacenamiento de EMC PowerMax. Este valor puede determinarse invocando la API `/os-hosts/connect`.
`host_display_name`	cuerpo	serie	Nombre especificado por el usuario que se proporciona al controlador de almacenamiento.
`auto_add_host_key`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir la huella dactilar SSH para el sistema (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar la huella dactilar SSH. El valor predeterminado es `True`. Nota: Este atributo sólo es para el almacenamiento SVC y Storewize v7000 .
`auto_add_certificate`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir el certificado X.509 (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar el certificado. El valor predeterminado es `True`. Nota: Este atributo sólo es para los tipos de almacenamiento EMC Power Max y DS8000 .
`pvm_host_name`	cuerpo	serie	Opcional: solo se aplica cuando el tipo de host de registro es ssp. Al conmutar el nodo de control a un host NovaLink . Para determinar el nombre de host, utilice la API nova GET /os-hosts. Se devolverá `pvm_host_name` o `hmc_uuids`.
`hmc_uuids`	cuerpo	serie	Opcional: solo se aplica cuando el tipo de host de registro es ssp. Esto muestra una lista de un uuid de HMC único, para la HMC que debería ser el proveedor nuevo de la API de gestión de la agrupación de almacenamiento compartido. Se devolverá `pvm_host_name` o `hmc_uuids`.
1: Solo se utiliza en almacenamientos conectables. 2: No se utiliza en almacenamientos conectables.

Respuesta de ejemplo al actualizar el almacenamiento soportado de PowerVC :

{"host": "myhostname",
 "registration": { 
  "access_ip": "1.2.3.4",
  "user_id": "root", 
  "volume_pool_name": "pool1",
  "host_diplay_name": "My SVC 1",
  "ssh_port": 22,
  "default_volume_type": "my dflt"
 }
}

Respuesta de ejemplo cuando se actualiza un almacenamiento conectable:

{"host": {
 "registration": {
 "host_display_name": "My Provider 1",
  } 
 } 
}

Registrar un almacenamiento secundario para Global Mirror para un proveedor de almacenamiento primario

Utilice esta operación para registrar un almacenamiento secundario para Global Mirror para un proveedor de almacenamiento primario en PowerVC. También puede añadir o gestionar detalles de GMCV secundarios utilizando la GUI de PowerVC . El cuerpo de respuesta contiene los atributos actualizados por la solicitud.

Códigos de respuesta

Código de respuesta normal: OK (200)
Códigos de respuesta de error: Solicitud errónea (400), No encontrado (404), Error de servidor (500)

Parámetros de la petición

Tabla 6. Parámetros en la solicitud para registrar un almacenamiento secundario
Nombre	Estilo	Tipo	Descripción
`mirror_private_key_data`	cuerpo	serie	Proporcione una clave privada SSH completa.
`mirror_private_key`	cuerpo	serie	Proporcione la vía de acceso a la clave privada SSH.
`enable_mirror`	cuerpo	Boolean	Habilita Global Mirror. Establezca la opción en `True` para habilitar la duplicación global.
`enable_gmcv`	cuerpo	Boolean	Habilita el volumen de cambios de Global Mirror. Establezca la opción en `True` para habilitar el volumen de cambios de Global Mirror.
`cycle_period_seconds`	cuerpo	entero	Indica el periodo de ciclo en segundos para GMCV. El valor debe ser un número (entero) dentro del rango de 60 a 86400. El valor por omisión es 300.
`source_child_pool_for_change_volumes`	cuerpo	serie	Opcional. Especifique la agrupación hija en el almacenamiento de origen donde se debe almacenar el volumen de cambio. Si no se especifica, tanto el volumen como el volumen de cambios residirán en la misma agrupación.
`target_child_pool_for_change_volumes`	cuerpo	serie	Opcional. Especifique la agrupación hija en el almacenamiento de destino donde se debe almacenar el volumen de cambio. Si no se especifica, tanto el volumen como el volumen de cambios residirán en la misma agrupación.
`mirror_access_ip`	cuerpo	serie	Proporcione la IP de almacenamiento de réplica (secundario).
`mirror_user_id`	cuerpo	serie	Parámetro para proporcionar el ID de usuario de almacenamiento de réplica.
`mirror_password`	cuerpo	serie	Parámetro para proporcionar la contraseña de almacenamiento de réplica.
`mirror_pool`	cuerpo	serie	Parámetro para proporcionar el nombre de la agrupación de almacenamiento de réplica

Todos los atributos son opcionales en el cuerpo de solicitud. Ejemplo de registro de almacenamiento secundario en PowerVC y habilitación de Global Mirror:

{
        "registration": {
        "enable_mirror": true,
        "mirror_private_key_data": "<full SSH private key">
        "mirror_access_ip": "<secondary storage IP>",
        "mirror_user_id": "<secondary storage user ID>",
        "mirror_password": "<secondary storage password>",
        "mirror_pool": "<secondary storage storage pool name>",
    }
}

Solicitud de ejemplo para registrar el volumen de cambios de Global Mirror .

{
        "registration": {
        "enable_mirror": true,
        "enable_gmcv": true,
        "cycle_period_seconds": 500,
        "mirror_access_ip": "9.114.23.121",
        "mirror_user_id": "superuser",
        "mirror_password": "Passw0rd",
        "mirror_pool": "Powervc",
        "source_child_pool_for_change_volumes": "PowerVC_Pool0_child",
        "target_child_pool_for_change_volumes": "Powervc_child"
    }
}

Cuerpo de la respuesta

Tabla 7. Parámetros en la respuesta para registrar un almacenamiento secundario
Nombre	Estilo	Tipo	Descripción
`enable_mirror`	cuerpo	Boolean	Habilita Global Mirror. Establezca la opción en `true` para habilitar la duplicación global.
`mirror_private_key_data`	cuerpo	serie	Proporciona una clave privada SSH completa.
`mirror_private_key`	cuerpo	serie	Proporciona la vía de acceso a la clave privada SSH.
`enable_gmcv`	cuerpo	Boolean	Habilita el volumen de cambios de Global Mirror. Establezca la opción en `True` para habilitar el volumen de cambios de Global Mirror.
`cycle_period_seconds`	cuerpo	entero	Indica el periodo de ciclo en segundos para GMCV. El valor debe ser un número (entero) dentro del rango de 60 a 86400. El valor por omisión es 300.
`source_child_pool_for_change_volumes`	cuerpo	serie	Opcional. Especifique la agrupación hija en el almacenamiento de origen donde se debe almacenar el volumen de cambio. Si no se especifica, tanto el volumen como el volumen de cambios residirán en la misma agrupación.
`target_child_pool_for_change_volumes`	cuerpo	serie	Opcional. Especifique la agrupación hija en el almacenamiento de destino donde se debe almacenar el volumen de cambio. Si no se especifica, tanto el volumen como el volumen de cambios residirán en la misma agrupación.
`mirror_access_ip`	cuerpo	serie	Proporcione la IP de almacenamiento de réplica (secundario).
`mirror_user_id`	cuerpo	serie	Parámetro para proporcionar el ID de usuario de almacenamiento de réplica.
`mirror_password`	cuerpo	serie	Parámetro para proporcionar la contraseña de almacenamiento de réplica.
`mirror_pool`	cuerpo	serie	Parámetro para proporcionar el nombre de la agrupación de almacenamiento de réplica
`replication_device`	cuerpo	serie	Parámetro con información sobre el ID de back-end del almacenamiento secundario, la IP del almacenamiento secundario, el ID de usuario del almacenamiento secundario, la contraseña cifrada del almacenamiento secundario y el nombre de la agrupación de almacenamiento secundario.

Respuesta de ejemplo al registrar almacenamiento secundario en PowerVC para Global Mirror:

{
    "host": "<primary storage host name>",
    "registration": {
        "enable_mirror": true,
        "mirror_private_key_data": "<full SSH private key">
        "mirror_access_ip": "<secondary storage IP>",
        "mirror_user_id": "secondary storage user ID",
        "mirror_password": "secondary storage password",
        "mirror_pool": "secondary storage storage pool",
        "replication_device": "backend_id:<backend_id of secondary storage>,san_ip:<secondary storage IP>,san_login:<secondary storage user ID>,san_password:<encrypted password for secondary storage>,pool_name:secondary storage pool name"
    }
}

Respuesta de ejemplo para registrar el volumen de cambios de Global Mirror .

{
    "host": "ip9_114_23_117",
    "registration": {
        "enable_mirror": true,
        "enable_gmcv": true,
        "cycle_period_seconds": 500,
        "mirror_access_ip": "9.114.23.121",
        "mirror_user_id": "superuser",
        "mirror_password": "Passw0rd",
        "mirror_pool": "Powervc",
        "source_child_pool_for_change_volumes": "PowerVC_Pool0_child",
        "target_child_pool_for_change_volumes": "Powervc_child",
        "replication_device": "backend_id:00000100204026B4,san_ip:9.114.23.121,san_login:superuser,san_password:aes-ctr:Njc1ODgyNzQ5Nzc2MTA4OTk4NjrOhJ7eJ4UvMqVB1Ws=,pool_name:Powervc"
    }
}

Ver todos los controladores de almacenamiento que se gestionan

Esta operación lista información básica sobre todos los controladores de almacenamiento gestionados por PowerVC. Esta API no utiliza ninguna entrada del cuerpo de solicitud, y devuelve el nombre y el nombre de visualización de cada uno de los controladores de almacenamiento que se gestionan en el cuerpo de respuesta.

Códigos de respuesta

Código de respuesta normal: OK (200)
Códigos de respuesta de error: Error de servidor (500)

Cuerpo de la respuesta

Tabla 8. Parámetros en la respuesta para ver todos los controladores de almacenamiento
Nombre	Estilo	Tipo	Descripción
`host_name`	cuerpo	serie	Nombre exclusivo generado internamente para el controlador de almacenamiento registrado.

{"hosts": [ 
  {"host_name": "myhostname1", "service": "cinder-volume", "zone": "nova"}, 
  {"host_name": "myhostname2", "service": "cinder-volume", "zone": "nova"}, ]
}

Ver detalles de un controlador de almacenamiento gestionado

Esta operación muestra información detallada sobre uno de los controladores de almacenamiento gestionados por PowerVC. Esta API utiliza el nombre del controlador de almacenamiento en el URI como entrada y utiliza el cuerpo de solicitud. La API devuelve la dirección IP y la información de credenciales sobre el controlador de almacenamiento en el cuerpo de respuesta.

Códigos de respuesta

Código de respuesta normal: OK (200)
Códigos de respuesta de error: No encontrado (404), Error de servidor (500)

Cuerpo de la respuesta

Tabla 9. Parámetros en la respuesta para ver un controlador de almacenamiento
Nombre	Estilo	Tipo	Descripción
`access_ip`²	cuerpo	serie	Dirección IP o el nombre de host para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`user_id`²	cuerpo	serie	ID de usuario para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`volume_pool_name`²	cuerpo	serie	Nombre de la agrupación de almacenamiento que se utiliza de forma predeterminada para gestionar el almacenamiento.
`default_volume_type`²	cuerpo	serie	Nombre de la plantilla de almacenamiento que se crea como valor predeterminado para el controlador de almacenamiento.
`ssh_port`²	cuerpo	entero	Puerto TCP que se utiliza para conectarse a SSH en el controlador de almacenamiento.
`wbem_port`²	cuerpo	entero	Opcional - Solo EMC PowerMax. Puerto TCP para conectarse al proveedor EMC SMI-S para el almacenamiento EMC PowerMax. El valor predeterminado es 5989.
`storage_array_id`	cuerpo	serie	Necesario para el almacenamiento EMC PowerMax. Identificador de la matriz de almacenamiento de EMC PowerMax. Este valor puede determinarse invocando la API `/os-hosts/connect`.
`host_type`	cuerpo	serie	El tipo de sistema de almacenamiento que se va a configurar. Sólo se da soporte a estos valores: `svc`, ds8k , `emc_vmax`, `hitachi`o `generic` (solo almacenamiento conectable).
`host_name`	cuerpo	serie	Nombre exclusivo generado internamente para el controlador de almacenamiento registrado.
`host_display_name`	cuerpo	serie	Nombre especificado por el usuario que se proporciona al controlador de almacenamiento.
`registered_at`	cuerpo	serie	Fecha y hora en que se ha registrado el controlador de almacenamiento en PowerVC.
`access_state`	cuerpo	serie	Muestra el estado de conectividad general con el controlador de almacenamiento y si PowerVC puede acceder a él.
`resource`	cuerpo	objeto	Información de capacidad de recursos del controlador de almacenamiento.
`volume_driver`¹	cuerpo	serie	Nombre de la clase Python del controlador del volumen Cinder del proveedor.
1: Solo se utiliza en almacenamientos conectables. 2: No se utiliza en almacenamientos conectables. Para especificar esta información, utilice `configuration_properties`.

Ejemplo de visualización de los detalles de un controlador de almacenamiento soportado de PowerVC :

{"host": { "resource": { "project": "(total)", "host": "host1", "volume_count": 16, 
 "total_capacity_gb": "1570", "free_capcity_gb": "117", "total_volume_gb": "1420"
 }, 
 "registration": { 
  "host_name": "myhostname", 
  "host_diplay_name": "My SVC 1",
  "access_ip": "1.2.3.4", 
  "user_id": "root",
  "ssh_port": 22,
  "volume_pool_name": "pool1",
  "default_volume_type", "my dflt",
  "host_type": "svc",
  "registered_at": "2013-06-18T13:24:21Z",
  "access_state": "ok"
  }
 }
}

Ejemplo de visualización de los detalles de un controlador de almacenamiento conectable:

{"host": {
 "registration": {
 "host_type": "generic",
 "host_display_name": "My Provider 1",
 "volume_driver": "cinder.volume.drivers.ibm.storwize_svc.StorwizeSVCDriver",
 "registered_at": "2013-10-19T16:06:53Z"
  } 
 } 
}

Ver las agrupaciones de volúmenes disponibles en un controlador de almacenamiento

Esta operación utiliza la dirección IP y las credenciales especificadas para verificar la conexión con el controlador de almacenamiento, y luego devuelve una lista de agrupaciones de almacenamiento que pueden utilizarse cuando se registra este controlador de almacenamiento. No se puede utilizar con un almacenamiento conectable.

Códigos de respuesta

Código de respuesta normal: OK (200)
Códigos de respuesta de error: Solicitud incorrecta (400), Error de servidor (500)

Parámetros de la petición

Tabla 10. Parámetros en la solicitud para ver las agrupaciones de volúmenes que están disponibles en un controlador de almacenamiento
Nombre	Estilo	Tipo	Descripción
`access_ip`	cuerpo	serie	Dirección IP o el nombre de host para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`user_id`	cuerpo	serie	ID de usuario para conectarse al controlador de almacenamiento. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`password`	cuerpo	serie	Condicional. La contraseña para conectarse al controlador de almacenamiento. Debe especificarse `password` o `private_key_data`. Si se utiliza el almacenamiento EMC PowerMax, este valor se aplica al proveedor EMC SMI-S.
`private_key_data`	cuerpo	serie	Condicional. La clave privada SSH para conectarse al controlador de almacenamiento. Este atributo solo es válido para el almacenamiento SVC y Storwize v7000.
`ssh_port`	cuerpo	entero	Opcional. El puerto TCP para conectarse a SSH en el controlador de almacenamiento.
`wbem_port`²	cuerpo	entero	Opcional - Solo EMC PowerMax. Puerto TCP para conectarse al proveedor EMC SMI-S para el almacenamiento EMC PowerMax. El valor predeterminado es 5989.
`storage_array_id`	cuerpo	serie	Necesario para el almacenamiento EMC PowerMax. Identificador de la matriz de almacenamiento de EMC PowerMax. Este valor puede determinarse invocando la API `/os-hosts/connect`.
`host_type`	cuerpo	serie	El tipo de sistema de almacenamiento que se va a configurar. Sólo se da soporte a estos valores: `svc`, ds8k , `emc_vmax`, `hitachi`o `generic` (solo almacenamiento conectable).
`auto_add_host_key`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir la huella dactilar SSH para el sistema (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar la huella dactilar SSH. El valor predeterminado es `True`. Nota: Este atributo sólo es para el almacenamiento SVC y Storewize v7000 .
`auto_add_certificate`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir el certificado X.509 (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar el certificado. El valor predeterminado es `True`. Nota: Este atributo sólo es para los tipos de almacenamiento EMC Power Max y DS8000 .

Ejemplo de una solicitud para ver las agrupaciones de volúmenes que están disponibles en un controlador de almacenamiento (PowerVC almacenamiento soportado):

{"host": { 
 "registration": { 
  "access_ip": "1.2.3.4",
  "user_id": "root",
  "password": "mypassword",
  "private_key_data": "-----BEGIN RSA PRIVATE KEY-----\nMIIEogIBAAKCAQEAs...", 
  "host_type": "svc",
  "ssh_port": 22
  }
 }
}

Cuerpo de la respuesta

Tabla 11. Parámetros en la respuesta para ver las agrupaciones de volúmenes que están disponibles en un controlador de almacenamiento
Nombre	Estilo	Tipo	Descripción
`pool_name`	cuerpo	serie	El nombre de la agrupación de almacenamiento en el controlador de almacenamiento.
`pool_free_capacity_gb`	cuerpo	serie	El espacio libre en la agrupación de almacenamiento en GB.
`pool_total_capacity_gb`	cuerpo	serie	La capacidad total en la agrupación de almacenamiento en GB.
`auto_add_host_key`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir la huella dactilar SSH para el sistema (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar la huella dactilar SSH. El valor predeterminado es `True`. Nota: Este atributo sólo es para el almacenamiento SVC y Storewize v7000 .
`auto_add_certificate`	cuerpo	Boolean	Valor opcional. Si se debe aceptar automáticamente o añadir el certificado X.509 (si la huella dactilar todavía no es de confianza o es distinta de la huella dactilar de confianza anterior) o fallar con un código de respuesta 403 para que se pueda verificar el certificado. El valor predeterminado es `True`. Nota: Este atributo sólo es para los tipos de almacenamiento EMC Power Max y DS8000 .

Ejemplo de respuesta al visualizar agrupaciones de volúmenes que están disponibles en un controlador de almacenamiento soportado de PowerVC :

{"host": { 
  "volumePools": [ {
   "pool_name": "pool1",
   "pool_free_capacity_gb": "8810.0", // Free Space in the Storage Pool in GB 
   "pool_total_capacity_gb": "9010.0" // Total Capacity in the Storage Pool in GB 
  }, 
  {
   "pool_name": "pool2", .......
  }
 }
}

Registrar y habilitar el almacenamiento HyperSwap para IBM Storwize

El registro de almacenamiento de HyperSwap utiliza la API de registro de almacenamiento existente. A continuación se muestran los nuevos atributos necesarios para registrar el controlador de almacenamiento HyperSwap .

Códigos de respuesta

Código de respuesta normal: OK (200)
Códigos de respuesta de error: Solicitud incorrecta (400) y Error de servidor (500)

Parámetros de solicitud y respuesta

Tabla 12. Parámetros en la solicitud y respuesta para el registro de HyperSwap
Nombre	Estilo	Tipo	Descripción
`hyperswap_capable`	cuerpo	Boolean	Si `hyperswap_capable` se establece en `true`, muestra que el controlador IBM Storwize se ha configurado con el requisito previo para la configuración de HyperSwap .
`enable_hyperswap`	cuerpo	Boolean	Establezca esta propiedad en `true` en el cuerpo de solicitud de API para habilitar HyperSwap.
`peerPools`	cuerpo	objeto	Respuesta en `os-hosts`/`connect` que muestra los detalles de la correlación de agrupación de iguales.
`peer_pool_name`	cuerpo	serie	Nombre de la agrupación en otra ubicación.
`site_id`	cuerpo	serie	ID de sitio del sitio de Storwize.
`site_name`	cuerpo	serie	Nombre del sitio de Storwize.

Ejemplos

A continuación se muestran los ejemplos de la API de registro para el registro de HyperSwap .

Conectar con el controlador de almacenamiento HyperSwap

Cuerpo de solicitud

{
    "host": {
        "registration": {
            "host_type": "svc",
            "access_ip": "9.x.x.x",
            "user_id": "superuser",
            "auto_add_host_key": true,
            "password": "password",
            "host_display_name": "SVC_188"
        }
    }
}

Cuerpo de la respuesta

{
  "host": {
    "hyperswap_capable": true,
    "volumePools": [{
      "pool_name": "mdiskgrp0",
      "pool_total_capacity_gb": 22340.0,
      "pool_free_capacity_gb": 5329.0,
      "site_id": "1",
      "site_name": "site1"
    }, {
      "pool_name": "Pool1",
      "pool_total_capacity_gb": 15576.0,
      "pool_free_capacity_gb": 13649.0,
      "site_id": "2",
      "site_name": "site2"
    }],
    "peerPools": {
      "mdiskgrp0": ["Pool1"],
      "Pool1": ["mdiskgrp0"]
    }
  }
}

Habilitar HyperSwap durante la adición de la API de almacenamiento

Cuerpo de solicitud

{
    "host": {
        "registration": {
            "host_type": "svc",
            "access_ip": "9.x.x.x",
            "user_id": "superuser",
            "auto_add_host_key": true,
            "password": "passw0rd",
            "volume_pool_name": "mdiskgrp0",
            "host_display_name": "SVC_188",
            "host_name": "c340f9u05v7k",
            "peer_pool_name": "Pool1",
            "enable_hyperswap": true
        }
    }
}

Cuerpo de la respuesta

{
  "host": {
    "registration": {
      "host_type": "svc",
      "access_ip": "9.x.x.x",
      "user_id": "superuser",
      "auto_add_host_key": true,
      "volume_pool_name": "mdiskgrp0",
      "host_display_name": "SVC_188",
      "host_name": "c340f9u05v7k",
      "peer_pool_name": "Pool1",
      "enable_hyperswap": true,
      "pvc_cluster_service": true,
      "default_volume_type": "SVC_188 base template",
      "registered_at": "2021-07-23T10:04:14Z"
    }
  }
}

Actualizar el registro de almacenamiento existente para habilitar HyperSwap durante la adición de la API de almacenamiento

Cuerpo de solicitud

{
    "registration": {
        "access_ip": "9.x.x.x",
        "host_display_name": "svc-188",
        "auto_add_host_key": true,
        "auto_add_certificate": true,
        "volume_pool_name": "mdiskgrp0",
        "peer_pool_name": "Pool1",
        "enable_hyperswap": true
    }
}

Cuerpo de la respuesta

{
  "host": "c340f9u05v7k",
  "registration": {
    "access_ip": "9.x.x.x",
    "host_display_name": "svc-188",
    "auto_add_host_key": true,
    "auto_add_certificate": true,
    "volume_pool_name": "mdiskgrp0",
    "peer_pool_name": "Pool1",
    "enable_hyperswap": true
  }
}

Asignación de sitio de host

Esta API firma los WWPN de puerto físico de host de PowerVM® con la información del sitio de IBM Storwize HyperSwap . Puede seleccionar varios WWPN de puerto de host y asignar el ID de sitio en función de la vía de acceso preferida para optimizar la entrada/salida.

Códigos de respuesta

Código de respuesta normal: Created (201)
Códigos de respuesta de error: Solicitud incorrecta (400), Prohibido (403) y No encontrado (404)

Parámetros de la petición

Tabla 13. Parámetros en la solicitud para la asignación del sitio de host
Nombre	Estilo	Tipo	Descripción
`id`	cuerpo	entero	ID de sitio de Storwize.
`hosts`	cuerpo	lista de series	Lista de WWPN de puerto de host.

Ejemplo de cuerpo de solicitud

{
                "sites" : [
                    {
                        "id": 1,
                        "hosts": ["wwpn1", "wwpn2"]
                    },
                    {
                        "id": 2,
                        "hosts": ["wwpn3", "wwpn4"]
                    }
                ]
            }

Cuerpo de la respuesta

Tabla 14. Parámetros en la respuesta para la asignación del sitio de host
Nombre	Estilo	Tipo	Descripción
`site_name`	cuerpo	serie	Nombre de sitio del sitio de Storwize
`hosts`	cuerpo	lista de series	Lista de WWPN de puerto de host.

Respuesta de ejemplo

{
                "1": {
                        "site_name": "site1",
                        "hosts": ["wwpn1", "wwpn2"]
                     },
                "2": {
                         "site_name": "site2",
                         "hosts": ["wwpn3", "wwpn4"]
                     }
            }

Registrar un almacenamiento puro secundario o terciario para un proveedor de almacenamiento primario

Utilice esta operación para registrar un almacenamiento secundario o un almacenamiento terciario o ambos para Pure Storage para un proveedor de almacenamiento primario en PowerVC. El cuerpo de respuesta contiene los atributos actualizados por la solicitud

Códigos de respuesta

Código de respuesta normal: OK (200)
Códigos de respuesta de error: Solicitud incorrecta (400) y Error de servidor (500)
Parámetros de la petición

Registrar almacenamientos de tipo de réplica síncrona/asíncrona

Tabla 15. Detalles de almacenamiento secundario para almacenamiento síncrono/asíncrono
Nombre	Estilo	Tipo	Descripción
`enable_replication`	cuerpo	serie	Habilita la réplica. Establezca la opción en `sync/async` para habilitar los tipos de réplica respectivos.
`replication_type`	cuerpo	serie	Proporcione el tipo de réplica del almacenamiento. Los tipos de réplica pueden ser `sync/async`.
`access_ip`	cuerpo	serie	Parámetro para proporcionar la IP de almacenamiento secundario.
`user_id`	cuerpo	serie	Parámetro para proporcionar el ID de usuario de almacenamiento secundario.
`password`	cuerpo	serie	Parámetro para proporcionar una contraseña de almacenamiento secundario.

Ejemplo de registro de almacenamiento secundario en PowerVC y habilitación de la sincronización/réplica asíncrona.

Cuerpo de solicitud

{
	"registration": {
		"enable_replication": "sync/async",
		"secondary_storage": {
			"replication_type": "sync/async",
			"access_ip": "<secondary storage access IP>",
			"user_id": "<secondary storage user ID>",
			"password": "<secondary storage password>"
		}
       }
}

Solicitud para habilitar la réplica de sincronización.

{
  {
	"registration": {
		"enable_replication": "sync",
		"secondary_storage": {
			"replication_type": "sync",
			"access_ip": "9.3.250.136",
			"user_id": "pureuser",
			"password": "pureuser"
		}
	}
}

Solicitud para registrar la réplica asíncrona.

{
	"registration": {
		"enable_replication": "async",
		"secondary_storage": {
			"replication_type": "async",
			"access_ip": "9.3.250.136",
			"user_id": "pureuser",
			"password": "pureuser"
		}
	}
}

Cuerpo de respuesta para el registro síncrono/asíncrono

Tabla 16. Cuerpo de respuesta para el registro síncrono/asíncrono
Nombre	Estilo	Tipo	Descripción
`replication_type`	cuerpo	serie	Proporcione el tipo de réplica del almacenamiento secundario.
`access_ip`	cuerpo	serie	Proporcione la IP de almacenamiento secundario.
`user_id`	cuerpo	serie	Parámetro para proporcionar el ID de usuario de almacenamiento secundario.
`password`	cuerpo	serie	Parámetro para proporcionar una contraseña de almacenamiento secundario.
`replication_device`	cuerpo	serie	Parámetro con información sobre el ID de programa de fondo del almacenamiento secundario, la IP de almacenamiento secundario, la señal de API de almacenamiento secundario y el tipo de réplica de almacenamiento secundario que está habilitado.

Respuesta al registrar la réplica síncrona/asíncrona.

{
	"host": "<primary storage host name>",
	"registration": {
		"enable_replication": "async/sync",
		"secondary_storage": {
			"replication_type": "async/sync",
			"access_ip": "<secondary storage IP>",
			"user_id": "<secondary storage user ID>",
			"password": "<secondary storage password>"
		},
		"replication_device": "backend_id:<backend_id of the secondary storage>,san_ip: <secondary storage IP>,api_token:<secondary storage API token>,type:<secondary storage replication type>"
	}
}

Respuesta de réplica de sincronización.


{
	"host": "pvc75",
	"registration": {
		"enable_replication": "sync",
		"secondary_storage": {
			"replication_type": "sync",
			"access_ip": "9.3.250.136",
			"user_id": "pureuser",
			"password": "pureuser"
		},
		"replication_device": "backend_id:pvc126,san_ip:9.3.250.136,api_token:b529b479-f7b6-aa55-d142-f5b11bf9f04b,type:sync"
	}
}

Respuesta de réplica asíncrona.

{
   "host": "pvc75",
   "registration":    {
      "enable_replication": "async",
      "secondary_storage": {
         "replication_type": "async",
         "access_ip": "9.3.250.136",
         "user_id": "pureuser",
         "password": "pureuser"
      },
      "replication_device": "backend_id:pvc126,san_ip:9.3.250.136,api_token:b529b479-f7b6-aa55-d142-f5b11bf9f04b,type:async"
   }
}

Registre el almacenamiento secundario y terciario y habilite la réplica de trisync.

Tabla 17. Detalles de almacenamiento secundario y terciario para el registro de trisync
Nombre	Estilo	Tipo	Descripción
`enable_replication`	cuerpo	serie	Habilita la réplica. Establezca la opción en `trisync` para habilitar la réplica en almacenamientos secundarios y terciarios.
`replication_type`	cuerpo	serie	Proporcione el tipo de réplica de los almacenamientos secundarios y terciarios. Los tipos de réplica pueden ser sync/async. El tipo de réplica de almacenamiento secundario debe ser `sync` y el tipo de réplica de almacenamiento terciario debe ser `async`.
`access_ip`	cuerpo	serie	Proporcione la IP de almacenamiento secundario y terciario.
`user_id`	cuerpo	serie	Parámetro para proporcionar el ID de usuario de almacenamiento secundario y terciario.
`password`	cuerpo	serie	Parámetro para proporcionar contraseña de almacenamiento secundario y terciario.

Ejemplo de registro de almacenamiento secundario y terciario en PowerVC y habilitación de la réplica de trisync.

Cuerpo de solicitud

{
	"registration": {
		"enable_replication": "trisync",
		"secondary_storage": {
			"replication_type": "sync",
			"access_ip": "<secondary storage IP>",
			"user_id": "<secondary storage user ID>",
			"password": "<secondary storage password>"
		},
		"tertiary_storage": {
			"replication_type": "async",
			"access_ip": "< tertiary storage IP>",
			"user_id": "< tertiary storage user ID>",
			"password": "< tertiary storage password>"
		}
	}
}

Cuerpo de respuesta para el registro de trisync

Tabla 18. Cuerpo de respuesta para el registro de trisync
Nombre	Estilo	Tipo	Descripción
`replication_type`	cuerpo	serie	Proporcione el tipo de réplica del almacenamiento secundario y terciario.
`access_ip`	cuerpo	serie	Proporcione la IP de almacenamiento secundario y terciario.
`user_id`	cuerpo	serie	Parámetro para proporcionar el ID de usuario de almacenamiento secundario y terciario.
`password`	cuerpo	serie	Parámetro para proporcionar contraseña de almacenamiento secundario y terciario.
`pure_trisync_enabled`	cuerpo	Boolean	Habilita trisync. La opción se establece como `true` si `trisync` está habilitado.
`replication_device`	cuerpo	list de	Lista de dos parámetros de dispositivo de réplica. Información sobre el ID de programa de fondo del almacenamiento secundario, la IP de almacenamiento secundario, la señal de API de almacenamiento secundario y el tipo de réplica de almacenamiento secundario que está habilitado en el primero. Información sobre el ID de programa de fondo del almacenamiento terciario, la IP de almacenamiento terciario, la señal de API de almacenamiento terciario y el tipo de réplica de almacenamiento terciario que está habilitado en el segundo.

Cuerpo de la respuesta

{
	"host": "pvc75",
	"registration": {
		"enable_replication": "trisync",
		"secondary_storage": {
			"replication_type": "sync",
			"access_ip": "<secondary storage IP>",
			"user_id": "<secondary storage user ID>",
			"password": "<secondary storage password>"
		},
		"tertiary_storage": {
			"replication_type": "async",
			"access_ip": "< tertiary storage IP>",
			"user_id": "< tertiary storage user ID>",
			"password": "< tertiary storage password>"
		},
              "pure_trisync_enabled": True,
		"replication_device": [
			" backend_id:<backend_id of the secondary storage>,san_ip: <secondary storage IP>,api_token:<secondary storage API token>,type:<secondary storage replication type>",
			" backend_id:<backend_id of the tertiary storage>,san_ip: <tertiary storage IP>,api_token:<tertiary storage API token>,type:<tertiary storage replication type>"
		]
	}
}

Ejemplo

{
	"host": "pvc75",
	"registration": {
		"enable_replication": "trisync",
		"secondary_storage": {
			"replication_type": "sync",
			"access_ip": "9.3.250.136",
			"user_id": "pureuser"
		},
		"tertiary_storage": {
			"replication_type": "async",
			"access_ip": "9.3.250.136",
			"user_id": "pureuser"
		},
		"pure_trisync_enabled": True,
		"replication_device": [
			"backend_id:pvc126,san_ip:9.3.250.136,api_token:b529b479-f7b6-aa55-d142-f5b11bf9f04b,type:sync,uniform:True",
			"backend_id:pvc126,san_ip:9.3.250.136,api_token:b529b479-f7b6-aa55-d142-f5b11bf9f04b,type:async"
		]
	}
}