SNSServiceResource

Index > SNS > SNSServiceResource

Auto-generated documentation for SNS type annotations stubs module mypy-boto3-sns.

SNSServiceResource

Type annotations and code completion for boto3.resource("sns"), included resources and collections. boto3 documentation

# SNSServiceResource usage example

from mypy_boto3_sns.service_resource import SNSServiceResource

def get_sns_resource() -> SNSServiceResource:
    return boto3.resource("sns")

Attributes

• meta: SNSResourceMeta

• platform_applications: ServiceResourcePlatformApplicationsCollection

• subscriptions: ServiceResourceSubscriptionsCollection

• topics: ServiceResourceTopicsCollection

Collections

ServiceResourcePlatformApplicationsCollection

Provides access to PlatformApplication resource.

Type annotations and code completion for boto3.resource("sns").platform_applications collection. boto3 documentation

# ServiceResourcePlatformApplicationsCollection usage example

from mypy_boto3_sns.service_resource import ServiceResourcePlatformApplicationsCollection

def get_collection() -> ServiceResourcePlatformApplicationsCollection:
    return boto3.resource("sns").platform_applications

ServiceResourceSubscriptionsCollection

Provides access to Subscription resource.

Type annotations and code completion for boto3.resource("sns").subscriptions collection. boto3 documentation

# ServiceResourceSubscriptionsCollection usage example

from mypy_boto3_sns.service_resource import ServiceResourceSubscriptionsCollection

def get_collection() -> ServiceResourceSubscriptionsCollection:
    return boto3.resource("sns").subscriptions

ServiceResourceTopicsCollection

Provides access to Topic resource.

Type annotations and code completion for boto3.resource("sns").topics collection. boto3 documentation

# ServiceResourceTopicsCollection usage example

from mypy_boto3_sns.service_resource import ServiceResourceTopicsCollection

def get_collection() -> ServiceResourceTopicsCollection:
    return boto3.resource("sns").topics

Methods

SNSServiceResource.PlatformApplication method

Creates a PlatformApplication resource.

Type annotations and code completion for boto3.resource("sns").PlatformApplication method. boto3 documentation

# PlatformApplication method definition

def PlatformApplication(
    self,
    arn: str,
) -> PlatformApplication:
    ...

SNSServiceResource.PlatformEndpoint method

Creates a PlatformEndpoint resource.

Type annotations and code completion for boto3.resource("sns").PlatformEndpoint method. boto3 documentation

# PlatformEndpoint method definition

def PlatformEndpoint(
    self,
    arn: str,
) -> PlatformEndpoint:
    ...

SNSServiceResource.Subscription method

Creates a Subscription resource.

Type annotations and code completion for boto3.resource("sns").Subscription method. boto3 documentation

# Subscription method definition

def Subscription(
    self,
    arn: str,
) -> Subscription:
    ...

SNSServiceResource.Topic method

Creates a Topic resource.

Type annotations and code completion for boto3.resource("sns").Topic method. boto3 documentation

# Topic method definition

def Topic(
    self,
    arn: str,
) -> Topic:
    ...

SNSServiceResource.create_platform_application method

Creates a platform application object for one of the supported push notification services, such as APNS and GCM (Firebase Cloud Messaging), to which devices and mobile apps may register.

Type annotations and code completion for boto3.resource("sns").create_platform_application method. boto3 documentation

# create_platform_application method definition

def create_platform_application(
    self,
    *,
    Name: str,
    Platform: str,
    Attributes: Mapping[str, str],
) -> PlatformApplication:
    ...

# create_platform_application method usage example with argument unpacking

kwargs: CreatePlatformApplicationInputServiceResourceCreatePlatformApplicationTypeDef = {  # (1)
    "Name": ...,
    "Platform": ...,
    "Attributes": ...,
}

parent.create_platform_application(**kwargs)

1. See CreatePlatformApplicationInputServiceResourceCreatePlatformApplicationTypeDef

SNSServiceResource.create_topic method

Creates a topic to which notifications can be published.

