diff options
Diffstat (limited to 'doc/eclat.conf.5')
-rw-r--r-- | doc/eclat.conf.5 | 44 |
1 files changed, 43 insertions, 1 deletions
diff --git a/doc/eclat.conf.5 b/doc/eclat.conf.5 index 30b5b81..8905450 100644 --- a/doc/eclat.conf.5 +++ b/doc/eclat.conf.5 @@ -13,7 +13,7 @@ .\" .\" You should have received a copy of the GNU General Public License .\" along with Eclat. If not, see <http://www.gnu.org/licenses/>. -.TH ECLAT.CONF 5 "April 26, 2013" "ECLAT" "Eclat User Reference" +.TH ECLAT.CONF 5 "May 21, 2013" "ECLAT" "Eclat User Reference" .SH NAME eclat.conf \- configuration file for .BR eclat (1). @@ -868,6 +868,48 @@ This statement is mandatory. \fBdebug\fR \fIn\fR Sets the LDAP debug number. Refer to the OpenLDAP documentation for the valid values of \fIn\fR and their meaning. +.SS EC2 MAP +This map makes it possible to use \fBEC2\fR services to translate +identifiers. The idea is to query \fBEC2\fR using the symbolic ID and +obtain the real resource ID from the request. The map is defined as +follows: +.sp +.nf + map <name: string> { + type ec2; + key \fItrans\fR; + action \fIaction-name\fR; + arguments \fIarg-list\fR; + return \fIreturn-path\fR; + } +.fi +.sp +.TP +\fBaction\fR \fIaction-name\fR +Defines the \fBEC2\fR action name to use. Refer to the Amazon API +documentation for a list of action names. +.TP +\fBarguments\fR \fIarg-list\fR +Defines the list of arguments to send with the request. Any +occurrence of the \fB$key\fR variable within that list is replaced +with the actual key value. +.TP +\fBreturn\fR \fIreturn-path\fR +Defines the return value, using a path notation. +.PP +The example below illustrates the use of the \fBDescribeImages\fR +action to implement the \fBImageId\fR map: +.sp +.nf + map "ImageId" { + type ec2; + action DescribeImages; + arguments ("Owner.1=self", + "Filter.1.Name=tag:Name", + "Filter.1.Value.1=${key}"); + return ".DescribeImagesResponse.imagesSet.item.imageId"; + } +.fi .SH "SEE ALSO" .BR eclat (1), .BR m4 (1). |