---
title: "GET /v1/gateway-instances/{gatewayInstanceArn}"
method: GET
path: "/v1/gateway-instances/{gatewayInstanceArn}"
---

# GET /v1/gateway-instances/{gatewayInstanceArn}

`GET /v1/gateway-instances/{gatewayInstanceArn}`

Displays the details of an instance.

## Path parameters

- `gatewayInstanceArn` string, required

## Response `200`

Success

- DescribeGatewayInstanceResponse
  - `GatewayInstance` object — The settings for an instance in a gateway.
    - `BridgePlacement` 'AVAILABLE' | 'LOCKED', required — The availability of the instance to host new bridges. The bridgePlacement property can be LOCKED or AVAILABLE. If it is LOCKED, no new bridges can be deployed to this instance. If it is AVAILABLE, new bridges can be added to this instance.
    - `ConnectionStatus` 'CONNECTED' | 'DISCONNECTED', required — The connection state of the instance.
    - `GatewayArn` string, required — The Amazon Resource Name (ARN) of the instance.
    - `GatewayInstanceArn` string, required — The Amazon Resource Name (ARN) of the gateway.
    - `InstanceId` string, required — The managed instance ID generated by the SSM install. This will begin with "mi-".
    - `InstanceMessages` MessageDetail[]
      - `Code` string, required — The error code.
      - `Message` string, required — The specific error message that MediaConnect returns to help you understand the reason that the request did not succeed.
      - `ResourceName` string — The name of the resource.
    - `InstanceState` 'REGISTERING' | 'ACTIVE' | 'DEREGISTERING' | 'DEREGISTERED' | 'REGISTRATION_ERROR' | 'DEREGISTRATION_ERROR', required — The status of the instance.
    - `RunningBridgeCount` integer, required — The running bridge count.

## Other responses

- `480` — BadRequestException
- `481` — InternalServerErrorException
- `482` — ForbiddenException
- `483` — NotFoundException
- `484` — ServiceUnavailableException
- `485` — TooManyRequestsException
- `486` — ConflictException

---

[API](https://skmtc.net/aws/apis/mediaconnect.md) · [All operations](https://skmtc.net/aws/apis/mediaconnect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/mediaconnect/versions/695822d698d7/schema)