opsworks_describe_instances: Requests a description of a set of instances

Description Usage Arguments Value Request syntax

View source: R/opsworks_operations.R

Description

Requests a description of a set of instances.

This call accepts only one resource-identifying parameter.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

Usage

1
opsworks_describe_instances(StackId, LayerId, InstanceIds)

Arguments

StackId

A stack ID. If you use this parameter, describe_instances returns descriptions of the instances associated with the specified stack.

LayerId

A layer ID. If you use this parameter, describe_instances returns descriptions of the instances associated with the specified layer.

InstanceIds

An array of instance IDs to be described. If you use this parameter, describe_instances returns a description of the specified instances. Otherwise, it returns a description of every instance.

Value

A list with the following syntax:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
list(
  Instances = list(
    list(
      AgentVersion = "string",
      AmiId = "string",
      Architecture = "x86_64"|"i386",
      Arn = "string",
      AutoScalingType = "load"|"timer",
      AvailabilityZone = "string",
      BlockDeviceMappings = list(
        list(
          DeviceName = "string",
          NoDevice = "string",
          VirtualName = "string",
          Ebs = list(
            SnapshotId = "string",
            Iops = 123,
            VolumeSize = 123,
            VolumeType = "gp2"|"io1"|"standard",
            DeleteOnTermination = TRUE|FALSE
          )
        )
      ),
      CreatedAt = "string",
      EbsOptimized = TRUE|FALSE,
      Ec2InstanceId = "string",
      EcsClusterArn = "string",
      EcsContainerInstanceArn = "string",
      ElasticIp = "string",
      Hostname = "string",
      InfrastructureClass = "string",
      InstallUpdatesOnBoot = TRUE|FALSE,
      InstanceId = "string",
      InstanceProfileArn = "string",
      InstanceType = "string",
      LastServiceErrorId = "string",
      LayerIds = list(
        "string"
      ),
      Os = "string",
      Platform = "string",
      PrivateDns = "string",
      PrivateIp = "string",
      PublicDns = "string",
      PublicIp = "string",
      RegisteredBy = "string",
      ReportedAgentVersion = "string",
      ReportedOs = list(
        Family = "string",
        Name = "string",
        Version = "string"
      ),
      RootDeviceType = "ebs"|"instance-store",
      RootDeviceVolumeId = "string",
      SecurityGroupIds = list(
        "string"
      ),
      SshHostDsaKeyFingerprint = "string",
      SshHostRsaKeyFingerprint = "string",
      SshKeyName = "string",
      StackId = "string",
      Status = "string",
      SubnetId = "string",
      Tenancy = "string",
      VirtualizationType = "paravirtual"|"hvm"
    )
  )
)

Request syntax

1
2
3
4
5
6
7
svc$describe_instances(
  StackId = "string",
  LayerId = "string",
  InstanceIds = list(
    "string"
  )
)

paws.management documentation built on Aug. 23, 2021, 9:11 a.m.