1**Example 1: To list all service instances**
2
3The following ``list-service-instances`` example lists service instances. ::
4
5    aws proton list-service-instances
6
7Output::
8
9    {
10        "serviceInstances": [
11            {
12                "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
13                "createdAt": "2020-11-28T22:40:50.512000+00:00",
14                "deploymentStatus": "SUCCEEDED",
15                "environmentArn": "arn:aws:proton:region-id:123456789012:environment/simple-env",
16                "lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00",
17                "lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00",
18                "name": "instance-one",
19                "serviceName": "simple-svc",
20                "templateMajorVersion": "1",
21                "templateMinorVersion": "0",
22                "templateName": "fargate-service"
23            }
24        ]
25    }
26
27For more information, see `View service instance data <https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-instance-view.html>`__ in the *The AWS Proton Administrator Guide* or `View service instance data <https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-instance-view.html>`__ in the *The AWS Proton User Guide*.
28
29**Example 2: To list the specified service instance**
30
31The following ``get-service-instance`` example gets a service instance. ::
32
33    aws proton get-service-instance \
34        --name "instance-one" \
35        --service-name "simple-svc"
36
37Output::
38
39    {
40        "serviceInstance": {
41            "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
42            "createdAt": "2020-11-28T22:40:50.512000+00:00",
43            "deploymentStatus": "SUCCEEDED",
44            "environmentName": "simple-env",
45            "lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00",
46            "lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00",
47            "name": "instance-one",
48            "serviceName": "simple-svc",
49            "spec": "proton: ServiceSpec\npipeline:\n  my_sample_pipeline_optional_input: hello world\n  my_sample_pipeline_required_input: pipeline up\ninstances:\n- name: instance-one\n  environment: my-simple-env\n  spec:\n    my_sample_service_instance_optional_input: Ola\n    my_sample_service_instance_required_input: Ciao\n",
50            "templateMajorVersion": "1",
51            "templateMinorVersion": "0",
52            "templateName": "svc-simple"
53        }
54    }
55
56For more information, see `View service instance data <https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-instance-view.html>`__ in the *The AWS Proton Administrator Guide* or `View service instance data <https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-instance-view.html>`__ in the *The AWS Proton User Guide*.
57