1 / 4

Waitable 类

命名空间和模块：tencent.cloud.core.waitable

简要

代表一个可等待操作对象的基本类型。借助可等待对象，开发者可以以同步或异步面向对象编程的方式等待一个异步操作真正地完成，例如同步等待一个或多个无服务器云函数资源创建完成。

class Waitable

属性

可等待操作对象类型的实例包含可公开访问的属性如下：

属性

类型

只读

描述

status

int

是

result

object

是

指示可等待操作对象对应的可等待操作的返回值。

如果可等待操作没有返回值，该属性的值默认为 None。

示例

在下文中我们将通过一段 Python 代码片段向您演示如何使用可等待操作对象：

from tencent.cloud.core import errors
from tencent.cloud.core import waitable
from tencent.cloud.serverless import functions

def main():
    client: functions.Client = functions.fetch_client()

    create_operation: waitable.Waitable = client.create_layer(
        region_id = 'ap-shanghai',
        layer_name = 'default',
        layer_description = 'default layer',
        layer_content = functions.LayerContent().use_local_zip_archive(
            local_file_path = './layer.zip'
        ),
        layer_runtimes = [
            functions.FunctionRuntime.Python
        ],
        layer_license = 'default license'
    )

    try:
        layer_version: int = create_operation.wait_for_done(
            max_wait_seconds = 15
        )
    except TimeoutError:
        print('error: max time limit exceeded when creating layer resource')
        return
    
    print('info: layer version = {LAYER_VERSION}'.format(
        LAYER_VERSION = layer_version
    ))

if __name__ == '__main__':
    main()

适用于

Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-core >= 0.1.5

wait_for_done 方法

命名空间和模块：tencent.cloud.core.waitable

简要

等待与当前可等待操作相关的操作完成。在可等待操作完成或超时之前，该方法不会返回。

def wait_for_done(self,
    max_wait_seconds: float = 15
) -> object

参数

该方法具有以下参数，其参数、参数类型和参数描述如下：

参数

类型

必选

描述

max_wait_seconds

float

否

最长等待秒数。

如果该参数被忽略，默认值为 15 秒。

如果该参数被设置为 None，则直到操作完成。

返回值

该方法返回包含与之关联的可等待操作结果的 Object 实例。

异常

该方法可能会主动引发以下异常类型：

ValueError

参数值或类型不符合预期。

TimeoutError

已超出可等待操作的最长等待时间。

示例

接下来我们将通过一段 Python 代码向您演示如何使用该方法：

from tencent.cloud.core import errors
from tencent.cloud.core import waitable
from tencent.cloud.serverless import functions

def main():
    client: functions.Client = functions.fetch_client()

    create_operation: waitable.Waitable = client.create_layer(
        region_id = 'ap-shanghai',
        layer_name = 'default',
        layer_description = 'default layer',
        layer_content = functions.LayerContent().use_local_zip_archive(
            local_file_path = './layer.zip'
        ),
        layer_runtimes = [
            functions.FunctionRuntime.Python
        ],
        layer_license = 'default license'
    )

    try:
        layer_version: int = create_operation.wait_for_done(
            max_wait_seconds = 15
        )
    except TimeoutError:
        print('error: max time limit exceeded when creating layer resource')
        return
    
    print('info: layer version = {LAYER_VERSION}'.format(
        LAYER_VERSION = layer_version
    ))

if __name__ == '__main__':
    main()

适用于

Tencent Cloud SDK for Python

基础软件包：tencent-cloud-sdk-core >= 0.1.5

has_done 方法

命名空间和模块：tencent.cloud.core.waitable

简要

检查与之关联的可等待操作是否已完成。

def has_done(self) -> bool

参数

该方法没有参数。

返回值

如果可等待操作已完成，该方法返回 True。

如果可等待操作未完成或从未开始等待过，该方法返回 False。

异常

该方法不会主动抛出异常。

示例

接下来我们将通过一段 Python 代码向您演示如何使用该方法：

from tencent.cloud.core import errors
from tencent.cloud.core import waitable
from tencent.cloud.serverless import functions