Type annotations and code completion for boto3.resource("sns").create_topic method. boto3 documentation

# create_topic method definition

def create_topic(
    self,
    *,
    Name: str,
    Attributes: Mapping[str, str] = ...,
    Tags: Sequence[TagTypeDef] = ...,  # (1)
    DataProtectionPolicy: str = ...,
) -> Topic:
    ...

1. See TagTypeDef

# create_topic method usage example with argument unpacking

kwargs: CreateTopicInputServiceResourceCreateTopicTypeDef = {  # (1)
    "Name": ...,
}

parent.create_topic(**kwargs)

1. See CreateTopicInputServiceResourceCreateTopicTypeDef

SNSServiceResource.get_available_subresources method

Returns a list of all the available sub-resources for this Resource.

Type annotations and code completion for boto3.resource("sns").get_available_subresources method. boto3 documentation

# get_available_subresources method definition

def get_available_subresources(
    self,
) -> Sequence[str]:
    ...

PlatformApplication

Type annotations and code completion for boto3.resource("sns").PlatformApplication class. boto3 documentation

# PlatformApplication usage example

from mypy_boto3_sns.service_resource import PlatformApplication

def get_resource() -> PlatformApplication:
    return boto3.resource("sns").PlatformApplication(...)

PlatformApplication attributes

• attributes: Dict[str, str]
• arn: str
• endpoints: PlatformApplicationEndpointsCollection

PlatformApplication collections

PlatformApplication.endpoints

Provides access to PlatformEndpoint resource.

Type annotations and code completion for boto3.resource("sns").PlatformApplication(...).endpoints collection. boto3 documentation

# PlatformApplicationEndpointsCollection usage example

from mypy_boto3_sns.service_resource import PlatformApplicationEndpointsCollection

def get_collection() -> PlatformApplicationEndpointsCollection:
    resource = boto3.resource("sns").PlatformApplication(...)
    return resource.endpoints

PlatformApplication methods

PlatformApplication.create_platform_endpoint method

Creates an endpoint for a device and mobile app on one of the supported push notification services, such as GCM (Firebase Cloud Messaging) and APNS.

Type annotations and code completion for boto3.resource("sns").create_platform_endpoint method. boto3 documentation

# create_platform_endpoint method definition

def create_platform_endpoint(
    self,
    *,
    Token: str,
    CustomUserData: str = ...,
    Attributes: Mapping[str, str] = ...,
) -> PlatformEndpoint:
    ...

# create_platform_endpoint method usage example with argument unpacking

kwargs: CreatePlatformEndpointInputPlatformApplicationCreatePlatformEndpointTypeDef = {  # (1)
    "Token": ...,
}

parent.create_platform_endpoint(**kwargs)

1. See CreatePlatformEndpointInputPlatformApplicationCreatePlatformEndpointTypeDef

PlatformApplication.delete method

Deletes a platform application object for one of the supported push notification services, such as APNS and GCM (Firebase Cloud Messaging).

Type annotations and code completion for boto3.resource("sns").delete method. boto3 documentation

# delete method definition

def delete(
    self,
) -> None:
    ...

PlatformApplication.get_available_subresources method

Returns a list of all the available sub-resources for this Resource.

Type annotations and code completion for boto3.resource("sns").get_available_subresources method. boto3 documentation

# get_available_subresources method definition

def get_available_subresources(
    self,
) -> Sequence[str]:
    ...

PlatformApplication.load method

Calls meth:SNS.Client.get_platform_application_attributes to update the attributes of the PlatformApplication resource.

Type annotations and code completion for boto3.resource("sns").load method. boto3 documentation

# load method definition

def load(
    self,
) -> None:
    ...

PlatformApplication.reload method

Calls meth:SNS.Client.get_platform_application_attributes to update the attributes of the PlatformApplication resource.

Type annotations and code completion for boto3.resource("sns").reload method. boto3 documentation

# reload method definition

def reload(
    self,
) -> None:
    ...

PlatformApplication.set_attributes method

Sets the attributes of the platform application object for the supported push notification services, such as APNS and GCM (Firebase Cloud Messaging).

