diff --git a/openstack/identity/v2/_proxy.py b/openstack/identity/v2/_proxy.py index ff821562..670ba29b 100644 --- a/openstack/identity/v2/_proxy.py +++ b/openstack/identity/v2/_proxy.py @@ -46,6 +46,11 @@ class Proxy(proxy.BaseProxy): self._delete(role.Role, value, ignore_missing) def find_role(self, name_or_id): + """Find a single role + + :param name_or_id: The name or ID of a role. + :returns: One :class:`~openstack.compute.v2.role.Role` or None + """ return role.Role.find(self.session, name_or_id) def get_role(self, value): @@ -109,6 +114,11 @@ class Proxy(proxy.BaseProxy): self._delete(tenant.Tenant, value, ignore_missing) def find_tenant(self, name_or_id): + """Find a single tenant + + :param name_or_id: The name or ID of a tenant. + :returns: One :class:`~openstack.compute.v2.tenant.Tenant` or None + """ return tenant.Tenant.find(self.session, name_or_id) def get_tenant(self, value): @@ -172,6 +182,11 @@ class Proxy(proxy.BaseProxy): self._delete(user.User, value, ignore_missing) def find_user(self, name_or_id): + """Find a single user + + :param name_or_id: The name or ID of a user. + :returns: One :class:`~openstack.compute.v2.user.User` or None + """ return user.User.find(self.session, name_or_id) def get_user(self, value): diff --git a/openstack/identity/v3/_proxy.py b/openstack/identity/v3/_proxy.py index a673726c..b258aaa8 100644 --- a/openstack/identity/v3/_proxy.py +++ b/openstack/identity/v3/_proxy.py @@ -52,6 +52,12 @@ class Proxy(proxy.BaseProxy): self._delete(credential.Credential, value, ignore_missing) def find_credential(self, name_or_id): + """Find a single credential + + :param name_or_id: The name or ID of a credential. + :returns: One :class:`~openstack.compute.v2.credential.Credential` + or None + """ return credential.Credential.find(self.session, name_or_id) def get_credential(self, value): @@ -117,6 +123,11 @@ class Proxy(proxy.BaseProxy): self._delete(domain.Domain, value, ignore_missing) def find_domain(self, name_or_id): + """Find a single domain + + :param name_or_id: The name or ID of a domain. + :returns: One :class:`~openstack.compute.v2.domain.Domain` or None + """ return domain.Domain.find(self.session, name_or_id) def get_domain(self, value): @@ -180,6 +191,11 @@ class Proxy(proxy.BaseProxy): self._delete(endpoint.Endpoint, value, ignore_missing) def find_endpoint(self, name_or_id): + """Find a single endpoint + + :param name_or_id: The name or ID of a endpoint. + :returns: One :class:`~openstack.compute.v2.endpoint.Endpoint` or None + """ return endpoint.Endpoint.find(self.session, name_or_id) def get_endpoint(self, value): @@ -245,6 +261,11 @@ class Proxy(proxy.BaseProxy): self._delete(group.Group, value, ignore_missing) def find_group(self, name_or_id): + """Find a single group + + :param name_or_id: The name or ID of a group. + :returns: One :class:`~openstack.compute.v2.group.Group` or None + """ return group.Group.find(self.session, name_or_id) def get_group(self, value): @@ -309,6 +330,11 @@ class Proxy(proxy.BaseProxy): self._delete(policy.Policy, value, ignore_missing) def find_policy(self, name_or_id): + """Find a single policy + + :param name_or_id: The name or ID of a policy. + :returns: One :class:`~openstack.compute.v2.policy.Policy` or None + """ return policy.Policy.find(self.session, name_or_id) def get_policy(self, value): @@ -372,6 +398,11 @@ class Proxy(proxy.BaseProxy): self._delete(project.Project, value, ignore_missing) def find_project(self, name_or_id): + """Find a single project + + :param name_or_id: The name or ID of a project. + :returns: One :class:`~openstack.compute.v2.project.Project` or None + """ return project.Project.find(self.session, name_or_id) def get_project(self, value): @@ -435,6 +466,11 @@ class Proxy(proxy.BaseProxy): self._delete(service.Service, value, ignore_missing) def find_service(self, name_or_id): + """Find a single service + + :param name_or_id: The name or ID of a service. + :returns: One :class:`~openstack.compute.v2.service.Service` or None + """ return service.Service.find(self.session, name_or_id) def get_service(self, value): @@ -498,6 +534,11 @@ class Proxy(proxy.BaseProxy): self._delete(user.User, value, ignore_missing) def find_user(self, name_or_id): + """Find a single user + + :param name_or_id: The name or ID of a user. + :returns: One :class:`~openstack.compute.v2.user.User` or None + """ return user.User.find(self.session, name_or_id) def get_user(self, value): @@ -549,6 +590,11 @@ class Proxy(proxy.BaseProxy): self._delete(trust.Trust, value, ignore_missing) def find_trust(self, name_or_id): + """Find a single trust + + :param name_or_id: The name or ID of a trust. + :returns: One :class:`~openstack.compute.v2.trust.Trust` or None + """ return trust.Trust.find(self.session, name_or_id) def get_trust(self, value):