def main():
    client: functions.Client = functions.fetch_client()

    create_operation: waitable.Waitable = client.create_layer(
        region_id = 'ap-shanghai',
        layer_name = 'default',
        layer_description = 'default layer',
        layer_content = functions.LayerContent().use_local_zip_archive(
            local_file_path = './layer.zip'
        ),
        layer_runtimes = [
            functions.FunctionRuntime.Python
        ],
        layer_license = 'default license'
    )

    try:
        layer_version: int = create_operation.wait_for_done(
            max_wait_seconds = 15
        )
    except TimeoutError:
        pass
    
    if create_operation.has_done():
        print('info: layer version = {LAYER_VERSION}'.format(
            LAYER_VERSION = layer_version
        ))
    else:
        print('error: the operation did not complete successfully')

if __name__ == '__main__':
    main()

适用于

Tencent Cloud SDK for Python

基础软件包：tencent-cloud-sdk-core >= 0.1.5

set_result 方法

命名空间和模块：tencent.cloud.core.waitable

简要

设置当前可等待操作的结果，该结果可以通过访问可等待操作对象的 result 属性获得。

def set_result(self,
    wait_result: object
)

值得注意的是，如果方法 wait_for_done 调用成功，可等待操作的结果将被覆盖。

参数

该方法具有以下参数，其参数、参数类型和参数描述如下：

参数

类型

必选

描述

wait_result

object

是

包含可等待操作结果的 Object 实例，该参数允许被设置为 None。

返回值

该方法没有返回值。

异常

该方法不会主动抛出异常。

示例

接下来我们将通过一段 Python 代码向您演示如何使用该方法：

from tencent.cloud.core import errors
from tencent.cloud.core import waitable
from tencent.cloud.serverless import functions

def main():
    client: functions.Client = functions.fetch_client()

    create_operation: waitable.Waitable = client.create_layer(
        region_id = 'ap-shanghai',
        layer_name = 'default',
        layer_description = 'default layer',
        layer_content = functions.LayerContent().use_local_zip_archive(
            local_file_path = './layer.zip'
        ),
        layer_runtimes = [
            functions.FunctionRuntime.Python
        ],
        layer_license = 'default license'
    )

    create_operation.set_result(
        wait_result = 10
    )

if __name__ == '__main__':
    main()

适用于

Tencent Cloud SDK for Python

基础软件包：tencent-cloud-sdk-core >= 0.1.5

set_result 方法

命名空间和模块：tencent.cloud.core.waitable

简要

设置当前可等待操作的结果，该结果可以通过访问可等待操作对象的 result 属性获得。

def set_result(self,
    wait_result: object
)

值得注意的是，如果方法 wait_for_done 调用成功，可等待操作的结果将被覆盖。

参数

该方法具有以下参数，其参数、参数类型和参数描述如下：

参数

类型

必选

描述

wait_result

object

是

包含可等待操作结果的 Object 实例，该参数允许被设置为 None。

返回值

该方法没有返回值。

异常

该方法不会主动抛出异常。

示例

接下来我们将通过一段 Python 代码向您演示如何使用该方法：

from tencent.cloud.core import errors
from tencent.cloud.core import waitable
from tencent.cloud.serverless import functions

def main():
    client: functions.Client = functions.fetch_client()

    create_operation: waitable.Waitable = client.create_layer(
        region_id = 'ap-shanghai',
        layer_name = 'default',
        layer_description = 'default layer',
        layer_content = functions.LayerContent().use_local_zip_archive(
            local_file_path = './layer.zip'
        ),
        layer_runtimes = [
            functions.FunctionRuntime.Python
        ],
        layer_license = 'default license'
    )

    create_operation.set_result(
        wait_result = 10
    )

if __name__ == '__main__':
    main()

适用于

Tencent Cloud SDK for Python

基础软件包：tencent-cloud-sdk-core >= 0.1.5

has_done 方法

命名空间和模块：tencent.cloud.core.waitable

简要

检查与之关联的可等待操作是否已完成。

def has_done(self) -> bool

参数

该方法没有参数。

返回值

如果可等待操作已完成，该方法返回 True。

如果可等待操作未完成或从未开始等待过，该方法返回 False。

异常

该方法不会主动抛出异常。

示例

接下来我们将通过一段 Python 代码向您演示如何使用该方法：

from tencent.cloud.core import errors
from tencent.cloud.core import waitable
from tencent.cloud.serverless import functions

