SyntheticsClient
Index > Synthetics > SyntheticsClient
Auto-generated documentation for Synthetics type annotations stubs module mypy-boto3-synthetics.
SyntheticsClient
Type annotations and code completion for boto3.client("synthetics")
.
boto3 documentation
from boto3.session import Session
from mypy_boto3_synthetics.client import SyntheticsClient
def get_synthetics_client() -> SyntheticsClient:
return Session().client("synthetics")
Exceptions
boto3
client exceptions are generated in runtime.
This class provides code completion for boto3.client("synthetics").exceptions
structure.
client = boto3.client("synthetics")
try:
do_something(client)
except (
client.BadRequestException,
client.ClientError,
client.ConflictException,
client.InternalFailureException,
client.InternalServerException,
client.NotFoundException,
client.RequestEntityTooLargeException,
client.ResourceNotFoundException,
client.ServiceQuotaExceededException,
client.TooManyRequestsException,
client.ValidationException,
) as e:
print(e)
from mypy_boto3_synthetics.client import Exceptions
def handle_error(exc: Exceptions.BadRequestException) -> None:
...
Methods
associate_resource
Associates a canary with a group.
Type annotations and code completion for boto3.client("synthetics").associate_resource
method.
boto3 documentation
def associate_resource(
self,
*,
GroupIdentifier: str,
ResourceArn: str,
) -> Dict[str, Any]:
...
kwargs: AssociateResourceRequestRequestTypeDef = { # (1)
"GroupIdentifier": ...,
"ResourceArn": ...,
}
parent.associate_resource(**kwargs)
can_paginate
Check if an operation can be paginated.
Type annotations and code completion for boto3.client("synthetics").can_paginate
method.
boto3 documentation
close
Closes underlying endpoint connections.
Type annotations and code completion for boto3.client("synthetics").close
method.
boto3 documentation
create_canary
Creates a canary.
Type annotations and code completion for boto3.client("synthetics").create_canary
method.
boto3 documentation
def create_canary(
self,
*,
Name: str,
Code: CanaryCodeInputTypeDef, # (1)
ArtifactS3Location: str,
ExecutionRoleArn: str,
Schedule: CanaryScheduleInputTypeDef, # (2)
RuntimeVersion: str,
RunConfig: CanaryRunConfigInputTypeDef = ..., # (3)
SuccessRetentionPeriodInDays: int = ...,
FailureRetentionPeriodInDays: int = ...,
VpcConfig: VpcConfigInputTypeDef = ..., # (4)
Tags: Mapping[str, str] = ...,
ArtifactConfig: ArtifactConfigInputTypeDef = ..., # (5)
) -> CreateCanaryResponseTypeDef: # (6)
...
- See CanaryCodeInputTypeDef
- See CanaryScheduleInputTypeDef
- See CanaryRunConfigInputTypeDef
- See VpcConfigInputTypeDef
- See ArtifactConfigInputTypeDef
- See CreateCanaryResponseTypeDef
kwargs: CreateCanaryRequestRequestTypeDef = { # (1)
"Name": ...,
"Code": ...,
"ArtifactS3Location": ...,
"ExecutionRoleArn": ...,
"Schedule": ...,
"RuntimeVersion": ...,
}
parent.create_canary(**kwargs)
create_group
Creates a group which you can use to associate canaries with each other, including cross-Region canaries.
Type annotations and code completion for boto3.client("synthetics").create_group
method.
boto3 documentation
def create_group(
self,
*,
Name: str,
Tags: Mapping[str, str] = ...,
) -> CreateGroupResponseTypeDef: # (1)
...
kwargs: CreateGroupRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.create_group(**kwargs)
delete_canary
Permanently deletes the specified canary.
Type annotations and code completion for boto3.client("synthetics").delete_canary
method.
boto3 documentation
def delete_canary(
self,
*,
Name: str,
DeleteLambda: bool = ...,
) -> Dict[str, Any]:
...
kwargs: DeleteCanaryRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.delete_canary(**kwargs)
delete_group
Deletes a group.
Type annotations and code completion for boto3.client("synthetics").delete_group
method.
boto3 documentation
kwargs: DeleteGroupRequestRequestTypeDef = { # (1)
"GroupIdentifier": ...,
}
parent.delete_group(**kwargs)
describe_canaries
This operation returns a list of the canaries in your account, along with full details about each canary.
Type annotations and code completion for boto3.client("synthetics").describe_canaries
method.
boto3 documentation
def describe_canaries(
self,
*,
NextToken: str = ...,
MaxResults: int = ...,
Names: Sequence[str] = ...,
) -> DescribeCanariesResponseTypeDef: # (1)
...
kwargs: DescribeCanariesRequestRequestTypeDef = { # (1)
"NextToken": ...,
}
parent.describe_canaries(**kwargs)
describe_canaries_last_run
Use this operation to see information from the most recent run of each canary that you have created.
Type annotations and code completion for boto3.client("synthetics").describe_canaries_last_run
method.
boto3 documentation
def describe_canaries_last_run(
self,
*,
NextToken: str = ...,
MaxResults: int = ...,
Names: Sequence[str] = ...,
) -> DescribeCanariesLastRunResponseTypeDef: # (1)
...
kwargs: DescribeCanariesLastRunRequestRequestTypeDef = { # (1)
"NextToken": ...,
}
parent.describe_canaries_last_run(**kwargs)
describe_runtime_versions
Returns a list of Synthetics canary runtime versions.
Type annotations and code completion for boto3.client("synthetics").describe_runtime_versions
method.
boto3 documentation
def describe_runtime_versions(
self,
*,
NextToken: str = ...,
MaxResults: int = ...,
) -> DescribeRuntimeVersionsResponseTypeDef: # (1)
...
kwargs: DescribeRuntimeVersionsRequestRequestTypeDef = { # (1)
"NextToken": ...,
}
parent.describe_runtime_versions(**kwargs)
disassociate_resource
Removes a canary from a group.
Type annotations and code completion for boto3.client("synthetics").disassociate_resource
method.
boto3 documentation
def disassociate_resource(
self,
*,
GroupIdentifier: str,
ResourceArn: str,
) -> Dict[str, Any]:
...
kwargs: DisassociateResourceRequestRequestTypeDef = { # (1)
"GroupIdentifier": ...,
"ResourceArn": ...,
}
parent.disassociate_resource(**kwargs)
generate_presigned_url
Generate a presigned url given a client, its method, and arguments.
Type annotations and code completion for boto3.client("synthetics").generate_presigned_url
method.
boto3 documentation
def generate_presigned_url(
self,
ClientMethod: str,
Params: Mapping[str, Any] = ...,
ExpiresIn: int = 3600,
HttpMethod: str = ...,
) -> str:
...
get_canary
Retrieves complete information about one canary.
Type annotations and code completion for boto3.client("synthetics").get_canary
method.
boto3 documentation
kwargs: GetCanaryRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.get_canary(**kwargs)
get_canary_runs
Retrieves a list of runs for a specified canary.
Type annotations and code completion for boto3.client("synthetics").get_canary_runs
method.
boto3 documentation
def get_canary_runs(
self,
*,
Name: str,
NextToken: str = ...,
MaxResults: int = ...,
) -> GetCanaryRunsResponseTypeDef: # (1)
...
kwargs: GetCanaryRunsRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.get_canary_runs(**kwargs)
get_group
Returns information about one group.
Type annotations and code completion for boto3.client("synthetics").get_group
method.
boto3 documentation
def get_group(
self,
*,
GroupIdentifier: str,
) -> GetGroupResponseTypeDef: # (1)
...
kwargs: GetGroupRequestRequestTypeDef = { # (1)
"GroupIdentifier": ...,
}
parent.get_group(**kwargs)
list_associated_groups
Returns a list of the groups that the specified canary is associated with.
Type annotations and code completion for boto3.client("synthetics").list_associated_groups
method.
boto3 documentation
def list_associated_groups(
self,
*,
ResourceArn: str,
NextToken: str = ...,
MaxResults: int = ...,
) -> ListAssociatedGroupsResponseTypeDef: # (1)
...
kwargs: ListAssociatedGroupsRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
}
parent.list_associated_groups(**kwargs)
list_group_resources
This operation returns a list of the ARNs of the canaries that are associated with the specified group.
Type annotations and code completion for boto3.client("synthetics").list_group_resources
method.
boto3 documentation
def list_group_resources(
self,
*,
GroupIdentifier: str,
NextToken: str = ...,
MaxResults: int = ...,
) -> ListGroupResourcesResponseTypeDef: # (1)
...
kwargs: ListGroupResourcesRequestRequestTypeDef = { # (1)
"GroupIdentifier": ...,
}
parent.list_group_resources(**kwargs)
list_groups
Returns a list of all groups in the account, displaying their names, unique IDs, and ARNs.
Type annotations and code completion for boto3.client("synthetics").list_groups
method.
boto3 documentation
def list_groups(
self,
*,
NextToken: str = ...,
MaxResults: int = ...,
) -> ListGroupsResponseTypeDef: # (1)
...
kwargs: ListGroupsRequestRequestTypeDef = { # (1)
"NextToken": ...,
}
parent.list_groups(**kwargs)
list_tags_for_resource
Displays the tags associated with a canary or group.
Type annotations and code completion for boto3.client("synthetics").list_tags_for_resource
method.
boto3 documentation
def list_tags_for_resource(
self,
*,
ResourceArn: str,
) -> ListTagsForResourceResponseTypeDef: # (1)
...
kwargs: ListTagsForResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
}
parent.list_tags_for_resource(**kwargs)
start_canary
Use this operation to run a canary that has already been created.
Type annotations and code completion for boto3.client("synthetics").start_canary
method.
boto3 documentation
kwargs: StartCanaryRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.start_canary(**kwargs)
stop_canary
Stops the canary to prevent all future runs.
Type annotations and code completion for boto3.client("synthetics").stop_canary
method.
boto3 documentation
kwargs: StopCanaryRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.stop_canary(**kwargs)
tag_resource
Assigns one or more tags (key-value pairs) to the specified canary or group.
Type annotations and code completion for boto3.client("synthetics").tag_resource
method.
boto3 documentation
def tag_resource(
self,
*,
ResourceArn: str,
Tags: Mapping[str, str],
) -> Dict[str, Any]:
...
kwargs: TagResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
"Tags": ...,
}
parent.tag_resource(**kwargs)
untag_resource
Removes one or more tags from the specified resource.
Type annotations and code completion for boto3.client("synthetics").untag_resource
method.
boto3 documentation
def untag_resource(
self,
*,
ResourceArn: str,
TagKeys: Sequence[str],
) -> Dict[str, Any]:
...
kwargs: UntagResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
"TagKeys": ...,
}
parent.untag_resource(**kwargs)
update_canary
Updates the configuration of a canary that has already been created.
Type annotations and code completion for boto3.client("synthetics").update_canary
method.
boto3 documentation
def update_canary(
self,
*,
Name: str,
Code: CanaryCodeInputTypeDef = ..., # (1)
ExecutionRoleArn: str = ...,
RuntimeVersion: str = ...,
Schedule: CanaryScheduleInputTypeDef = ..., # (2)
RunConfig: CanaryRunConfigInputTypeDef = ..., # (3)
SuccessRetentionPeriodInDays: int = ...,
FailureRetentionPeriodInDays: int = ...,
VpcConfig: VpcConfigInputTypeDef = ..., # (4)
VisualReference: VisualReferenceInputTypeDef = ..., # (5)
ArtifactS3Location: str = ...,
ArtifactConfig: ArtifactConfigInputTypeDef = ..., # (6)
) -> Dict[str, Any]:
...