gcloud 0.18.3

google-cloud

警告：此包已移动。已重命名为 google-cloud on PyPI。不会有新的版本 gcloud。

概述

• Homepage
• API Documentation

此客户端支持以下Google云平台服务：

• 谷歌云Datastore
• 谷歌云Storage
• 谷歌云Pub/Sub
• 谷歌BigQuery
• 谷歌云Resource Manager
• 谷歌Stackdriver Logging

如果您需要对其他googleapi的支持，请查看 Google APIs Python Client library。

快速启动

$ pip install --upgrade gcloud

示例应用程序

• getting-started-python-一个示例和tutorial，演示如何使用云数据存储、云存储和云发布/订阅构建完整的web应用程序，并将其部署到google应用程序引擎或google计算引擎。
• gcloud-python-expenses-demo-使用云数据存储和云存储的示例费用演示

身份验证

使用gcloud-python我们尝试使身份验证尽可能轻松。 查看我们文档中的Authentication section以了解更多信息。 您还可以找到所有^{tt4}共享的authentication document$ 图书馆是有用的。

谷歌云数据存储

googleCloud Datastore（Datastore API docs）是一个完全托管的、无模式的 用于存储非关系数据的数据库。云数据存储自动扩展 与您的用户一起，并支持acid事务、高可用的读取和 写入、读取和祖先查询的强一致性，以及最终 所有其他查询的一致性。

请参阅gcloud-pythonapidatastore documentation以了解如何 使用此客户端库与云数据存储交互。

请参阅official Google Cloud Datastore documentation以了解有关如何 为您的项目激活云数据存储。

fromgcloudimportdatastore# Create, populate and persist an entityentity=datastore.Entity(key=datastore.Key('EntityKind'))entity.update({'foo':u'bar','baz':1337,'qux':False,})# Then query for entitiesquery=datastore.Query(kind='EntityKind')forresultinquery.fetch():printresult

谷歌云存储

googleCloud Storage（Storage API docs）允许您在google上存储数据 具有极高可靠性、性能和可用性的基础设施，并且可以 用于通过直接下载将大型数据对象分发给用户。

请参阅gcloud-pythonapistorage documentation以了解如何连接 使用此客户端库进行云存储。

您需要创建一个google云存储桶来使用这个客户机库。 跟着official Google Cloud Storage documentation学习 如何创建bucket。

fromgcloudimportstorageclient=storage.Client()bucket=client.get_bucket('bucket-id-here')# Then do other things...blob=bucket.get_blob('remote/path/to/file.txt')printblob.download_as_string()blob.upload_from_string('New contents!')blob2=bucket.blob('remote/path/storage.txt')blob2.upload_from_filename(filename='/local/path.txt')

谷歌云发布/订阅

google Cloud Pub/Sub（Pub/Sub API docs）的设计目的是提供可靠的， 应用程序之间的多对多异步消息传递。出版商 应用程序可以向topic发送消息，而其他应用程序可以 订阅该主题以接收消息。通过分离发送器和 接收者，google cloud pub/sub允许开发者在 独立编写的申请。

请参阅gcloud-pythonapiPub/Sub documentation以了解如何连接 使用此客户端库对发布/订阅进行云计算。

要开始使用此api，您需要创建

fromgcloudimportpubsubclient=pubsub.Client()topic=client.topic('topic_name')topic.create()topic.publish('this is the message_payload',attr1='value1',attr2='value2')

谷歌大查询

如果不使用 正确的硬件和基础设施。谷歌 BigQuery（BigQuery API docs） 通过对 使用google基础设施的处理能力，只追加表。

这个包仍在执行中，但几乎已经完成了！

importcsvfromgcloudimportbigqueryfromgcloud.bigqueryimportSchemaFieldclient=bigquery.Client()dataset=client.dataset('dataset_name')dataset.create()# API requestSCHEMA=[SchemaField('full_name','STRING',mode='required'),SchemaField('age','INTEGER',mode='required'),]table=dataset.table('table_name',SCHEMA)table.create()withopen('csv_file','rb')asreadable:table.upload_from_file(readable,source_format='CSV',skip_leading_rows=1)

# Perform a synchronous query.QUERY=('SELECT name FROM [bigquery-public-data:usa_names.usa_1910_2013] ''WHERE state = "TX"')query=client.run_sync_query('%s LIMIT 100'%QUERY)query.timeout_ms=TIMEOUT_MSquery.run()forrowinquery.rows:printrow

谷歌云资源管理器

云Resource Managerapi（Resource Manager API docs）提供 方法，您可以使用这些方法以编程方式管理 谷歌云平台。

请参阅gcloud-pythonapiResource Manager documentation以了解如何 使用此客户端库管理项目。

google stackdriver日志记录

Stackdriver Loggingapi（Logging API docs）允许您存储、搜索， 对来自google云平台的日志数据和事件进行分析、监视和警报。

fromgcloudimportloggingclient=logging.Client()logger=client.logger('log_name')logger.log_text("A simple entry")# API call

获取条目的示例：

entries,token=logger.list_entries()forentryinentries:printentry.payload

请参阅gcloud-pythonapilogging documentation以了解如何连接 使用此客户端库来堆栈驱动程序日志记录。

贡献

对这个图书馆的贡献总是受到欢迎和高度鼓励的。

有关如何开始的详细信息，请参见CONTRIBUTING doc。

许可证

apache 2.0-有关更多信息，请参见the LICENSE。