software.amazon.awscdk.integtests

Interface IAwsApiCall

All Superinterfaces:

IConstruct, IDependable

All Known Subinterfaces:

IAwsApiCall.Jsii$Default

All Known Implementing Classes:

AwsApiCall, IAwsApiCall.Jsii$Proxy, LambdaInvokeFunction

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-22T19:35:40.880Z")
public interface IAwsApiCall
extends IConstruct

(experimental) Interface for creating a custom resource that will perform an API call using the AWS SDK.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	IAwsApiCall.Jsii$Default Internal default implementation for IAwsApiCall.
static class	IAwsApiCall.Jsii$Proxy A proxy class which represents a concrete javascript instance of this type.

Method Summary

Modifier and Type	Method and Description
void	assertAtPath(java.lang.String path, ExpectedResult expected) (experimental) Assert that the ExpectedResult is equal to the result of the AwsApiCall at the given path.
void	expect(ExpectedResult expected) (experimental) Assert that the ExpectedResult is equal to the result of the AwsApiCall.
Reference	getAtt(java.lang.String attributeName) (experimental) Returns the value of an attribute of the custom resource of an arbitrary type.
java.lang.String	getAttString(java.lang.String attributeName) (experimental) Returns the value of an attribute of the custom resource of type string.

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Method Detail

assertAtPath

void assertAtPath(java.lang.String path,
                  ExpectedResult expected)

(experimental) Assert that the ExpectedResult is equal to the result of the AwsApiCall at the given path.

For example the SQS.receiveMessage api response would look like:

If you wanted to assert the value of Body you could do

Example:

 IntegTest integ;
 Map<String, Map<String, Object>[]> actual = Map.of(
         "Messages", List.of(Map.of(
                 "MessageId", "",
                 "ReceiptHandle", "",
                 "MD5OfBody", "",
                 "Body", "hello",
                 "Attributes", Map.of(),
                 "MD5OfMessageAttributes", Map.of(),
                 "MessageAttributes", Map.of())));
 IAwsApiCall message = integ.assertions.awsApiCall("SQS", "receiveMessage");
 message.assertAtPath("Messages.0.Body", ExpectedResult.stringLikeRegexp("hello"));
 

Parameters:

path - This parameter is required.

expected - This parameter is required.

expect

void expect(ExpectedResult expected)

(experimental) Assert that the ExpectedResult is equal to the result of the AwsApiCall.

Example:

 IntegTest integ;
 IAwsApiCall invoke = integ.assertions.invokeFunction(LambdaInvokeFunctionProps.builder()
         .functionName("my-func")
         .build());
 invoke.expect(ExpectedResult.objectLike(Map.of("Payload", "OK")));
 

Parameters:

expected - This parameter is required.

getAtt

Reference getAtt(java.lang.String attributeName)

(experimental) Returns the value of an attribute of the custom resource of an arbitrary type.

Attributes are returned from the custom resource provider through the Data map where the key is the attribute name.

Parameters:

attributeName - the name of the attribute. This parameter is required.

Returns:

a token for `Fn::GetAtt`. Use `Token.asXxx` to encode the returned `Reference` as a specific type or use the convenience `getAttString` for string attributes.

getAttString

java.lang.String getAttString(java.lang.String attributeName)

(experimental) Returns the value of an attribute of the custom resource of type string.

Attributes are returned from the custom resource provider through the Data map where the key is the attribute name.

Parameters:

attributeName - the name of the attribute. This parameter is required.

Returns:

a token for `Fn::GetAtt` encoded as a string.