ubuntufinder Package¶
ubuntufinder Package¶
- ubuntufinder.__init__.find_image(region, release='latest', architecture='amd64', instance_type='ebs', virtualization='paravirtual', _session=None)¶
Return a full image specification according to the query parameters
Parameters: - region (str) – The AWS region code to locate the Image in
- release (str) – The codename of the Ubuntu Release to locate. Defaults to the latest release
- architecture (str) – The CPU Architecture to find the image for. Defaults to amd64
- instance_type (str) – The Instance type to find the image for (ebs or instance-store). Defaults to ebs.
- virtualization (str) – The virtualization technology to find the image for (paravirtual or hvm).
Returns: An Image corresponding to your search
Return type: Raises: ubuntufinder.exceptions.ImageNotFound if no match is found.
Raises: ubuntufinder.exceptions.ServiceUnavailable if Cloud Images can’t be accessed.
- class ubuntufinder.__init__.Image(release, platform, stability, date, instance_type, architecture, region, ami_id, aki_id, _, virtualization)¶
Bases: ubuntufinder.models.BaseImage
An image as presented in CloudImages.
Variables: - date – The date this Image was released
- stability – The stability of this Image (release or devel)
- ami_id – The AMI ID for this Image
- aki_id – The AKI ID for this Image
- exception ubuntufinder.__init__.ImageNotFound¶
Bases: exceptions.Exception
Raised when no Image matching the query was found.
- exception ubuntufinder.__init__.LatestReleaseNotFound¶
Bases: exceptions.Exception
Raised when the latest Release could not be identified.
actions Module¶
- ubuntufinder.actions.find_image(region, release='latest', architecture='amd64', instance_type='ebs', virtualization='paravirtual', _session=None)[source]¶
Return a full image specification according to the query parameters
Parameters: - region (str) – The AWS region code to locate the Image in
- release (str) – The codename of the Ubuntu Release to locate. Defaults to the latest release
- architecture (str) – The CPU Architecture to find the image for. Defaults to amd64
- instance_type (str) – The Instance type to find the image for (ebs or instance-store). Defaults to ebs.
- virtualization (str) – The virtualization technology to find the image for (paravirtual or hvm).
Returns: An Image corresponding to your search
Return type: Raises: ubuntufinder.exceptions.ImageNotFound if no match is found.
Raises: ubuntufinder.exceptions.ServiceUnavailable if Cloud Images can’t be accessed.
exceptions Module¶
- exception ubuntufinder.exceptions.ImageNotFound[source]¶
Bases: exceptions.Exception
Raised when no Image matching the query was found.
- exception ubuntufinder.exceptions.LatestReleaseNotFound[source]¶
Bases: exceptions.Exception
Raised when the latest Release could not be identified.
Bases: exceptions.Exception
Raised when the Ubuntu Cloud Images service is not available
models Module¶
- class ubuntufinder.models.BaseImage(release, platform, instance_type, architecture, region, virtualization)[source]¶
Bases: object
A base image model, as can be searched for.
Variables: - release – The Ubuntu release codename for this Image.
- platform – Set to server for Cloud Images.
- instance_type – The instance type supported by this Image (ebs or instance-store).
- architecture – The architecture for this Image (i386 or amd64)
- region – The region for this Image (us-east-1, etc.)
- virtualization – The virtualization technology for this Image (paravirtual of hvm)
- class ubuntufinder.models.Image(release, platform, stability, date, instance_type, architecture, region, ami_id, aki_id, _, virtualization)[source]¶
Bases: ubuntufinder.models.BaseImage
An image as presented in CloudImages.
Variables: - date – The date this Image was released
- stability – The stability of this Image (release or devel)
- ami_id – The AMI ID for this Image
- aki_id – The AKI ID for this Image
- class ubuntufinder.models.SearchImage(release, platform, instance_type, architecture, region, virtualization)[source]¶
Bases: ubuntufinder.models.BaseImage
An Image used to search for other images.