Type annotations and code completion for boto3.resource("sns").set_attributes method. boto3 documentation

# set_attributes method definition

def set_attributes(
    self,
    *,
    Attributes: Mapping[str, str],
) -> None:
    ...

# set_attributes method usage example with argument unpacking

kwargs: SetPlatformApplicationAttributesInputPlatformApplicationSetAttributesTypeDef = {  # (1)
    "Attributes": ...,
}

parent.set_attributes(**kwargs)

1. See SetPlatformApplicationAttributesInputPlatformApplicationSetAttributesTypeDef

PlatformEndpoint

Type annotations and code completion for boto3.resource("sns").PlatformEndpoint class. boto3 documentation

# PlatformEndpoint usage example

from mypy_boto3_sns.service_resource import PlatformEndpoint

def get_resource() -> PlatformEndpoint:
    return boto3.resource("sns").PlatformEndpoint(...)

PlatformEndpoint attributes

• attributes: Dict[str, str]
• arn: str

PlatformEndpoint methods

PlatformEndpoint.delete method

Deletes the endpoint for a device and mobile app from Amazon SNS.

Type annotations and code completion for boto3.resource("sns").delete method. boto3 documentation

# delete method definition

def delete(
    self,
) -> None:
    ...

PlatformEndpoint.get_available_subresources method

Returns a list of all the available sub-resources for this Resource.

Type annotations and code completion for boto3.resource("sns").get_available_subresources method. boto3 documentation

# get_available_subresources method definition

def get_available_subresources(
    self,
) -> Sequence[str]:
    ...

PlatformEndpoint.load method

Calls meth:SNS.Client.get_endpoint_attributes to update the attributes of the PlatformEndpoint resource.

Type annotations and code completion for boto3.resource("sns").load method. boto3 documentation

# load method definition

def load(
    self,
) -> None:
    ...

PlatformEndpoint.publish method

Sends a message to an Amazon SNS topic, a text message (SMS message) directly to a phone number, or a message to a mobile platform endpoint (when you specify the TargetArn).

Type annotations and code completion for boto3.resource("sns").publish method. boto3 documentation

# publish method definition

def publish(
    self,
    *,
    Message: str,
    TopicArn: str = ...,
    PhoneNumber: str = ...,
    Subject: str = ...,
    MessageStructure: str = ...,
    MessageAttributes: Mapping[str, MessageAttributeValueTypeDef] = ...,  # (1)
    MessageDeduplicationId: str = ...,
    MessageGroupId: str = ...,
) -> PublishResponseTypeDef:  # (2)
    ...

1. See MessageAttributeValueTypeDef
2. See PublishResponseTypeDef

# publish method usage example with argument unpacking

kwargs: PublishInputPlatformEndpointPublishTypeDef = {  # (1)
    "Message": ...,
}

parent.publish(**kwargs)

1. See PublishInputPlatformEndpointPublishTypeDef

PlatformEndpoint.reload method

Calls meth:SNS.Client.get_endpoint_attributes to update the attributes of the PlatformEndpoint resource.

Type annotations and code completion for boto3.resource("sns").reload method. boto3 documentation

# reload method definition

def reload(
    self,
) -> None:
    ...

PlatformEndpoint.set_attributes method

Sets the attributes for an endpoint for a device on one of the supported push notification services, such as GCM (Firebase Cloud Messaging) and APNS.

Type annotations and code completion for boto3.resource("sns").set_attributes method. boto3 documentation

# set_attributes method definition

def set_attributes(
    self,
    *,
    Attributes: Mapping[str, str],
) -> None:
    ...

# set_attributes method usage example with argument unpacking

kwargs: SetEndpointAttributesInputPlatformEndpointSetAttributesTypeDef = {  # (1)
    "Attributes": ...,
}

parent.set_attributes(**kwargs)

1. See SetEndpointAttributesInputPlatformEndpointSetAttributesTypeDef

Subscription

Type annotations and code completion for boto3.resource("sns").Subscription class. boto3 documentation

