Exemplos de uso em CURL

Vários exemplos de uso gerados usando curl são fornecidos abaixo para referência. Para obter exemplos de uso feitos usando o idioma Python 3, consulte Introdução. 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 e X-AuthUNK 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: 
superusuário '-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 armazenamentosPara 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