Sample code for 30+ languages & platforms
React Native

EC2 Check Instance Status

See more Amazon EC2 Examples

Demonstrates how to send a request to check the status of Amazon EC2 instances.

Chilkat React Native Downloads

React Native
import { AuthAws, Rest, Xml } from '@chilkat/react-native'

async function chilkatExample() {
  // This example requires the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  const rest = new Rest();

  // Connect to the Amazon AWS server.
  // such as https://ec2.amazonaws.com/
  const bTls = true;
  const port = 443;
  const bAutoReconnect = true;
  await rest.connectAsync('ec2.us-west-2.amazonaws.com', port, bTls, bAutoReconnect);

  // Provide AWS credentials for the REST call.
  const authAws = new AuthAws();
  authAws.accessKey = 'AWS_ACCESS_KEY';
  authAws.secretKey = 'AWS_SECRET_KEY';
  // the region should match the region part of the domain passed to the REST connect method (above).
  authAws.region = 'us-west-2';
  authAws.serviceName = 'ec2';

  rest.setAuthAws(authAws);

  rest.addQueryParam('Action', 'DescribeInstanceStatus');
  rest.addQueryParam('Version', '2016-11-15');

  rest.addQueryParam('InstanceId.1', 'i-999719995399c9999');
  // If you have additional instances to check, then add them with .2, .3, etc.
  rest.addQueryParam('InstanceId.2', 'i-999719995399c0000');
  rest.addQueryParam('InstanceId.3', 'i-999719995399c0111');
  // ...

  // Instead of checking specific instances, you can check all instances by 
  // sending the IncludeAllInstances param
  rest.addQueryParam('IncludeAllInstances', 'true');

  let responseXml: string;
  try {
    responseXml = await rest.fullRequestNoBodyAsync('GET', '/');
  } catch {
    console.log(rest.lastErrorText);
    return;
  }

  // A successful response will have a status code equal to 200.
  if (rest.responseStatusCode !== 200) {
    console.log(`response status code = ${rest.responseStatusCode}`);
    console.log(`response status text = ${rest.responseStatusText}`);
    console.log(`response header: ${rest.responseHeader}`);
    console.log(`response body: ${responseXml}`);
    return;
  }

  // Examine the successful XML response.
  const xml = new Xml();
  xml.loadXml(responseXml);
  console.log(xml.getXml());

  // Here is a sample response:

  // Use this online tool to generate parsing code from sample XML: 
  // Generate Parsing Code from XML

  // <DescribeInstanceStatusResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
  //     <requestId>3be1508e-c444-4fef-89cc-0b1223c4f02fEXAMPLE</requestId>
  //     <instanceStatusSet>
  //         <item>
  //             <instanceId>i-1234567890abcdef0</instanceId>
  //             <availabilityZone>us-east-1d</availabilityZone>
  //             <instanceState>
  //                 <code>16</code>
  //                 <name>running</name>
  //             </instanceState>
  //             <systemStatus>
  //                 <status>impaired</status>
  //                 <details>
  //                     <item>
  //                         <name>reachability</name>
  //                         <status>failed</status>
  //                         <impairedSince>YYYY-MM-DDTHH:MM:SS.000Z</impairedSince>
  //                     </item>
  //                 </details>
  //             </systemStatus>
  //             <instanceStatus>
  //                 <status>impaired</status>
  //                 <details>
  //                     <item>
  //                         <name>reachability</name>
  //                         <status>failed</status>
  //                         <impairedSince>YYYY-MM-DDTHH:MM:SS.000Z</impairedSince>
  //                     </item>
  //                 </details>
  //             </instanceStatus>
  //             <eventsSet>
  //               <item>
  //                 <code>instance-retirement</code>
  //                 <description>The instance is running on degraded hardware</description>
  //                 <notBefore>YYYY-MM-DDTHH:MM:SS+0000</notBefore>
  //                 <notAfter>YYYY-MM-DDTHH:MM:SS+0000</notAfter>
  //               </item>
  //             </eventsSet>
  //         </item>
  //         <item>
  //             <instanceId>i-0598c7d356eba48d7</instanceId>
  //             <availabilityZone>us-east-1d</availabilityZone>
  //             <instanceState>
  //                 <code>16</code>
  //                 <name>running</name>
  //             </instanceState>
  //             <systemStatus>
  //                 <status>ok</status>
  //                 <details>
  //                     <item>
  //                         <name>reachability</name>
  //                         <status>passed</status>
  //                     </item>
  //                 </details>
  //             </systemStatus>
  //             <instanceStatus>
  //                 <status>ok</status>
  //                 <details>
  //                     <item>
  //                         <name>reachability</name>
  //                         <status>passed</status>
  //                     </item>
  //                 </details>
  //             </instanceStatus>
  //             <eventsSet>
  //               <item>
  //                 <code>instance-reboot</code>
  //                 <description>The instance is scheduled for a reboot</description>
  //                 <notBefore>YYYY-MM-DDTHH:MM:SS+0000</notBefore>
  //                 <notAfter>YYYY-MM-DDTHH:MM:SS+0000</notAfter>
  //               </item>
  //             </eventsSet>
  //         </item>
  //         <item>
  //             <instanceId>i-0987654321abcdef0</instanceId>
  //             <availabilityZone>us-east-1d</availabilityZone>
  //             <instanceState>
  //                 <code>16</code>
  //                 <name>running</name>
  //             </instanceState>
  //             <systemStatus>
  //                 <status>ok</status>
  //                 <details>
  //                     <item>
  //                         <name>reachability</name>
  //                         <status>passed</status>
  //                     </item>
  //                 </details>
  //             </systemStatus>
  //             <instanceStatus>
  //                 <status>ok</status>
  //                 <details>
  //                     <item>
  //                         <name>reachability</name>
  //                         <status>passed</status>
  //                     </item>
  //                 </details>
  //             </instanceStatus>
  //         </item>
  //         <item>
  //             <instanceId>i-0598c7d356eba48d8</instanceId>
  //             <availabilityZone>us-east-1d</availabilityZone>
  //             <instanceState>
  //                 <code>16</code>
  //                 <name>running</name>
  //             </instanceState>
  //             <systemStatus>
  //                 <status>ok</status>
  //                 <details>
  //                     <item>
  //                         <name>reachability</name>
  //                         <status>passed</status>
  //                     </item>
  //                 </details>
  //             </systemStatus>
  //             <instanceStatus>
  //                 <status>insufficient-data</status>
  //                 <details>
  //                     <item>
  //                         <name>reachability</name>
  //                         <status>insufficient-data</status>
  //                     </item>
  //                 </details>
  //             </instanceStatus>
  //          </item>
  //     </instanceStatusSet>
  // </DescribeInstanceStatusResponse>
}