# Subscription usage example

from mypy_boto3_sns.service_resource import Subscription

def get_resource() -> Subscription:
    return boto3.resource("sns").Subscription(...)

Subscription attributes

• attributes: Dict[str, str]
• arn: str

Subscription methods

Subscription.delete method

Deletes a subscription.

Type annotations and code completion for boto3.resource("sns").delete method. boto3 documentation

# delete method definition

def delete(
    self,
) -> None:
    ...

Subscription.get_available_subresources method

Returns a list of all the available sub-resources for this Resource.

Type annotations and code completion for boto3.resource("sns").get_available_subresources method. boto3 documentation

# get_available_subresources method definition

def get_available_subresources(
    self,
) -> Sequence[str]:
    ...

Subscription.load method

Calls meth:SNS.Client.get_subscription_attributes to update the attributes of the Subscription resource.

Type annotations and code completion for boto3.resource("sns").load method. boto3 documentation

# load method definition

def load(
    self,
) -> None:
    ...

Subscription.reload method

Calls meth:SNS.Client.get_subscription_attributes to update the attributes of the Subscription resource.

Type annotations and code completion for boto3.resource("sns").reload method. boto3 documentation

# reload method definition

def reload(
    self,
) -> None:
    ...

Subscription.set_attributes method

Allows a subscription owner to set an attribute of the subscription to a new value.

Type annotations and code completion for boto3.resource("sns").set_attributes method. boto3 documentation

# set_attributes method definition

def set_attributes(
    self,
    *,
    AttributeName: str,
    AttributeValue: str = ...,
) -> None:
    ...

# set_attributes method usage example with argument unpacking

kwargs: SetSubscriptionAttributesInputSubscriptionSetAttributesTypeDef = {  # (1)
    "AttributeName": ...,
}

parent.set_attributes(**kwargs)

1. See SetSubscriptionAttributesInputSubscriptionSetAttributesTypeDef

Topic

Type annotations and code completion for boto3.resource("sns").Topic class. boto3 documentation

# Topic usage example

from mypy_boto3_sns.service_resource import Topic

def get_resource() -> Topic:
    return boto3.resource("sns").Topic(...)

Topic attributes

• attributes: Dict[str, str]
• arn: str
• subscriptions: TopicSubscriptionsCollection

Topic collections

Topic.subscriptions

Provides access to Subscription resource.

Type annotations and code completion for boto3.resource("sns").Topic(...).subscriptions collection. boto3 documentation

# TopicSubscriptionsCollection usage example

from mypy_boto3_sns.service_resource import TopicSubscriptionsCollection

def get_collection() -> TopicSubscriptionsCollection:
    resource = boto3.resource("sns").Topic(...)
    return resource.subscriptions

Topic methods

Topic.add_permission method

Adds a statement to a topic's access control policy, granting access for the specified Amazon Web Services accounts to the specified actions.

Type annotations and code completion for boto3.resource("sns").add_permission method. boto3 documentation

# add_permission method definition

def add_permission(
    self,
    *,
    Label: str,
    AWSAccountId: Sequence[str],
    ActionName: Sequence[str],
) -> None:
    ...

# add_permission method usage example with argument unpacking

kwargs: AddPermissionInputTopicAddPermissionTypeDef = {  # (1)
    "Label": ...,
    "AWSAccountId": ...,
    "ActionName": ...,
}

parent.add_permission(**kwargs)

1. See AddPermissionInputTopicAddPermissionTypeDef

Topic.confirm_subscription method

Verifies an endpoint owner's intent to receive messages by validating the token sent to the endpoint by an earlier Subscribe action.

Type annotations and code completion for boto3.resource("sns").confirm_subscription method. boto3 documentation

# confirm_subscription method definition

def confirm_subscription(
    self,
    *,
    Token: str,
    AuthenticateOnUnsubscribe: str = ...,
) -> Subscription:
    ...

# confirm_subscription method usage example with argument unpacking

kwargs: ConfirmSubscriptionInputTopicConfirmSubscriptionTypeDef = {  # (1)
    "Token": ...,
}

