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/ APIs desatualizadas/ API Cinder/ Gerenciamento de disco/ Consulta de detalhes sobre um disco EVS (preterido)

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

Ver PDF

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 /v1/{project_id}/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

Nenhum

Parâmetros de resposta

Código de status: 200

**Tabela 2** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
volume	CinderVolumeDetail object	O disco retornado.

**Tabela 3** CinderVolumeDetail
Parâmetro	Tipo	Descrição
id	String	O ID do disco.
links	Array of Link objects	O URI do disco.
name	String	O nome do disco.
status	String	O status do disco. Para obter detalhes, consulte Status do disco EVS.
attachments	Array of VolumeAttachment objects	Se o disco está anexado.
availability_zone	String	A AZ à qual o disco pertence.
source_volid	String	O ID do disco de origem. Este parâmetro tem um valor se o disco for criado a partir de um disco de origem. Este campo não é suportado no momento.
snapshot_id	String	O ID do snapshot. Este parâmetro tem um valor se o disco for criado a partir de um snapshot.
description	String	A descrição do disco.
bootable	String	Se o disco é inicializável. true: o disco é inicializável. false: o disco não é inicializável.
created_at	String	A hora em que o disco foi criado. Formato da hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX
volume_type	String	O tipo de disco. O valor pode ser SATA, SAS, GPSSD, SSD, ESSD, GPSSD2 ou ESSD2. SATA: o tipo de I/O comum (esgotado) SAS: o tipo de I/O alta GPSSD: o tipo de SSD de uso geral SSD: o tipo de I/O ultra-alta ESSD: o tipo de SSD extremo GPSSD2: o tipo de SSD V2 de uso geral ESSD2: o tipo de SSD V2 extremo
metadata	VolumeMetadata object	Os metadados do disco. Se metadata não contiver o campo hw:passthrough, o tipo de dispositivo de disco será VBD. Se metadata não contiver o campo __system__encrypted, o disco não será criptografado.
size	Integer	O tamanho do disco, em GiB.
shareable	Boolean	Se o disco é compartilhável. Observação: este campo foi preterido. Use multiattach.
multiattach	Boolean	Se o disco é compartilhável.
os-vol-tenant-attr:tenant_id	String	O ID do locatário ao qual o disco pertence. O ID do locatário é o mesmo que o ID do projeto.
volume_image_metadata	Object	Os metadados da imagem de disco. Para obter detalhes sobre o campo volume_image_metadata, consulte Consulta de detalhes da imagem (API OpenStack nativo).
os-vol-host-attr:host	String	O campo reservado.
os-volume-replication:extended_status	String	O campo reservado.
consistencygroup_id	String	O campo reservado.
iops	iops object	As informações de IOPS do disco. Este parâmetro é retornado apenas para um SSD V2 de uso geral ou um disco SSD V2 extremo.
throughput	throughput object	As informações de taxa de transferência do disco. Este parâmetro é retornado apenas para um disco SSD V2 de propósito geral.
updated_at	String	A hora em que o disco foi atualizado.
replication_status	String	O campo reservado.
user_id	String	O campo reservado.
encrypted	Boolean	O campo reservado.

**Tabela 4** Link
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

**Tabela 5** VolumeAttachment
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** VolumeMetadata
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. NOTA: Use uma solicitação HTTPS para obter o ID da chave. Para obter detalhes, consulte Consulta da lista de chaves.
__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	Se o disco for criado a partir de um snapshot e a clonagem vinculada precisar ser usada, defina esse parâmetro como 0.
hw:passthrough	String	Se esse 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 esse parâmetro for definido como false, o tipo de dispositivo de disco será VBD, que também é o tipo padrão. O VBD suporta apenas comandos simples de leitura/gravação de SCSI. Se esse parâmetro não estiver disponível, o tipo de dispositivo de disco será VBD.

**Tabela 7** iops
Parâmetro	Tipo	Descrição
frozened	Boolean	A tag congelada. Padrão: false
id	String	O ID do IOPS do disco.
total_val	Integer	O IOPS.
volume_id	String	O ID do disco.

**Tabela 8** throughput
Parâmetro	Tipo	Descrição
frozened	Boolean	A tag congelada. Padrão: false
id	String	O ID da taxa de transferência.
total_val	Integer	A taxa de transferência.
volume_id	String	O ID do disco.

Código de status: 400

**Tabela 9** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error	Error object	A mensagem de erro retornada se ocorrer um erro.

**Tabela 10** Error
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

Nenhum

Exemplo de respostas

Código de status: 200

{
  "volume" : {
    "attachments" : [ ],
    "availability_zone" : "az-dc-1",
    "os-vol-host-attr:host" : "db-rabbitmq201#LVM_iSCSI",
    "encrypted" : false,
    "id" : "da4f9c7a-c275-4bc9-80c4-76c7d479a218",
    "size" : 1,
    "os-vol-tenant-attr:tenant_id" : "3dab0aaf682849678a94ec7b5a3af2ce",
    "metadata" : { },
    "status" : "available",
    "display_name" : "test",
    "bootable" : "false",
    "created_at" : "2014-12-18T17:14:38.000000",
    "volume_type" : "SATA",
    "multiattach" : false
  }
}

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: Gerenciamento de disco

Próximo tópico: Criação de discos 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.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar