Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/Elastic Volume Service/Referência de API/API/Gerenciamento de disco/Consulta de detalhes sobre um disco EVS (preterido)

Atualizado em 2024-09-25 GMT+08:00

Consulta de detalhes sobre um disco EVS (preterido)

Função

Esta API é usada para consultar detalhes sobre um único disco EVS. Esta API foi preterida. Use outra API.

Método de chamada

Para obter detalhes, consulte Chamada de APIs.

URI

GET /v2/{project_id}/os-vendor-volumes/{volume_id}

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	O ID do projeto.
volume_id	Sim	String	O ID do disco.

Parâmetros de solicitação

**Tabela 2** Parâmetros de cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Um token obtido do IAM é válido por apenas 24 horas. Ao usar um token para autenticação, armazene-o em cache para evitar chamar a API com frequência.

Parâmetros de resposta

Código de status: 200

**Tabela 3** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
volume	DiskDetail object	Detalhes do disco.

**Tabela 4** DiskDetail
Parâmetro	Tipo	Descrição
attachments	Array of DiskAttachment objects	As informações de anexo do disco.
availability_zone	String	A AZ à qual o disco pertence.
bootable	String	Se o disco é inicializável.
consistencygroup_id	String	O ID do grupo de consistência ao qual o disco pertence.
count	String	O número de discos consultados.
created_at	String	A hora em que o disco foi criado. Formato da hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX
dedicated_storage_id	String	O ID do pool de armazenamento dedicado que aloja o disco.
dedicated_storage_name	String	O nome do pool de armazenamento dedicado que aloja o disco.
description	String	A descrição do disco.
encrypted	Boolean	Se o disco é criptografado.
enterprise_project_id	String	O ID do projeto empresarial ao qual o disco foi adicionado. Este campo não é suportado no momento.
id	String	O ID do disco.
links	Array of Link objects	O URI do disco.
metadata	DiskMetadata object	Os metadados.
multiattach	Boolean	Se o disco é compartilhável.
name	String	O nome do disco.
os-vendor-extended:lock_check_endpoint	String	O URL de retorno de chamada usado para verificar a validade do bloqueio.
os-vendor-extended:lock_scene	String	A operação ou serviço que bloqueia o disco.
os-vendor-extended:lock_source_id	String	O ID do recurso ao qual o bloqueio pertence.
os-vendor-extended:lock_source_service	String	O tipo de recurso ao qual o bloqueio pertence.
os-vol-host-attr:host	String	O host à qual o disco pertence.
os-vol-mig-status-attr:migstat	String	O campo reservado.
os-vol-mig-status-attr:name_id	String	O campo reservado.
os-vol-tenant-attr:tenant_id	String	O ID do locatário ao qual o disco pertence.
os-volume-replication:driver_data	String	O campo reservado.
os-volume-replication:extended_status	String	O campo reservado.
replication_status	String	O campo reservado.
service_type	String	O tipo de serviço. Os serviços suportados são EVS, DSS e DESS.
shareable	String	Se o disco é compartilhável.
size	Integer	O tamanho do disco.
snapshot_id	String	O ID do snapshot.
source_volid	String	O ID do disco de origem.
status	String	O status do disco. Para obter detalhes, consulte Status do disco EVS.
tags	Object	As tags do disco. Este campo tem valores se o disco tiver tags. Ou, é deixado vazio.
updated_at	String	A hora em que o disco foi atualizado.
user_id	String	O campo reservado.
volume_image_metadata	Object	Os metadados da imagem. Este campo tem um valor se o disco for criado a partir de uma imagem. Ou, null é retornado. NOTA: Para obter detalhes sobre o campo volume_image_metadata, consulte Consulta de detalhes da imagem (API OpenStack nativo).
volume_type	String	O tipo de disco. O valor pode ser SATA, SAS, GPSSD ou SSD. SATA: o tipo de I/O comum SAS: o tipo de I/O alta GPSSD: o tipo de SSD de uso geral SSD: o tipo de I/O ultra-alta
wwn	String	O identificador exclusivo usado ao anexar o disco.

**Tabela 5** DiskAttachment
Parâmetro	Tipo	Descrição
attached_at	String	A hora em que o disco foi anexado. Formato da hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX
attachment_id	String	O ID do anexo.
device	String	O nome do dispositivo.
host_name	String	O nome do host físico que hospeda o servidor de nuvem ao qual o disco está anexado.
id	String	O ID do disco anexado.
server_id	String	O ID do servidor ao qual o disco está anexado.
volume_id	String	O ID do disco.

**Tabela 6** Link
Parâmetro	Tipo	Descrição
href	String	O link de atalho correspondente.
rel	String	O nome do marcador do link de atalho.

**Tabela 7** DiskMetadata
Parâmetro	Tipo	Descrição
__system__cmkid	String	O ID da CMK de encriptação em metadata. Este parâmetro é utilizado em conjunto com __system__encrypted para encriptação. O comprimento do cmkid é fixado em 36 bytes.
__system__encrypted	String	O campo de encriptação nos metadata. O valor pode ser 0 (não criptografado) ou 1 (criptografado). Se esse parâmetro não aparecer, o disco não será criptografado.
full_clone	String	O método de clone. Quando o disco é criado a partir de um snapshot, o valor 0 indica o método de clone vinculado.
hw:passthrough	String	Especifica o parâmetro que descreve o tipo de dispositivo de disco em metadata. Se esse valor do parâmetro for definido como true, o tipo de dispositivo de disco será SCSI, o que permite que os SOs do ECS acessem diretamente a mídia de armazenamento subjacente. Os comandos de reserva SCSI são suportados. Se valor deste parâmetro é false, o tipo de dispositivo do disco é VBD, que oferece suporte somente aos comandos SCSI de leitura/gravação simples. Se este parâmetro não aparecer, o tipo de dispositivo de disco é VBD.

Código de status: 400

**Tabela 8** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
Erro	Objeto de Error	A mensagem de erro retornada se ocorrer um erro. Para obter detalhes, consulte Parâmetros no campo error.

**Tabela 9** Error
Parâmetro	Tipo	Descrição
code	String	O código de erro retornado se ocorrer um erro. Para os 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-vendor-volumes/{volume_id}

https://{endpoint}/v2/{project_id}/os-vendor-volumes/{volume_id}

Exemplo de respostas

Código de status: 200

{
  "volume" : {
    "attachments" : [ ],
    "links" : [ {
      "href" : "https://volume.az0.dc1.domainname.com/v2/40acc331ac784f34842ba4f08ff2be48/volumes/591ac654-26d8-41be-bb77-4f90699d2d41",
      "rel" : "self"
    }, {
      "href" : "https://volume.az0.dc1.domainname.com/40acc331ac784f34842ba4f08ff2be48/volumes/591ac654-26d8-41be-bb77-4f90699d2d41",
      "rel" : "bookmark"
    } ],
    "availability_zone" : "az-dc-1",
    "os-vol-host-attr:host" : "az-dc-1#SSD",
    "encrypted" : false,
    "multiattach" : true,
    "updated_at" : "2016-02-03T02:19:29.895237",
    "replication_status" : "disabled",
    "id" : "591ac654-26d8-41be-bb77-4f90699d2d41",
    "size" : 40,
    "user_id" : "fd03ee73295e45478d88e15263d2ee4e",
    "os-vol-tenant-attr:tenant_id" : "40acc331ac784f34842ba4f08ff2be48",
    "metadata" : { },
    "tags" : {
      "key1" : "value1",
      "key2" : "value2"
    },
    "status" : "available",
    "description" : "auto-created_from_restore_from_backup",
    "name" : "restore_backup_0115efb3-678c-4a9e-bff6-d3cd278238b9",
    "bootable" : "false",
    "created_at" : "2016-02-03T02:19:11.723797",
    "service_type" : "EVS",
    "wwn" : " 688860300000d136fa16f48f05992360"
  }
}

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.

Tópico principal:Gerenciamento de disco

Tópico anterior: Consulta de detalhes sobre todos os discos EVS (preterido)

Próximo tópico: Modificação da QoS de um disco EVS

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.