parent.confirm_subscription(**kwargs)

1. See ConfirmSubscriptionInputTopicConfirmSubscriptionTypeDef

Topic.delete method

Deletes a topic and all its subscriptions.

Type annotations and code completion for boto3.resource("sns").delete method. boto3 documentation

# delete method definition

def delete(
    self,
) -> None:
    ...

Topic.get_available_subresources method

Returns a list of all the available sub-resources for this Resource.

Type annotations and code completion for boto3.resource("sns").get_available_subresources method. boto3 documentation

# get_available_subresources method definition

def get_available_subresources(
    self,
) -> Sequence[str]:
    ...

Topic.load method

Calls meth:SNS.Client.get_topic_attributes to update the attributes of the Topic resource.

Type annotations and code completion for boto3.resource("sns").load method. boto3 documentation

# load method definition

def load(
    self,
) -> None:
    ...

Topic.publish method

Sends a message to an Amazon SNS topic, a text message (SMS message) directly to a phone number, or a message to a mobile platform endpoint (when you specify the TargetArn).

Type annotations and code completion for boto3.resource("sns").publish method. boto3 documentation

# publish method definition

def publish(
    self,
    *,
    Message: str,
    TargetArn: str = ...,
    PhoneNumber: str = ...,
    Subject: str = ...,
    MessageStructure: str = ...,
    MessageAttributes: Mapping[str, MessageAttributeValueTypeDef] = ...,  # (1)
    MessageDeduplicationId: str = ...,
    MessageGroupId: str = ...,
) -> PublishResponseTypeDef:  # (2)
    ...

1. See MessageAttributeValueTypeDef
2. See PublishResponseTypeDef

# publish method usage example with argument unpacking

kwargs: PublishInputTopicPublishTypeDef = {  # (1)
    "Message": ...,
}

parent.publish(**kwargs)

1. See PublishInputTopicPublishTypeDef

Topic.reload method

Calls meth:SNS.Client.get_topic_attributes to update the attributes of the Topic resource.

Type annotations and code completion for boto3.resource("sns").reload method. boto3 documentation

# reload method definition

def reload(
    self,
) -> None:
    ...

Topic.remove_permission method

Removes a statement from a topic's access control policy.

Type annotations and code completion for boto3.resource("sns").remove_permission method. boto3 documentation

# remove_permission method definition

def remove_permission(
    self,
    *,
    Label: str,
) -> None:
    ...

# remove_permission method usage example with argument unpacking

kwargs: RemovePermissionInputTopicRemovePermissionTypeDef = {  # (1)
    "Label": ...,
}

parent.remove_permission(**kwargs)

1. See RemovePermissionInputTopicRemovePermissionTypeDef

Topic.set_attributes method

Allows a topic owner to set an attribute of the topic to a new value.

Type annotations and code completion for boto3.resource("sns").set_attributes method. boto3 documentation

# set_attributes method definition

def set_attributes(
    self,
    *,
    AttributeName: str,
    AttributeValue: str = ...,
) -> None:
    ...

# set_attributes method usage example with argument unpacking

kwargs: SetTopicAttributesInputTopicSetAttributesTypeDef = {  # (1)
    "AttributeName": ...,
}

parent.set_attributes(**kwargs)

1. See SetTopicAttributesInputTopicSetAttributesTypeDef

Topic.subscribe method

Subscribes an endpoint to an Amazon SNS topic.

Type annotations and code completion for boto3.resource("sns").subscribe method. boto3 documentation

# subscribe method definition

def subscribe(
    self,
    *,
    Protocol: str,
    Endpoint: str = ...,
    Attributes: Mapping[str, str] = ...,
    ReturnSubscriptionArn: bool = ...,
) -> Subscription:
    ...

# subscribe method usage example with argument unpacking

kwargs: SubscribeInputTopicSubscribeTypeDef = {  # (1)
    "Protocol": ...,
}

parent.subscribe(**kwargs)

1. See SubscribeInputTopicSubscribeTypeDef