ModificarConta
Sugerir alterações
PDFs
Você pode usar o ModifyAccount Método para modificar uma conta existente.
Ao bloquear uma conta, todas as conexões existentes dessa conta são encerradas imediatamente. Ao alterar as configurações CHAP de uma conta, 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 de atributos.
Parâmetros
Este método possui os seguintes parâmetros de entrada:
| Nome | Descrição | Tipo | Valor padrão | Obrigatório |
|---|---|---|---|---|
ID da conta |
ID da conta a ser modificada. |
inteiro |
Nenhum |
Sim |
atributos |
Lista de pares nome-valor em formato de objeto JSON. |
objeto JSON |
Nenhum |
Não |
ativarCap |
Especifica se as credenciais da conta CHAP podem ser usadas por um iniciador para acessar volumes. |
booleano |
Nenhum |
Não |
iniciadorSecreto |
O segredo CHAP a ser usado pelo iniciador. Este segredo deve ter entre 12 e 16 caracteres e ser impenetrável. O segredo CHAP do iniciador deve ser único e não pode ser o mesmo que o segredo CHAP do alvo. |
corda |
Nenhum |
Não |
status |
Status da conta. Valores possíveis:
|
corda |
Nenhum |
Não |
alvoSecreto |
O segredo CHAP a ser usado para o alvo (autenticação CHAP mútua). Este segredo deve ter entre 12 e 16 caracteres e ser impenetrável. O segredo CHAP de destino deve ser único e não pode ser o mesmo que o segredo CHAP de origem. |
corda |
Nenhum |
Não |
nome de usuário |
Utilizado para alterar o nome de usuário associado à conta. (Deve ter entre 1 e 64 caracteres). |
corda |
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 esse 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 exemplo a seguir:
{
"account": {
"storageContainerID": "abcdef01-1234-5678-90ab-cdef01234567",
"username": "user1",
"accountID": 1,
"volumes": [
],
"enableChap": true,
"initiatorSecret": "txz123456q890",
"attributes": {
},
"status": active",
"targetSecret": "rxe123b567890"
}
}
Novidade desde a versão
9,6