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 metadados de disco/Adição de metadados de um disco EVS
Atualizado em 2024-09-25 GMT+08:00
Ver PDF
Compartilhar

Adição de metadados de um disco EVS

Função

Esta API é usada para adicionar os metadados de um disco EVS.

Método de chamada

Para obter detalhes, consulte Chamada de APIs.

URI

POST /v3/{project_id}/volumes/{volume_id}/metadata

Tabela 1 Parâmetros de caminho

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.

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

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.

Tabela 3 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

metadata

Sim

Metadata object

Os metadados a serem atualizados. Para obter detalhes, consulte Parâmetro no campo metadata.

key ou value em metadata pode conter mais de 255 caracteres.

Tabela 4 Metadata

Parâmetro

Obrigatório

Tipo

Descrição

__system__encrypted

Não

String

O campo de encriptação nos metadata. 0: sem criptografia 1: criptografia. Se este parâmetro não aparecer, o disco não será criptografado.

__system__cmkid

Não

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.

hw:passthrough

Não

String

Especifica o parâmetro que descreve o tipo de dispositivo de disco em metadata.

  • Se o valor desse parâmetro for true, o tipo de dispositivo de disco será SCSI, o que permite que os sistemas operacionais do ECS acessem diretamente a mídia de armazenamento subjacente e ofereça suporte a comandos de reserva SCSI.

  • 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.

full_clone

Não

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.

Parâmetros de resposta

Código de status: 200

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

metadata

Map<String,String>

Os metadados de snapshot, que são compostos de pares de chave-valor.

Código de status: 400

Tabela 6 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error

Error object

A mensagem de erro retornada se ocorrer um erro.

Tabela 7 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

POST https://{endpoint}/v3/{project_id}/volumes/{volume_id}/metadata

{
  "metadata" : {
    "key1" : "value1",
    "key2" : "value2"
  }
}

Exemplo de respostas

Código de status: 200

OK

{
  "metadata" : {
    "key1" : "value1",
    "key2" : "value2"
  }
}

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.