Google Cloud Storage API客户端库
项目描述
Google Cloud Storage 是一种用于存储非结构化数据的托管服务。Cloud Storage 允许在任何时候存储和检索任何数量的数据。您可以使用 Cloud Storage 进行各种场景,包括提供网站内容、存储归档和灾难恢复数据,或通过直接下载向用户分发大型数据对象。
每个版本的变更的详细列表可以在CHANGELOG中找到。
云存储(包括文件夹和托管文件夹操作)的某些控制平面和长时间运行的操作可以通过存储控制客户端支持。除了存储API外,存储控制API创建一个空间来执行特定于元数据的、控制平面的和长时间运行的操作。
有关云API客户端库的更多信息,包括较旧的Google API客户端库,请参阅客户端库解释。
快速入门
要使用此库,您首先需要完成以下步骤。也可以在客户端库入门中找到分步指南。
安装
使用venv在虚拟环境中安装此库。venv是一个创建隔离Python环境的工具。这些隔离环境可以有单独的Python包版本,这允许您将一个项目的依赖项与其他项目的依赖项隔离开来。
使用venv,可以安装此库而无需系统安装权限,也不会与已安装的系统依赖项冲突。
代码示例和片段
代码示例和片段位于samples/文件夹中。
支持的Python版本
Python >= 3.7
不支持的Python版本
Python <= 3.6
如果您正在使用Python的已弃用版本,我们建议您尽快更新到活动支持版本。
Mac/Linux
python3 -m venv <your-env>
source <your-env>/bin/activate
pip install google-cloud-storage
Windows
py -m venv <your-env>
.\<your-env>\Scripts\activate
pip install google-cloud-storage
使用OpenTelemetry跟踪
这是一个预览功能:覆盖范围和功能仍在开发中,可能会发生变化。
此库可以配置为使用OpenTelemetry在调用Google Cloud Storage时生成跟踪。有关跟踪的好处和用途,请参阅云跟踪概述。
要在云存储客户端中启用OpenTelemetry跟踪,首先安装OpenTelemetry
pip install google-cloud-storage[tracing]
设置环境变量ENABLE_GCS_PYTHON_CLIENT_OTEL_TRACES以选择性地为云存储客户端启用跟踪
export ENABLE_GCS_PYTHON_CLIENT_OTEL_TRACES=True
您还需要告诉OpenTelemetry要使用哪个导出器。以下是一个将跟踪导出到Google Cloud Trace的示例。
# Install the Google Cloud Trace exporter and propagator, however you can use any exporter of your choice.
pip install opentelemetry-exporter-gcp-trace opentelemetry-propagator-gcp
# [Optional] Install the OpenTelemetry Requests Instrumentation to trace the underlying HTTP requests.
pip install opentelemetry-instrumentation-requests
from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.exporter.cloud_trace import CloudTraceSpanExporter
tracer_provider = TracerProvider()
tracer_provider.add_span_processor(BatchSpanProcessor(CloudTraceSpanExporter()))
trace.set_tracer_provider(tracer_provider)
# Optional yet recommended to instrument the requests HTTP library
from opentelemetry.instrumentation.requests import RequestsInstrumentor
RequestsInstrumentor().instrument(tracer_provider=tracer_provider)
在此示例中,跟踪数据将发布到Google Cloud Trace控制台。跟踪在许多库被配置为提供对请求整个生命周期的洞察时最有效。有关可配置的库列表,请参阅OpenTelemetry注册表。
下一步
阅读Google Cloud Storage产品文档以了解有关产品的更多信息,并查看操作指南。
阅读Google Cloud Storage API客户端库文档以查看客户端上的其他可用方法。
查看此README以查看我们涵盖的完整Cloud API列表。
项目详情
下载文件
下载适用于您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。
源代码分发
构建分发
google_cloud_storage-2.18.2.tar.gz的散列
算法 | 散列摘要 | |
---|---|---|
SHA256 | aaf7acd70cdad9f274d29332673fcab98708d0e1f4dceb5a5356aaef06af4d99 |
|
MD5 | b8edab4555bc2a8bb0135503a5768b1a |
|
BLAKE2b-256 | d6b71554cdeb55d9626a4b8720746cba8119af35527b12e1780164f9ba0f659a |
哈希值 for google_cloud_storage-2.18.2-py2.py3-none-any.whl
算法 | 散列摘要 | |
---|---|---|
SHA256 | 97a4d45c368b7d401ed48c4fdfe86e1e1cb96401c9e199e419d289e2c0370166 |
|
MD5 | e10db2a86853422d2e2e612aea2c0fd9 |
|
BLAKE2b-256 | fcda95db7bd4f0bd1644378ac1702c565c0210b004754d925a74f526a710c087 |