func (c *Client) RemoveUser(tag string) error {
u := params.Entity{Tag: tag}
p := params.Entities{Entities: []params.Entity{u}}
results := new(params.ErrorResults)
err := call(c.st, "RemoveUser", p, results)
if err != nil {
return errors.Trace(err)
}
return results.OneError()
}
// DestroyAllSubordinates destroys all subordinates of the unit.
func (u *Unit) DestroyAllSubordinates() error {
var result params.ErrorResults
args := params.Entities{
Entities: []params.Entity{{Tag: u.tag.String()}},
}
err := u.st.call("DestroyAllSubordinates", args, &result)
if err != nil {
return err
}
return result.OneError()
}
// EnsureDead sets the machine lifecycle to Dead if it is Alive or
// Dying. It does nothing otherwise.
func (m *Machine) EnsureDead() error {
var result params.ErrorResults
args := params.Entities{
Entities: []params.Entity{{Tag: m.tag}},
}
err := m.st.call("EnsureDead", args, &result)
if err != nil {
return err
}
return result.OneError()
}
// EnsureDead sets the unit lifecycle to Dead if it is Alive or
// Dying. It does nothing otherwise.
func (u *Unit) EnsureDead() error {
var result params.ErrorResults
args := params.Entities{
Entities: []params.Entity{{Tag: u.tag.String()}},
}
err := u.st.call("EnsureDead", args, &result)
if err != nil {
return err
}
return result.OneError()
}
// Remove removes the unit from state, calling EnsureDead first, then Remove.
// It will fail if the unit is not present.
func (u *Unit) Remove() error {
var result params.ErrorResults
args := params.Entities{
Entities: []params.Entity{{Tag: u.tag}},
}
err := u.st.call("Remove", args, &result)
if err != nil {
return err
}
return result.OneError()
}
// Remove removes the machine from state. It will fail if the machine
// is not Dead.
func (m *Machine) Remove() error {
var result params.ErrorResults
args := params.Entities{
Entities: []params.Entity{{Tag: m.tag.String()}},
}
err := m.st.call("Remove", args, &result)
if err != nil {
return err
}
return result.OneError()
}
// SetMachineAddresses sets the machine determined addresses of the machine.
func (m *Machine) SetMachineAddresses(addresses []network.Address) error {
var result params.ErrorResults
args := params.SetMachinesAddresses{
MachineAddresses: []params.MachineAddresses{
{Tag: m.Tag(), Addresses: addresses},
},
}
err := m.st.call("SetMachineAddresses", args, &result)
if err != nil {
return err
}
return result.OneError()
}
// SetPassword sets the unit's password.
func (u *Unit) SetPassword(password string) error {
var result params.ErrorResults
args := params.EntityPasswords{
Changes: []params.EntityPassword{
{Tag: u.tag, Password: password},
},
}
err := u.st.call("SetPasswords", args, &result)
if err != nil {
return err
}
return result.OneError()
}
func (c *Client) SetPassword(username, password string) error {
userArgs := usermanager.ModifyUsers{
Changes: []usermanager.ModifyUser{{
Username: username,
Password: password}},
}
results := new(params.ErrorResults)
err := call(c.st, "SetPassword", userArgs, results)
if err != nil {
return err
}
return results.OneError()
}
// SetStatus sets the status of the unit.
func (u *Unit) SetStatus(status params.Status, info string, data params.StatusData) error {
var result params.ErrorResults
args := params.SetStatus{
Entities: []params.EntityStatus{
{Tag: u.tag.String(), Status: status, Info: info, Data: data},
},
}
err := u.st.call("SetStatus", args, &result)
if err != nil {
return err
}
return result.OneError()
}
// ClosePort sets the policy of the port with protocol and number to
// be closed.
//
// TODO: We should really be opening and closing ports on machines,
// rather than units.
func (u *Unit) ClosePort(protocol string, number int) error {
var result params.ErrorResults
args := params.EntitiesPorts{
Entities: []params.EntityPort{
{Tag: u.tag.String(), Protocol: protocol, Port: number},
},
}
err := u.st.call("ClosePort", args, &result)
if err != nil {
return err
}
return result.OneError()
}
// SetPassword sets the machine's password.
func (m *Machine) SetPassword(password string) error {
var result params.ErrorResults
args := params.EntityPasswords{
Changes: []params.EntityPassword{
{Tag: m.tag.String(), Password: password},
},
}
err := m.st.call("SetPasswords", args, &result)
if err != nil {
return err
}
return result.OneError()
}
// SetPassword sets the password associated with the agent's entity.
func (m *Entity) SetPassword(password string) error {
var results params.ErrorResults
args := params.EntityPasswords{
Changes: []params.EntityPassword{{
Tag: m.tag,
Password: password,
}},
}
err := m.st.caller.Call("Agent", "", "SetPasswords", args, &results)
if err != nil {
return err
}
return results.OneError()
}
// LeaveScope signals that the unit has left its scope in the relation.
// After the unit has left its relation scope, it is no longer a member
// of the relation; if the relation is dying when its last member unit
// leaves, it is removed immediately. It is not an error to leave a scope
// that the unit is not, or never was, a member of.
func (ru *RelationUnit) LeaveScope() error {
var result params.ErrorResults
args := params.RelationUnits{
RelationUnits: []params.RelationUnit{{
Relation: ru.relation.tag,
Unit: ru.unit.tag,
}},
}
err := ru.st.call("LeaveScope", args, &result)
if err != nil {
return err
}
return result.OneError()
}
func (c *Client) AddUser(username, displayName, password string) error {
if !names.IsValidUser(username) {
return fmt.Errorf("invalid user name %q", username)
}
userArgs := usermanager.ModifyUsers{
Changes: []usermanager.ModifyUser{{Username: username, DisplayName: displayName, Password: password}},
}
results := new(params.ErrorResults)
err := call(c.st, "AddUser", userArgs, results)
if err != nil {
return errors.Trace(err)
}
return results.OneError()
}
// SetVersion sets the tools version associated with the entity with
// the given tag, which must be the tag of the entity that the
// upgrader is running on behalf of.
func (st *State) SetVersion(tag string, v version.Binary) error {
var results params.ErrorResults
args := params.EntitiesVersion{
AgentTools: []params.EntityVersion{{
Tag: tag,
Tools: ¶ms.Version{v},
}},
}
err := st.call("SetTools", args, &results)
if err != nil {
// TODO: Not directly tested
return err
}
return results.OneError()
}
// SetCharmURL marks the unit as currently using the supplied charm URL.
// An error will be returned if the unit is dead, or the charm URL not known.
func (u *Unit) SetCharmURL(curl *charm.URL) error {
if curl == nil {
return fmt.Errorf("charm URL cannot be nil")
}
var result params.ErrorResults
args := params.EntitiesCharmURL{
Entities: []params.EntityCharmURL{
{Tag: u.tag.String(), CharmURL: curl.String()},
},
}
err := u.st.call("SetCharmURL", args, &result)
if err != nil {
return err
}
return result.OneError()
}
// ImportKeys imports new authorised ssh keys from the specified key ids for the specified user.
func (api *KeyManagerAPI) ImportKeys(arg params.ModifyUserSSHKeys) (params.ErrorResults, error) {
result := params.ErrorResults{
Results: make([]params.ErrorResult, len(arg.Keys)),
}
if len(arg.Keys) == 0 {
return result, nil
}
canWrite, err := api.getCanWrite()
if err != nil {
return params.ErrorResults{}, common.ServerError(err)
}
if !canWrite(arg.User) {
return params.ErrorResults{}, common.ServerError(common.ErrPerm)
}
// For now, authorised keys are global, common to all users.
sshKeys, currentFingerprints, err := api.currentKeyDataForAdd()
if err != nil {
return params.ErrorResults{}, common.ServerError(fmt.Errorf("reading current key data: %v", err))
}
importedKeyInfo := runSSHKeyImport(arg.Keys)
// Ensure we are not going to add invalid or duplicate keys.
result.Results = make([]params.ErrorResult, len(importedKeyInfo))
for i, keyInfo := range importedKeyInfo {
if keyInfo.err != nil {
result.Results[i].Error = common.ServerError(keyInfo.err)
continue
}
if currentFingerprints.Contains(keyInfo.fingerprint) {
result.Results[i].Error = common.ServerError(fmt.Errorf("duplicate ssh key: %s", keyInfo.key))
continue
}
sshKeys = append(sshKeys, keyInfo.key)
}
err = api.writeSSHKeys(sshKeys)
if err != nil {
return params.ErrorResults{}, common.ServerError(err)
}
return result, nil
}
// SetInstanceInfo sets the provider specific instance id, nonce,
// metadata, networks and interfaces for this machine. Once set, the
// instance id cannot be changed.
func (m *Machine) SetInstanceInfo(
id instance.Id, nonce string, characteristics *instance.HardwareCharacteristics,
networks []params.Network, interfaces []params.NetworkInterface,
) error {
var result params.ErrorResults
args := params.InstancesInfo{
Machines: []params.InstanceInfo{{
Tag: m.tag,
InstanceId: id,
Nonce: nonce,
Characteristics: characteristics,
Networks: networks,
Interfaces: interfaces,
}},
}
err := m.st.call("SetInstanceInfo", args, &result)
if err != nil {
return err
}
return result.OneError()
}
// Write writes changes made to s back onto its node. Keys set to
// empty values will be deleted, others will be updated to the new
// value.
//
// TODO(dimitern): 2013-09-06 bug 1221798
// Once the machine addressability changes lands, we may need to
// revise the logic here to take into account that the
// "private-address" setting for a unit can be changed outside of the
// uniter's control. So we may need to send diffs of what has changed
// to make sure we update the address (and other settings) correctly,
// without overwritting.
func (s *Settings) Write() error {
// First make a copy of the map, including deleted keys.
settingsCopy := make(params.RelationSettings)
for k, v := range s.settings {
settingsCopy[k] = v
}
var result params.ErrorResults
args := params.RelationUnitsSettings{
RelationUnits: []params.RelationUnitSettings{{
Relation: s.relationTag,
Unit: s.unitTag,
Settings: settingsCopy,
}},
}
err := s.st.call("UpdateSettings", args, &result)
if err != nil {
return err
}
return result.OneError()
}