TIPCommon.adapters
class TIPCommon.adapters.pubsub.pubsub.PubSubAdapter
class TIPCommon.adapters.pubsub.pubsub.PubSubAdapter(session, project_id=None, logger=None, region=None)
Basen: object
Adapterklasse zum Verwalten von Pub/Sub-Themen und ‑Abos für das Google Cloud Projekt.
ack
ack(sub_name, ack_ids)
Bestätigt die Nachrichten, die mit dem ackIDs
in der AcknowledgeRequest
-Antwort verknüpft sind, die von PubSubAdapter.pull()
zurückgegeben wird.
Parameter | |
---|---|
sub_name |
(str )Der Name des Abos. |
ack_ids |
list[str])
Eine Liste der Bestätigungs-IDs für die bestätigten Nachrichten. Die Liste wird vom Pub/Sub-System in der Antwort |
static build_pubsub_message
static build_pubsub_message(message_content, encoding='utf-8', ordering_key=None, **attr)
Erstellt ein PubSubMessage-Objekt.
Parameter | |
---|---|
message_content |
(str )
Der Inhalt der Nachricht. |
encoding |
(str )
Der Codierungstyp zum Codieren oder Decodieren des Nachrichtentextes. Der Standardwert ist |
ordering_key |
Optional (str )
Wenn dieser Parameter verwendet wird, werden alle zugehörigen Nachrichten identifiziert, die der Veröffentlichungsreihenfolge folgen müssen. |
**attr |
Optional ( Die Attribute, die als Attribute des Nachrichtenobjekts übergeben werden sollen. |
Gibt Folgendes zurück:
TIPCommon.adapters.pubsub.PubSubMessage
-Objekt.
Rückgabetyp
create_subscription
create_subscription(sub_name, topic, **attr)
Erstellt ein Pub/Sub-Abo für das angegebene Thema.
Parameter | |
---|---|
sub_name |
(str )
Der Name des Abos. |
topic |
(str )
Ein Pub/Sub-Themaname, für den das Abo erstellt werden soll. |
**attr |
Zusätzliche Parameter, die an die Aboanfrage übergeben werden sollen. |
Gibt Folgendes zurück:
TIPCommon.adapters.pubsub.Subscription
-Objekt des erstellten Abos.
Rückgabetyp
create_topic
create_topic(topic_name)
Erstellt ein Pub/Sub-Thema in einem Google Cloud -Projekt.
Parameter | |
---|---|
topic_name |
(str )
Der Name des Themas. Der Name muss den Google Cloud Regeln für Ressourcennamen entsprechen. |
Gibt Folgendes zurück:
TIPCommon.adapters.pubsub.Topic
-Objekt des erstellten Themas.
Rückgabetyp
delete_subscription
delete_subscription(sub_name)
Löscht ein Pub/Sub-Abo aus einem Google Cloud -Projekt.
Parameter | |
---|---|
sub_name |
(str )
Der Name des Abos, das entfernt werden soll. |
delete_topic
delete_topic(topic_name)
Löscht ein Pub/Sub-Thema aus einem Google Cloud -Projekt.
Parameter | |
---|---|
topic_name |
(str )Das zu entfernende Thema. |
static from_credentials
static from_credentials(credentials, project_id=None, verify_ssl=True, quota_project=None, logger=None, region=None)
Erstellt ein PubSubAdapter-Objekt aus einem google.oauth2.credentials.Credentials
-Objekt.
Parameter | |
---|---|
credentials |
(google.oauth2.credentials.Credentials )
Ein |
project_id |
Optional (str )
Die Google Cloud Projekt-ID. Wenn keine Angabe erfolgt, wird standardmäßig versucht, das im Anmeldedatenobjekt konfigurierte Projekt zu verwenden. |
verify_ssl |
Optional (bool )
Gibt an, ob die SSL-Zertifikatsüberprüfung für HTTP-Sitzungen aktiviert ist. |
quota_project |
Optional (str )
Das Projekt, das für Kontingent und Abrechnung verwendet werden soll. |
logger |
Optional (SiemplifyLogger )
Ein |
region |
(str )
Die Region, in der Pub/Sub verwendet werden soll. |
Gibt Folgendes zurück:
Ein PubSubAdapter
-Objekt.
Rückgabetyp
PubSubAdapter
static from_service_account_info
static subscription_name(project_id, sub_name)
Erstellt ein PubSubAdapter-Objekt aus service_account
-JSON.
Parameter | |
---|---|
user_service_account |
(str )
Die Google Cloud Dienstkonto-JSON im Textformat. |
project_id |
Optional (str )
Die Google Cloud Projekt-ID. Wenn keine Angabe erfolgt, wird standardmäßig versucht, das im Anmeldedatenobjekt konfigurierte Projekt zu verwenden. |
verify_ssl |
Optional (bool )
Gibt an, ob die SSL-Zertifikatsüberprüfung für HTTP-Sitzungen aktiviert ist. |
quota_project |
Optional (str )
Das Projekt, das für Kontingent und Abrechnung verwendet werden soll. |
logger |
Optional (SiemplifyLogger )
Ein |
Gibt Folgendes zurück:
Ein PubSubAdapter
-Objekt.
Rückgabetyp
PubSubAdapter
get_subscription
get_subscription(sub_name, topic=None, create_if_not_exist=False, **attr)
Ruft ein Pub/Sub-Abo ab.
Parameter | |
---|---|
sub_name |
(str )
Der Name des Abos. |
topic |
(str )
Der Name eines Pub/Sub-Themas, für das ein Abo erstellt werden soll. Erforderlich, wenn |
create_if_not_exist |
Erstellt das Pub/Sub-Abo in Google Cloud , falls es nicht vorhanden ist. |
**attr |
Zusätzliche Parameter, die an die Anfrage zur Erstellung des Abos übergeben werden sollen. |
Gibt Folgendes zurück:
TIPCommon.adapters.pubsub.Subscription
-Objekt des abgerufenen Abos.
Rückgabetyp
get_topic
get_topic(topic_name, create_if_not_exist=False)
Ruft ein Pub/Sub-Themenobjekt aus dem konfigurierten Google Cloud-Projekt ab.
Parameter | |
---|---|
topic_name |
(str )Name des Themas (vereinfacht, ohne das Präfix |
create_if_not_exist |
bool Erstellt das Pub/Sub-Thema in Google Cloud, falls es nicht vorhanden ist. |
Gibt Folgendes zurück:
TIPCommon.adapters.pubsub.Topic
-Objekt des empfangenen Themas.
Rückgabetyp
patch_subscription
patch_subscription(sub_name, topic_name, push_config=None, bigquery_config=None, cloud_storage_config=None, ack_deadline_seconds=None, retain_acked_messages=None, retention_duration=None, labels=None, enable_message_ordering=None, expiration_policy=None, query_filter=None, dead_letter_policy=None, return_policy=None, detached=None, enable_once_delivery=None)
Aktualisiert ein vorhandenes Abo.
Parameter | |
---|---|
sub_name |
(str )Der Name des Abos. |
topic_name |
(str )Der Name des Themas, aus dem dieses Abo Nachrichten empfängt. |
Gibt Folgendes zurück:
TIPCommon.adapters.pubsub.Subscription
-Objekt des erhaltenen Abos.
Rückgabetyp
patch_topic
patch_topic(topic_name, labels=None, message_storage_policy=None, kms_key_name=None, schema_settings=None, satisfies_pzs=None, retention_duration=None)
Aktualisiert ein vorhandenes Thema.
Parameter | |
---|---|
topic_name |
(str )Der Name des Themas. |
Gibt Folgendes zurück:
TIPCommon.adapters.pubsub.Topic
-Objekt des empfangenen Themas.
Rückgabetyp
publish
publish(topic_name, messages)
Eine Liste von PubSubMessage-Objekten in einem Thema veröffentlichen.
Parameter | |
---|---|
topic_name |
(str )Der Name des Themas, in dem die Nachrichten veröffentlicht werden sollen. |
messages |
list Eine Liste von PubSubMessage-Objekten. Sie können die Liste mit der statischen Methode |
Gibt Folgendes zurück:
Liste der Nachrichten-IDs.
Rückgabetyp
list[str]
pull
pull(sub_name, limit, timeout=60, encoding='utf-8')
Nachrichten aus Pub/Sub-Abos abrufen
Parameter | |
---|---|
sub_name |
(str )Der Name des Abos. |
limit |
int Die maximale Anzahl von Nachrichten, die für diese Anfrage zurückgegeben werden sollen. |
timeout |
int HTTP-Anfrage-Zeitlimit in Sekunden. Der Standardwert beträgt 60 Sekunden. |
encoding |
(str )Eine Pub/Sub-Nachrichtencodierung. Der Standardwert ist |
Gibt Folgendes zurück:
Liste mit TIPCommon.adapters.pubsub.ReceivedMessage
-Objekten.
Rückgabetyp
list[ReceivedMessage]
statisch subscription_name
static subscription_name(project_id, sub_name)
Ruft den vollständigen Abostatus im folgenden Format ab: projects/project_id
/subscriptions/subscription_name
.
Parameter | |
---|---|
project_id |
(str )Der Projektname, der die Ressource enthält. |
sub_name |
(str )Name eines Pub/Sub-Abos. |
Gibt Folgendes zurück:
Ein vollständiger Aboname im folgenden Format: projects/project_id
/subscriptions/subscription_name
.
Rückgabetyp
str
static topic_name
static topic_name(project_id, topic)
Ruft projects/project_id
/topics/topic_name
ab.
Parameter | |
---|---|
project_id |
(str )Der Projektname, der die Ressource enthält. |
topic |
(str )Ein Pub/Sub-Themenname. |
Gibt Folgendes zurück:
Vollständiger Themenname: projects/project_id
/topics/topic_name
.
Rückgabetyp
str
class TIPCommon.adapters.pubsub.data_models.PubSubMessage
class TIPCommon.adapters.pubsub.data_models.PubSubMessage(raw_data: 'dict', data: 'str' = None, attributes: 'dict' = None, message_id: 'str' = None, publish_time: 'int' = None, ordering_key: 'str' = None)
Basiert auf: object
attributes: dict= None
data: str= None
json()
message_id: str= None
ordering_key: str= None
publish_time: int= None
raw_data: dict
class TIPCommon.adapters.pubsub.data_models.ReceivedMessage
class TIPCommon.adapters.pubsub.data_models.ReceivedMessage(raw_data: 'dict', ack_id: 'str', message: 'PubSubMessage', delivery_attempt: 'int')
Basiert auf: object
ack_id: str
delivery_attempt: int
json()
message: PubSubMessage
raw_data: dict
class TIPCommon.adapters.pubsub.data_models.SchemaSettings
class TIPCommon.adapters.pubsub.data_models.SchemaSettings(raw_data: 'dict', schema: 'str', encoding: 'str' = None, first_revision_id: 'str' = None, last_revision_id: 'str' = None)
Basiert auf: object
encoding: str= None
first_revision_id: str= None
json()
last_revision_id: str= None
raw_data: dict
schema: str
class TIPCommon.adapters.pubsub.data_models.Subscription
class TIPCommon.adapters.pubsub.data_models.Subscription(raw_data: 'dict', name: 'str', identifier: 'str', topic_identifier: 'str', state: 'str', ack_deadline_secs: 'int' = None, retain_ack_messages: 'bool' = None, message_retention_duration: 'int' = None, labels: 'dict' = None, message_ordering: 'bool' = None, query_filter: 'str' = None, topic_message_retention_duration: 'int' = None)
Basiert auf: object
ack_deadline_secs: int= None
identifier: str
json()
labels: dict= None
message_ordering: bool= None
message_retention_duration: int= None
name: str
query_filter: str= None
raw_data: dict
retain_ack_messages: bool= None
state: str
topic_identifier: str
topic_message_retention_duration: int= None
class TIPCommon.adapters.pubsub.data_models.Topic
class TIPCommon.adapters.pubsub.data_models.Topic(raw_data: 'dict', name: 'str', identifier: 'str', labels: 'dict' = None, schema_settings: 'SchemaSettings' = None, message_retention_duration: 'int' = None)
Basiert auf: object
identifier: str
json()
labels: dict= None
message_retention_duration: int= None
name: str
raw_data: dict
schema_settings: SchemaSettings= None
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten