1{
2  "metadata" : {
3    "apiVersion" : "2018-11-29",
4    "endpointPrefix" : "execute-api",
5    "signingName" : "execute-api",
6    "serviceFullName" : "AmazonApiGatewayManagementApi",
7    "serviceId" : "ApiGatewayManagementApi",
8    "protocol" : "rest-json",
9    "jsonVersion" : "1.1",
10    "uid" : "apigatewaymanagementapi-2018-11-29",
11    "signatureVersion" : "v4"
12  },
13  "operations" : {
14    "DeleteConnection" : {
15      "name" : "DeleteConnection",
16      "http" : {
17        "method" : "DELETE",
18        "requestUri" : "/@connections/{connectionId}",
19        "responseCode" : 204
20      },
21      "input" : {
22        "shape" : "DeleteConnectionRequest"
23      },
24      "errors" : [ {
25        "shape" : "GoneException",
26        "documentation" : "<p>The connection with the provided id no longer exists.</p>"
27      }, {
28        "shape" : "LimitExceededException",
29        "documentation" : "<p>The client is sending more than the allowed number of requests per unit of time or the WebSocket client side buffer is full.</p>"
30      }, {
31        "shape" : "ForbiddenException",
32        "documentation" : "<p>The caller is not authorized to invoke this operation.</p>"
33      } ],
34      "documentation" : "<p>Delete the connection with the provided id.</p>"
35    },
36    "GetConnection" : {
37      "name" : "GetConnection",
38      "http" : {
39        "method" : "GET",
40        "requestUri" : "/@connections/{connectionId}",
41        "responseCode" : 200
42      },
43      "input" : {
44        "shape" : "GetConnectionRequest"
45      },
46      "output" : {
47        "shape" : "GetConnectionResponse"
48      },
49      "errors" : [ {
50        "shape" : "GoneException",
51        "documentation" : "<p>The connection with the provided id no longer exists.</p>"
52      }, {
53        "shape" : "LimitExceededException",
54        "documentation" : "<p>The client is sending more than the allowed number of requests per unit of time or the WebSocket client side buffer is full.</p>"
55      }, {
56        "shape" : "ForbiddenException",
57        "documentation" : "<p>The caller is not authorized to invoke this operation.</p>"
58      } ],
59      "documentation" : "<p>Get information about the connection with the provided id.</p>"
60    },
61    "PostToConnection" : {
62      "name" : "PostToConnection",
63      "http" : {
64        "method" : "POST",
65        "requestUri" : "/@connections/{connectionId}",
66        "responseCode" : 200
67      },
68      "input" : {
69        "shape" : "PostToConnectionRequest"
70      },
71      "errors" : [ {
72        "shape" : "GoneException",
73        "documentation" : "<p>The connection with the provided id no longer exists.</p>"
74      }, {
75        "shape" : "LimitExceededException",
76        "documentation" : "<p>The client is sending more than the allowed number of requests per unit of time or the WebSocket client side buffer is full.</p>"
77      }, {
78        "shape" : "PayloadTooLargeException",
79        "documentation" : "<p>The data has exceeded the maximum size allowed.</p>"
80      }, {
81        "shape" : "ForbiddenException",
82        "documentation" : "<p>The caller is not authorized to invoke this operation.</p>"
83      } ],
84      "documentation" : "<p>Sends the provided data to the specified connection.</p>"
85    }
86  },
87  "shapes" : {
88    "Data" : {
89      "type" : "blob",
90      "max" : 131072,
91      "documentation" : "<p>The data to be sent to the client specified by its connection id.</p>"
92    },
93    "DeleteConnectionRequest" : {
94      "type" : "structure",
95      "members" : {
96        "ConnectionId" : {
97          "shape" : "__string",
98          "location" : "uri",
99          "locationName" : "connectionId"
100        }
101      },
102      "required" : [ "ConnectionId" ]
103    },
104    "ForbiddenException" : {
105      "type" : "structure",
106      "members" : { },
107      "documentation" : "<p>The caller is not authorized to invoke this operation.</p>",
108      "exception" : true,
109      "error" : {
110        "httpStatusCode" : 403
111      }
112    },
113    "GetConnectionRequest" : {
114      "type" : "structure",
115      "members" : {
116        "ConnectionId" : {
117          "shape" : "__string",
118          "location" : "uri",
119          "locationName" : "connectionId"
120        }
121      },
122      "required" : [ "ConnectionId" ]
123    },
124    "GetConnectionResponse" : {
125      "type" : "structure",
126      "members" : {
127        "ConnectedAt" : {
128          "shape" : "__timestampIso8601",
129          "locationName" : "connectedAt",
130          "documentation" : "<p>The time in ISO 8601 format for when the connection was established.</p>"
131        },
132        "Identity" : {
133          "shape" : "Identity",
134          "locationName" : "identity"
135        },
136        "LastActiveAt" : {
137          "shape" : "__timestampIso8601",
138          "locationName" : "lastActiveAt",
139          "documentation" : "<p>The time in ISO 8601 format for when the connection was last active.</p>"
140        }
141      }
142    },
143    "GoneException" : {
144      "type" : "structure",
145      "members" : { },
146      "documentation" : "<p>The connection with the provided id no longer exists.</p>",
147      "exception" : true,
148      "error" : {
149        "httpStatusCode" : 410
150      }
151    },
152    "Identity" : {
153      "type" : "structure",
154      "members" : {
155        "SourceIp" : {
156          "shape" : "__string",
157          "locationName" : "sourceIp",
158          "documentation" : "<p>The source IP address of the TCP connection making the request to API Gateway.</p>"
159        },
160        "UserAgent" : {
161          "shape" : "__string",
162          "locationName" : "userAgent",
163          "documentation" : "<p>The User Agent of the API caller.</p>"
164        }
165      },
166      "required" : [ "SourceIp", "UserAgent" ]
167    },
168    "PayloadTooLargeException" : {
169      "type" : "structure",
170      "members" : {
171        "Message" : {
172          "shape" : "__string",
173          "locationName" : "message"
174        }
175      },
176      "documentation" : "<p>The data has exceeded the maximum size allowed.</p>",
177      "exception" : true,
178      "error" : {
179        "httpStatusCode" : 413
180      }
181    },
182    "PostToConnectionRequest" : {
183      "type" : "structure",
184      "members" : {
185        "Data" : {
186          "shape" : "Data",
187          "documentation" : "<p>The data to be sent to the client specified by its connection id.</p>"
188        },
189        "ConnectionId" : {
190          "shape" : "__string",
191          "location" : "uri",
192          "locationName" : "connectionId",
193          "documentation" : "<p>The identifier of the connection that a specific client is using.</p>"
194        }
195      },
196      "required" : [ "ConnectionId", "Data" ],
197      "payload" : "Data"
198    },
199    "LimitExceededException" : {
200      "type" : "structure",
201      "members" : { },
202      "documentation" : "<p>The client is sending more than the allowed number of requests per unit of time or the WebSocket client side buffer is full.</p>",
203      "exception" : true,
204      "error" : {
205        "httpStatusCode" : 429
206      }
207    },
208    "__string" : {
209      "type" : "string"
210    },
211    "__timestampIso8601" : {
212      "type" : "timestamp",
213      "timestampFormat" : "iso8601"
214    }
215  },
216  "documentation" : "<p>The Amazon API Gateway Management API allows you to directly manage runtime aspects of your deployed APIs. To use it, you must explicitly set the SDK's endpoint to point to the endpoint of your deployed API. The endpoint will be of the form https://{api-id}.execute-api.{region}.amazonaws.com/{stage}, or will be the endpoint corresponding to your API's custom domain and base path, if applicable.</p>"
217}