Criação de uma transferência de disco EVS
Função
Esta API é usada para criar uma transferência de disco EVS. Após a transferência ter sido criada, um ID de transferência e uma chave de autenticação são retornados. Depois que uma transferência de disco é criada, o status do disco muda de available para awaiting-transfer*. Uma vez que a transferência é aceita, o status do disco muda para available novamente.
Restrições
Uma transferência de disco pode ser criada somente quando o status do disco estiver available. As restrições detalhadas são as seguintes:
Discos anuais/mensais não podem ser transferidos. Discos congelados não podem ser transferidos. Discos criptografados não podem ser transferidos. Discos com backups e snapshots não podem ser transferidos. Discos aplicados com políticas de backup não podem ser transferidos. Discos DSS não podem ser transferidos. Discos DESS não podem ser transferidos.
Método de chamada
Para obter detalhes, consulte Chamada de APIs.
URI
POST /v2/{project_id}/os-volume-transfer
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
O ID do projeto. Para obter detalhes sobre como obter o ID de projeto, consulte Obtenção de um ID de projeto. |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
O token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
transfer |
Sim |
CreateVolumeTransferOption object |
O marcador de criação de transferência. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
name |
Sim |
String |
O nome da transferência. Você pode inserir até 64 caracteres. |
volume_id |
Sim |
String |
O ID do disco. Para obter o ID do disco, consulte Consulta de detalhes sobre todos os discos. |
Parâmetros de resposta
Código de status: 202
Parâmetro |
Tipo |
Descrição |
---|---|---|
transfer |
CreateVolumeTransferDetail object |
A informação de transferência. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
auth_key |
String |
A chave de autenticação da transferência do disco. |
created_at |
String |
A hora em que a transferência foi criada. Formato da hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX |
id |
String |
O ID da transferência. |
links |
Array of Link objects |
Os links de transferência. |
name |
String |
O nome da transferência. |
volume_id |
String |
O ID do disco. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
href |
String |
O link de atalho correspondente. |
rel |
String |
O nome do marcador do link de atalho. Padrão: next |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error |
Error object |
A mensagem de erro retornada se ocorrer um erro. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
code |
String |
O código de erro retornado se ocorrer um erro. Para obter detalhes sobre códigos de erro e seus significados, consulte Códigos de erro. |
message |
String |
A mensagem de erro retornada se ocorrer um erro. |
Exemplo de solicitações
Criar uma transferência de disco (O ID do disco é c86b9af4-151d-4ead-b62c-5fb967af0e37 e o nome da transferência é first volume.)
POST https://{endpoint}/v2/{project_id}/os-volume-transfer { "transfer" : { "volume_id" : "c86b9af4-151d-4ead-b62c-5fb967af0e37", "name" : "first volume" } }
Exemplo de respostas
Código de status: 202
Accepted
{ "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ódigo de status: 400
Bad Request
{ "error" : { "message" : "XXXX", "code" : "XXX" } }
Códigos de status
Código de status |
Descrição |
---|---|
202 |
Accepted |
400 |
Bad Request |
Códigos de erro
Consulte Códigos de erro.