Consulta de detalhes de uma transferência de disco EVS
Função
Esta API é usada para consultar os detalhes de uma transferência de disco EVS, incluindo o tempo de criação da transferência, o ID da transferência e o nome da transferência.
Método de chamada
Para obter detalhes, consulte Chamada de APIs.
URI
GET /v2/{project_id}/os-volume-transfer/{transfer_id}
|
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. |
|
transfer_id |
Sim |
String |
O ID da transferência. |
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âmetros de resposta
Código de status: 200
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
transfer |
VolumeTransfer object |
Os detalhes da transferência de disco. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
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
GET https://{endpoint}/v2/{project_id}/os-volume-transfer/{transfer_id}
https://{endpoint}/v2/{project_id}/os-volume-transfer/{transfer_id}
Exemplo de respostas
Código de status: 200
OK
{
"transfer" : {
"id" : "cac5c677-73a9-4288-bb9c-b2ebfb547377",
"created_at" : "2015-02-25T03:56:53.081642",
"name" : "first volume transfer",
"volume_id" : "894623a6-e901-4312-aa06-4275e6321cce",
"links" : [ {
"href" : "https://localhost/v2/firstproject/os-volume-transfer/1",
"rel" : "self"
}, {
"href" : "https://localhost/firstproject/os-volume-transfer/1",
"rel" : "bookmark"
} ]
}
}
Código de status: 400
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "XXX"
}
}
Códigos de status
|
Código de status |
Descrição |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
Códigos de erro
Consulte Códigos de erro.
