跳转到主要内容

Google Cloud Storage API客户端库

项目描述

stable pypi versions

Google Cloud Storage 是一种用于存储非结构化数据的托管服务。Cloud Storage 允许在任何时候存储和检索任何数量的数据。您可以使用 Cloud Storage 进行各种场景,包括提供网站内容、存储归档和灾难恢复数据,或通过直接下载向用户分发大型数据对象。

每个版本的变更的详细列表可以在CHANGELOG中找到。

云存储(包括文件夹和托管文件夹操作)的某些控制平面和长时间运行的操作可以通过存储控制客户端支持。除了存储API外,存储控制API创建一个空间来执行特定于元数据的、控制平面的和长时间运行的操作。

有关云API客户端库的更多信息,包括较旧的Google API客户端库,请参阅客户端库解释

快速入门

要使用此库,您首先需要完成以下步骤。也可以在客户端库入门中找到分步指南。

  1. 选择或创建一个云平台项目。

  2. 为您的项目启用计费。

  3. 启用Google Cloud Storage API。

  4. 设置身份验证。

安装

使用venv在虚拟环境中安装此库。venv是一个创建隔离Python环境的工具。这些隔离环境可以有单独的Python包版本,这允许您将一个项目的依赖项与其他项目的依赖项隔离开来。

使用venv,可以安装此库而无需系统安装权限,也不会与已安装的系统依赖项冲突。

代码示例和片段

代码示例和片段位于samples/文件夹中。

支持的Python版本

我们的客户端库与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注册表

下一步

项目详情


发行历史 发行通知 | RSS订阅

下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源代码分发

google_cloud_storage-2.18.2.tar.gz (5.5 MB 查看散列)

上传 源代码

构建分发

google_cloud_storage-2.18.2-py2.py3-none-any.whl (130.5 kB 查看散列)

上传 Python 2 Python 3

支持

AWSAWS云计算和安全赞助商DatadogDatadog监控FastlyFastlyCDNGoogleGoogle下载分析MicrosoftMicrosoftPSF赞助商PingdomPingdom监控SentrySentry错误日志StatusPageStatusPage状态页面