Creación de una transferencia de disco

Función

Esta API se utiliza para crear una transferencia de disco. Una vez creada la transferencia, se devuelve un ID de transferencia y una clave de autenticación.

Después de crear una transferencia de disco, el estado del disco cambia de available a la awaiting-transfer. Una vez que se acepta la transferencia de disco, el estado del disco cambia a available de nuevo.

Restricciones

Una transferencia de disco sólo se puede crear cuando el estado del disco está available. Las restricciones detalladas son las siguientes:

• Los discos EVS encriptados no se pueden transferir.
• Los discos EVS con copias de respaldo e instantáneas disponibles no se pueden transferir.
• Los discos EVS asociados a las políticas de copia de respaldo no se pueden transferir.

Si la transferencia de disco se crea usando uno de los discos no soportados, se devolverá el código de error 400.

URI

• Formato URI

  POST /v2/{project_id}/os-volume-transfer

• Descripción del parámetro

  Parámetro	Obligatorio	Descripción
  project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.

Solicitud

• Descripción del parámetro

  Parámetro	Tipo	Obligatorio	Descripción
  transfer	Object	Sí	Especifica el marcador de transferencia de disco. Para obtener más información, consulte Parámetros en el campo de transferencia.

• Parámetros en el campo de transfer

  Parámetro	Tipo	Obligatorio	Descripción
  volume_id	String	Sí	Especifica el ID de disco.
  name	String	No	Especifica el nombre de la transferencia de disco.

• Solicitud de ejemplo

  {
      "transfer": {
          "volume_id": "c86b9af4-151d-4ead-b62c-5fb967af0e37", 
          "name": "first volume"
      }
  }

Respuesta

• Descripción del parámetro

  Parámetro	Tipo	Descripción
  transfer	Object	Especifica la información de transferencia de disco. Para obtener más información, consulte Parámetros en el campo de transferencia.

• Parámetros en el campo de transfer

  Parámetro	Tipo	Descripción
  auth_key	String	Especifica la clave de autenticación de la transferencia de disco.
  links	List< Dict >	Especifica los enlaces de la transferencia de disco.
  created_at	String	Especifica la hora a la que se creó la transferencia de disco.
  volume_id	String	Especifica el ID de disco.
  id	String	Especifica el ID de transferencia de disco.
  name	String	Especifica el nombre de la transferencia de disco.

• Ejemplo de respuesta

  {
      "transfer": {
          "id": "1a7059f5-8ed7-45b7-8d05-2811e5d09f24", 
          "created_at": "2015-02-25T03:56:53.081642", 
          "name": "first volume", 
          "volume_id": "c86b9af4-151d-4ead-b62c-5fb967af0e37", 
          "auth_key": "9266c59563c84664", 
          "links": [
              {
                  "href": "https://localhost/v2/firstproject/os-volume-transfer/3", 
                  "rel": "self"
              }, 
              {
                  "href": "https://localhost/firstproject/os-volume-transfer/3", 
                  "rel": "bookmark"
              }
          ]
      }
  }

Códigos de estado

• Normal

  202

Códigos de error

Para más detalles, consulte Códigos de error.