ModifyAccount
Você pode usar o ModifyAccount
método para modificar uma conta existente.
Quando você bloqueia uma conta, todas as conexões existentes dessa conta são imediatamente encerradas. Quando você altera as configurações CHAP de uma conta, todas as conexões existentes permanecem ativas e as novas configurações CHAP são usadas em conexões ou reconexões subsequentes. Para limpar os atributos de uma conta, especifique para o parâmetro atributos.
Parâmetros
Este método tem os seguintes parâmetros de entrada:
Nome | Descrição | Tipo | Valor padrão | Obrigatório |
---|---|---|---|---|
ID Contabilística |
AccountID para a conta modificar. |
número inteiro |
Nenhum |
Sim |
atributos |
Lista de pares nome-valor no formato de objeto JSON. |
Objeto JSON |
Nenhum |
Não |
EnableChap |
Especifica se as credenciais da conta CHAP podem ser usadas por um iniciador para acessar volumes. |
booleano |
Nenhum |
Não |
InitiatorSecret |
O segredo CHAP a ser usado para o iniciador. Este segredo deve ter 12-16 carateres de comprimento e deve ser impenetrável. O segredo CHAP iniciador deve ser único e não pode ser o mesmo que o segredo CHAP alvo. |
cadeia de carateres |
Nenhum |
Não |
estado |
Status da conta. Valores possíveis:
|
cadeia de carateres |
Nenhum |
Não |
TargetSecret |
O segredo CHAP a ser usado para o alvo (autenticação CHAP mútua). Este segredo deve ter 12-16 carateres de comprimento e deve ser impenetrável. O segredo CHAP alvo deve ser único e não pode ser o mesmo que o segredo CHAP iniciador. |
cadeia de carateres |
Nenhum |
Não |
nome de utilizador |
Usado para alterar o nome de usuário associado à conta. (Tem de ter entre 1 e 64 carateres). |
cadeia de carateres |
Nenhum |
Não |
Valor de retorno
Este método tem o seguinte valor de retorno:
Nome |
Descrição |
Tipo |
conta |
Um objeto contendo informações sobre a conta modificada. |
Exemplo de solicitação
As solicitações para este método são semelhantes ao exemplo a seguir. Neste exemplo, os atributos são limpos especificando para eles:
{ "method": "ModifyAccount", "params": { "accountID" : 25, "status" : "locked", "attributes" : {} }, "id" : 1 }
Exemplo de resposta
Este método retorna uma resposta semelhante ao seguinte exemplo:
{ "account": { "storageContainerID": "abcdef01-1234-5678-90ab-cdef01234567", "username": "user1", "accountID": 1, "volumes": [ ], "enableChap": true, "initiatorSecret": "txz123456q890", "attributes": { }, "status": active", "targetSecret": "rxe123b567890" } }
Novo desde a versão
9,6