Pyjo.AWS.Protocol.Query - Call of the query protocol of AWS¶
from Pyjo.AWS.Client import Client
from Pyjo.AWS.Protocol.Query import Query
dom = Client(service='sts').call(Query('GetCallerIdentity', version='2011-06-15'))
print(dom.at('Arn').text)
# Or import the module, as in Google Python Style Guide
import Pyjo.AWS.Client
import Pyjo.AWS.Protocol.Query
sqs = Pyjo.AWS.Client.new(service='sqs', region='eu-central-1')
call = Pyjo.AWS.Protocol.Query.new(
'SendMessage', {'QueueUrl': url, 'MessageBody': 'Hello', 'MessageAttribute.1.Name': 'From'},
version='2012-11-05',
)
sqs.call_p(call).then(lambda dom: print(dom.at('MessageId').text)).wait()
Pyjo.AWS.Protocol.Query is a call of the query protocol of AWS, of
the APIs of STS, IAM, SQS, SNS, CloudWatch, EC2 and others: a form of the
action, the version of the API and the parameters, posted to the endpoint,
whose response is XML, as a Pyjo.DOM object. The parameters are
flat, as the documentation of the API names them, as Tags.member.1.Key,
whose values are strings, true or false of booleans, and the
strings of the others.
The error of the response is the code and the message of its element
Error.
See also¶
Pyjo.AWS.Protocol, Pyjo.AWS.Client,
https://smithy.io/2.0/aws/protocols/aws-query-protocol.html.
Classes¶
- class Pyjo.AWS.Protocol.Query.Pyjo_AWS_Protocol_Query(action: str, params: Mapping[str, Any] | None = None, *, version: str)[source]¶
Pyjo.AWS.Protocol.Queryinherits all attributes and methods fromPyjo.AWS.Protocoland implements the following new ones.- __init__(action: str, params: Mapping[str, Any] | None = None, *, version: str) None[source]¶
call = Pyjo.AWS.Protocol.Query.new('GetCallerIdentity', version='2011-06-15') call = Pyjo.AWS.Protocol.Query.new('GetRole', {'RoleName': 'admin'}, version='2010-05-08')
Construct a new
Pyjo.AWS.Protocol.Queryobject.
- action¶
action = call.action
The action, as
AssumeRole.
- build_tx(ua: Pyjo_UserAgent, url: Pyjo_URL) Pyjo_Transaction_HTTP[source]¶
tx = call.build_tx(ua, url)
The transaction of a form posted to the endpoint.
- error(tx: Pyjo_Transaction_HTTP) Pyjo_AWS_Error[source]¶
e = call.error(tx)
The error of the element
Errorof the response.
- params¶
params = call.params
The parameters of the action, as the documentation of the API names them, whose
Nonevalues the request leaves out.
- parse(tx: Pyjo_Transaction_HTTP) Pyjo_DOM[source]¶
dom = call.parse(tx)
The XML of the response, as
<AssumeRoleResponse>, whose result is its element of the action, asAssumeRoleResult.
- version¶
version = call.version
The version of the API, as
2011-06-15of STS.