def main():
    client: functions.Client = functions.fetch_client()

    create_operation: waitable.Waitable = client.create_layer(
        region_id = 'ap-shanghai',
        layer_name = 'default',
        layer_description = 'default layer',
        layer_content = functions.LayerContent().use_local_zip_archive(
            local_file_path = './layer.zip'
        ),
        layer_runtimes = [
            functions.FunctionRuntime.Python
        ],
        layer_license = 'default license'
    )

    try:
        layer_version: int = create_operation.wait_for_done(
            max_wait_seconds = 15
        )
    except TimeoutError:
        pass
    
    if create_operation.has_done():
        print('info: layer version = {LAYER_VERSION}'.format(
            LAYER_VERSION = layer_version
        ))
    else:
        print('error: the operation did not complete successfully')

if __name__ == '__main__':
    main()

适用于

Tencent Cloud SDK for Python

基础软件包：tencent-cloud-sdk-core >= 0.1.5

Waitable 类

命名空间和模块：tencent.cloud.core.waitable

简要

class Waitable

属性

可等待操作对象类型的实例包含可公开访问的属性如下：

属性

类型

只读

描述

status

int

是

指示可等待操作对象的状态。与该属性的值相关的是枚举器。

result

object

是

指示可等待操作对象对应的可等待操作的返回值。

如果可等待操作没有返回值，该属性的值默认为 None。

示例

在下文中我们将通过一段 Python 代码片段向您演示如何使用可等待操作对象：

from tencent.cloud.core import errors
from tencent.cloud.core import waitable
from tencent.cloud.serverless import functions

def main():
    client: functions.Client = functions.fetch_client()

    create_operation: waitable.Waitable = client.create_layer(
        region_id = 'ap-shanghai',
        layer_name = 'default',
        layer_description = 'default layer',
        layer_content = functions.LayerContent().use_local_zip_archive(
            local_file_path = './layer.zip'
        ),
        layer_runtimes = [
            functions.FunctionRuntime.Python
        ],
        layer_license = 'default license'
    )

    try:
        layer_version: int = create_operation.wait_for_done(
            max_wait_seconds = 15
        )
    except TimeoutError:
        print('error: max time limit exceeded when creating layer resource')
        return
    
    print('info: layer version = {LAYER_VERSION}'.format(
        LAYER_VERSION = layer_version
    ))

if __name__ == '__main__':
    main()

适用于

Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-core >= 0.1.5

wait_for_done 方法

命名空间和模块：tencent.cloud.core.waitable

简要

等待与当前可等待操作相关的操作完成。在可等待操作完成或超时之前，该方法不会返回。

def wait_for_done(self,
    max_wait_seconds: float = 15
) -> object

参数

该方法具有以下参数，其参数、参数类型和参数描述如下：

参数

类型

必选

描述

max_wait_seconds

float

否

最长等待秒数。

如果该参数被忽略，默认值为 15 秒。

如果该参数被设置为 None，则直到操作完成。

返回值

该方法返回包含与之关联的可等待操作结果的 Object 实例。

异常

该方法可能会主动引发以下异常类型：

ValueError

参数值或类型不符合预期。

TimeoutError

已超出可等待操作的最长等待时间。

示例

接下来我们将通过一段 Python 代码向您演示如何使用该方法：

from tencent.cloud.core import errors
from tencent.cloud.core import waitable
from tencent.cloud.serverless import functions

def main():
    client: functions.Client = functions.fetch_client()

    create_operation: waitable.Waitable = client.create_layer(
        region_id = 'ap-shanghai',
        layer_name = 'default',
        layer_description = 'default layer',
        layer_content = functions.LayerContent().use_local_zip_archive(
            local_file_path = './layer.zip'
        ),
        layer_runtimes = [
            functions.FunctionRuntime.Python
        ],
        layer_license = 'default license'
    )

    try:
        layer_version: int = create_operation.wait_for_done(
            max_wait_seconds = 15
        )
    except TimeoutError:
        print('error: max time limit exceeded when creating layer resource')
        return
    
    print('info: layer version = {LAYER_VERSION}'.format(
        LAYER_VERSION = layer_version
    ))

if __name__ == '__main__':
    main()

适用于

Tencent Cloud SDK for Python

基础软件包：tencent-cloud-sdk-core >= 0.1.5