如何从命令行向AWS AppSync发送GraphQL查询？

Question

AWS CLI for AppSync有一系列可爱的功能，可以从工作站的命令行远程管理它，因此我基本上不必使用浏览器控制台。

但要进行查询，我必须进入web浏览器控制台，在AppSync下查找GraphQl查询。我可以通过CLI更改所有方式，但我找不到一个简单地发出graphql查询的命令。

我错过了吗？它在那里吗<我不想再看这个屏幕了。。。

Answer 1

您可以使用Curl执行此操作：

$ curl -H 'x-api-key: <API KEY>' -d '{"query":"query {...}"}' <API URL>

Answer 2

graphql python/gql自版本3.0.0rc0起支持AWS AppSync。

它支持实时endpoint上的查询、变异甚至订阅。

它支持IAM、api密钥和JWT身份验证方法。

它有一个gqlcli脚本，允许您从命令行执行查询、更改和订阅。

这里有留档

对于查询和突变，请使用--transport-appsync_-http参数：

# Put the request in a file
$ echo 'mutation createMessage($message: String!) {
  createMessage(input: {message: $message}) {
    id
    message
    createdAt
  }
}' > mutation.graphql

# Execute the request using gql-cli with --transport appsync_http
$ cat mutation.graphql | gql-cli $AWS_GRAPHQL_API_ENDPOINT --transport appsync_http -V message:"Hello world!"

对于订阅，请使用--transport-appsync\u-websockets参数：

echo "subscription{onCreateMessage{message}}" | gql-cli $AWS_GRAPHQL_API_ENDPOINT --transport appsync_websockets

Answer 3

Appsync查询页面实际上是几件事情的结合。您不能根据从CLI发出查询(https://docs.aws.amazon.com/cli/latest/reference/appsync/index.html)

但是，您可以使用GUI客户端工具向Appsyncendpoint发送POST。比如邮递员或者失眠（我个人最喜欢的）。然而，如果您的目标是通过CLI真正发送符合GraphQL的查询，那么您将不得不求助于“curl”

下面是一个示例Python脚本，它向我的Appsync API发送curl请求。

#!/usr/bin/env python3
import os

cmd = """curl -i -H 'Content-Type: application/json' -H "x-api-key: <ENTER YOUR API KEY FROM THE APPSYNC SETTINGS PAGE>" -H "Host: <ENTER YOUR HOST ENDPOINT FROM THE APPSYNC API SETTINGS PAGE >" -X POST -d '{"query": "query {listEvents {items {id}}}"}' https://<ENTER YOUR HOST ENDPOINT FROM THE APPSYNC API SETTINGS PAGE>/graphql"""

def doGraphqlRequest():    
    os.system(cmd)

print("Starting request to Appsync endpoint")
doGraphQLRequest()
print("Finsihed request to Appsync endpoint")

为了解释一下，您正在使用对给定'/graphql/endpoint'的appsync的查询发出POST请求。您有3个标题（由-H标志表示）

1. x-api-key：仅适用于使用API KEY作为授权类型的情况。其他身份验证类型也可以工作，你可能有一个AuthToken：承载，Cognito也可以工作，但从CLI
来看要复杂得多
2. 主机：这是你的api给出的ec2主机的名字。您可以通过查看分配的终结点并删除https：//和 /graphql
3. 内容类型：应用程序/json。这是一种标准，不太确定为什么，但它是必须的。

希望这能有所帮助！