~ubuntu-branches/ubuntu/precise/euca2ools/precise-proposed

« back to all changes in this revision

Viewing changes to .pc/debian-changes-2.0.0~bzr464-0ubuntu1/man/euca-describe-instances.1

  • Committer: Bazaar Package Importer
  • Author(s): Scott Moser
  • Date: 2011-08-15 11:16:29 UTC
  • mfrom: (1.1.10 upstream)
  • Revision ID: james.westby@ubuntu.com-20110815111629-3u49jvtwabwozpb7
Tags: 2.0.0~bzr464-0ubuntu1
* new upstream snapshot of bzr revno 464. (LP: #826022)
* Note, previous upload was incorrectly named 'bzr451'.  It should have
  been named bzr461 as it was a snapshot of revision 461.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.38.2.
 
2
.TH EUCA-DESCRIBE-INSTANCES "1" "July 2011" "euca-describe-instances         Version: 2.0 (BSD)" "User Commands"
 
3
.SH NAME
 
4
euca-describe-instances \- Eucalyptus tool:   
 
5
.SH DESCRIPTION
 
6
Shows information about instances.
 
7
.PP
 
8
euca\-describe\-instances  [\-a, \fB\-\-access\-key\fR <access_key> ][\-s, \fB\-\-secret\-key\fR
 
9
.IP
 
10
<secret_key> ][\-\-config <config_path>
 
11
][\-\-debug][\-\-debugger][\-h, \fB\-\-help][\-\-region\fR
 
12
<region_name> ][\-U, \fB\-\-url\fR <url> ][\-\-version][\-\-eucaauth] [\-\-filter name=value] [ instance ]
 
13
.PP
 
14
OPTIONAL PARAMETERS
 
15
.TP
 
16
\fB\-a\fR,\-\-access\-key
 
17
User's Access Key ID.
 
18
.TP
 
19
\fB\-s\fR,\-\-secret\-key
 
20
User's Secret Key.
 
21
.TP
 
22
\fB\-\-config\fR
 
23
Read credentials and cloud settings
 
24
from the specified config file (defaults to
 
25
$HOME/.eucarc or /etc/euca2ools/eucarc).
 
26
.TP
 
27
\fB\-\-debug\fR
 
28
Turn on debugging output.
 
29
.TP
 
30
\fB\-\-debugger\fR
 
31
Enable interactive debugger on error
 
32
.TP
 
33
\fB\-h\fR,\-\-help
 
34
Display this help message.
 
35
.TP
 
36
\fB\-\-region\fR
 
37
region to direct requests to
 
38
.TP
 
39
\fB\-U\fR,\-\-url
 
40
URL of the Cloud to connect to.
 
41
.TP
 
42
\fB\-\-version\fR
 
43
Display the version of this tool.
 
44
.TP
 
45
\fB\-\-euca\-auth\fR
 
46
Use NC authentication mode
 
47
.PP
 
48
AVAILABLE FILTERS
 
49
.TP
 
50
architecture
 
51
Instance architecture.
 
52
Valid values are i386 | x86_64
 
53
.TP
 
54
availability\-zone
 
55
Instance's Availability Zone
 
56
.IP
 
57
block\-device\-mapping.attach\-timeAttach time for an Amazon EBS volume mapped
 
58
.IP
 
59
to the instance
 
60
.IP
 
61
block\-device\-mapping.delete\-on\-terminationWhether the Amazon EBS volume is deleted on
 
62
.IP
 
63
instance termination.
 
64
.IP
 
65
block\-device\-mapping.device\-nameDevice name (e.g., /dev/sdh) for an Amazon EBS
 
66
.TP
 
67
volume
 
68
mapped to the
 
69
.IP
 
70
image.
 
71
.TP
 
72
block\-device\-mapping.status
 
73
Status for an Amazon EBS volume mapped to the
 
74
instance.                      Valid Values:
 
75
attaching | attached | detaching | detached
 
76
.IP
 
77
block\-device\-mapping.volume\-idID for an Amazon EBS volume mapped to the
 
78
.IP
 
79
instance.
 
80
.TP
 
81
client\-token
 
82
Idempotency token you provided when you
 
83
launched                      the instance.
 
84
.TP
 
85
dns\-name
 
86
Public DNS name of the instance.
 
87
.TP
 
88
group\-id
 
89
A security group the instance is in.
 
90
.TP
 
91
hypervisor
 
92
Hypervisor type of the instance.
 
93
Valid values are ovm | xen.
 
94
.TP
 
95
image\-id
 
96
ID of the imageID used to launch the instance
 
97
.TP
 
98
instance\-id
 
99
ID of the instance
 
100
.TP
 
101
instance\-lifecycle
 
102
Whether this is a Spot Instance.
 
103
.TP
 
104
instance\-state\-code
 
105
Code identifying the state of the instance
 
106
.TP
 
107
instance\-state\-name
 
108
State of the instance.
 
109
.TP
 
110
instance\-type
 
111
Type of the instance.
 
112
.TP
 
113
ip\-address
 
114
Public IP address of the instance.
 
115
.TP
 
116
kernel\-id
 
117
Kernel ID.
 
118
.TP
 
119
key\-name
 
120
Name of the key pair used when the
 
121
instance was launched.
 
122
.TP
 
123
launch\-index
 
124
When launching multiple instances at once,
 
125
this is the index for the instance in the
 
126
launch group
 
127
.TP
 
128
launch\-time
 
129
Time instance was launched
 
130
.TP
 
131
monitoring\-state
 
132
Whether monitoring is enabled for the
 
133
instance.
 
134
.TP
 
135
owner\-id
 
136
AWS account ID of the image owner.
 
137
.TP
 
138
placement\-group\-name
 
139
Name of the placement group the instance is in
 
140
.TP
 
141
platform
 
142
Use windows if you have Windows based AMIs;
 
143
otherwise leave blank.
 
144
.TP
 
145
private\-dns\-name
 
146
Private DNS name of the instance.
 
147
.TP
 
148
private\-ip\-address
 
149
Private ip address of the instance.
 
150
.TP
 
151
product\-code
 
152
Product code associated with the AMI.
 
153
.TP
 
154
ramdisk\-id
 
155
The ramdisk ID.
 
156
.TP
 
157
reason
 
158
Reason for the instance's current state.
 
159
.TP
 
160
requestor\-id
 
161
ID of the entity that launched the instance
 
162
on your behalf.
 
163
.TP
 
164
reservation\-id
 
165
ID of the instance's reservation.
 
166
.TP
 
167
root\-device\-name
 
168
Root device name of the AMI (e.g., /dev/sda1).
 
169
.TP
 
170
root\-device\-type
 
171
Root device type the AMI uses.
 
172
Valid Values: ebs | instance\-store.
 
173
.TP
 
174
spot\-instance\-request\-id
 
175
ID of the Spot Instance request.
 
176
.TP
 
177
state\-reason\-code
 
178
Reason code for the state change.
 
179
.TP
 
180
state\-reason\-message
 
181
Message for the state change.
 
182
.TP
 
183
subnet\-id
 
184
ID of the subnet the instance is in (VPC).
 
185
.TP
 
186
tag\-key
 
187
Key of a tag assigned to the resource.
 
188
.TP
 
189
tag\-value
 
190
Value of a tag assigned to the resource.
 
191
.TP
 
192
tag:key
 
193
Filters the results based on a specific
 
194
tag/value combination.
 
195
.TP
 
196
virtualization\-type
 
197
Virtualization type of the instance.
 
198
Valid values: paravirtual | hvm
 
199
.TP
 
200
vpc\-id
 
201
ID of the VPC the instance is in.