Exemplos de uso em CURL

Vários exemplos de uso que são gerados pelo uso de curl são fornecidos para referência.

Para obter exemplos de uso feitos usando o idioma Python 3, consulte Iniciando. Para conhecer exemplos que usam a linguagem de programação Perl, consulte Exemplos de uso da API RESTful em Perl. Os exemplos de uso a seguir não incluem todas as ações que podem ser tomadas nos objetos do sistema.

Cada exemplo de curl tem o seguinte formato:
curl -k -X POST -H header_1 -H header_2... -d 
'JSON' https://system_ip:7443/rest/target

Quando as definições a seguir se aplicam:

  • POST é o único método HTTPS que a API RESTful do Spectrum Virtualize suporta.
  • Cabeçalhos (header_1 ) são cabeçalhos HTTP especificados individualmente (por exemplo, Content-Type and X-Auth­Username).
  • -d é seguido pela entrada JSON (por exemplo, '{"raid_level": "raid5"}').
  • system_ip é o endereço IP para o qual você está enviando solicitações.
  • target é o objeto de destino dos comandos, que inclui quaisquer IDs de objetos, nomes e parâmetros.

Autenticação

A seguir, há um exemplo do procedimento correto para autenticação. Você se autentica primeiro produzindo um token de autenticação e, em seguida, usando esse token em todos os comandos futuros até a sessão terminar. Para obter mais informações sobre autenticação, consulte Visão geral de autenticação e Gerenciamento de API.
curl -k -X POST -H 'Content-Type: application/json' -H 'X-Auth-Username: 
superuser' -H 'X-Auth-Password: passw0rd' 
https://192.168.10.109:7443/rest/auth
Isso produz um token de autenticação que você usa para todos os outros comandos.
{3}{8}{8}{2}{3}f60c758dca26f3eaa17dc4664964905a6f058ae2ec92e0f0b63fcf08a3e" }

Fazendo uma matriz

É possível usar comandos apenas após a autenticação, incluindo o comando para criar uma matriz no sistema. O exemplo a seguir demonstra o uso do token no lugar dos cabeçalhos de autenticação usados no processo de autenticação.
curl -k -X POST -H 'Content-Type: application / json' -H ' X-Auth-Token: 
38823f60c758dca26f3eaa17dc4664964905a6f058ae2ec92e0f0b63fcf08a3e '
-d '{"level": "draid6", "drive": "6:7:8:9:10", "draid6grp"}'
           https://192.168.10.109:7443/rest/mkarray

Alterando configurações de matriz

O próximo exemplo mostra como modificar os atributos de um membro da matriz para alterar o membro 24 para a nova unidade 15 usando uma reconstrução distribuída para uma área de reconstrução:
curl -k -X POST -H 'Content-Type: application / json' -H ' X-Auth-Token: 
38823f60c758dca26f3eaa17dc4664964905a6f058ae2ec92e0f0b63fcf08a3e '
-d '{"member": "24", "newdrive": "15",
     "immediate": "0"}' https://192.168.10.109:7443/rest/charraymember

Removendo a matriz

O exemplo final mostra como remover um MDisk de matriz do conjunto de armazenamentos. Para obter mais informações sobre como gerenciar a matriz, consulte rmarray.

curl -k -X POST -H 'Content-Type: application / json' -H ' X-Auth-Token: 
38823f60c758dca26f3eaa17dc4664964905a6f058ae2ec92e0f0b63fcf08a3e ' 
-d '{"mdisk": "6", "mdiskgrp_10"}' https://192.168.10.109:7443/rest/rmarray