创建云存储连接文件 (数据管理)

描述

用于为支持 ArcGIS 的云存储创建连接文件。允许现有栅格地理处理工具将云栅格格式 (CRF) 数据集写入云存储存储段，或者读取存储在云存储中的栅格数据集（不限于 CRF）作为输入。

使用方法

• 此工具要求提供用于建立云存储连接的必要信息，例如访问密钥、保密访问密钥和存储段名称。

• 该工具将以 ArcGIS 云存储格式 (.icsd) 输出二进制云存储连接文件。

• 可以通过文件路径（例如 c:/temp/amazons3.acs/someraster）来引用存储在云存储中的栅格数据集。

• 受支持的云存储提供商包括 Amazon、Azure、Google 和 Alibaba。

• 如果数据集存储在存储段中的文件夹中，则文件夹名称必须包含在路径中，例如，c:/temp/amazons3.acs/foldername/someraster。

• 该工具将验证在运行时提供的凭据。如果无法建立连接，则该工具将失败。

• 您可以以 Amazon Web Services (AWS) 身份和访问管理 (IAM) 角色使用此工具。要进行此操作，请将访问密钥 ID 和保密访问密钥参数留空。如果在 EC2 计算机上运行此工具时已正确配置 IAM 角色，则可以成功连接。现在，创建的连接文件也可在相同环境中使用。

语法

CreateCloudStorageConnectionFile(out_folder_path, out_name, service_provider, bucket_name, {access_key_id}, {secret_access_key}, {region}, {end_point}, {config_options}, {folder})

参数	说明	数据类型
out_folder_path	将在其中创建连接文件的文件夹路径。	Folder
out_name	云存储连接文件的名称。	String
service_provider	指定云存储服务提供商。 AZURE —Microsoft Azure AMAZON —Amazon S3 GOOGLE —Google 云存储 ALIBABA —Alibaba 云存储 WEBHDFS —WebHDFS	String
bucket_name	将存储栅格数据集的云存储容器的名称。对于很多云提供商，也称为存储段。	String
access_key_id （可选）	特定云存储类型的访问密钥 ID 字符串。与 Azure 一样，也可以是帐户名称。	String
secret_access_key （可选）	用于验证与云存储的连接的保密访问密钥字符串。	Encrypted String
region （可选）	云存储的区域字符串。如果提供区域，则该值必须使用由云存储选择定义的格式。默认值是所选云提供商的帐户默认值。	String
end_point （可选）	云存储的服务端点 (uris)，例如 oss-us-west-1.aliyuncs.com。如果未提供此参数，则将使用所选云存储类型的默认端点。如有必要，可以使用 CNAME 重定向端点。	String
config_options [config_options,...] （可选）	指定与特定类型的云服务有关的配置选项。有些服务提供选项，有些服务则不提供选项。如果要将其打开，仅需设置选项。	Value Table
folder （可选）	在云存储中指定用于存储栅格数据集的文件夹存储段（容器）名称。	Folder

派生输出

名称	说明	数据类型
out_connection	输出云存储连接文件路径。	文件

代码示例

CreateCloudStorageConnectionFile 示例 1（Python 窗口）

这是 CreateCloudStorageConnectionFile 工具的 Python 示例。

#====================================
# CreateCloudStorageConnectionFile
# Usage:
# arcpy.management.CreateCloudStorageConnectionFile(
#     out_folder_path, out_name, AZURE | AMAZON | GOOGLE | ALIBABA, bucket_name,
#     {access_key_id}, {secret_access_key}, {region}, {end_point},
#     { {Name} {Value}; {Name} {Value}...})
# arcpy.management.CreateCloudStorageConnectionFile(
#     out_folder_path, out_name, AZURE | AMAZON | GOOGLE | ALIBABA, bucket_name,
#     {access_key_id}, {secret_access_key}, {region}, {end_point},
#     {config_options})

import arcpy

# Create connection to open public bucket with requester pay option
arcpy.management.CreateCloudStorageConnectionFile(
    "C:/Workspace/connections", "awss3storage.acs", "AMAZON", "publicrasterstore",
    config_options="AWS_REQUESTER_PAYS requester")

# Create connection to secured Azure bucket
arcpy.management.CreateCloudStorageConnectionFile(
    "C:/Workspace/connections", "azurestorage.acs", "AZURE", "rasterstore", "imageaccount",
    "NOGEOU1238987OUOUNOQEWQWEIO")

# Create Alibaba connection with end points
arcpy.management.CreateCloudStorageConnectionFile(
    "C:/Workspace/connections", "aliyun.acs", "ALIBABA", "rasterstore", "AYOUER9273PJJNY",
"NOGEOU1238987OUOUNOQEWQWEIO", end_point="rasterstore.oss-us-west-1.aliyuncs.com")

CreateCloudStorageConnectionFile 示例 2（独立脚本）。

这是 CreateCloudStorageConnectionFile 工具的 Python 示例。

#====================================
# CreateCloudStorageConnectionFile
# Usage:
# arcpy.management.CreateCloudStorageConnectionFile(
#     out_folder_path, out_name, AZURE | AMAZON | GOOGLE | ALIBABA, bucket_name,
#     {access_key_id}, {secret_access_key}, {region}, {end_point},
#     { {Name} {Value}; {Name} {Value}...})
# arcpy.management.CreateCloudStorageConnectionFile(
#     out_folder_path, out_name, AZURE | AMAZON | GOOGLE | ALIBABA, bucket_name,
#     {access_key_id}, {secret_access_key}, {region}, {end_point},
#     {config_options})

import arcpy

outfolder = "C:/Workspace/connections"
connectname = "googlecloudos.acs"
provider = "GOOGLE"
accesskey = "AYOUER9273PJJNY"
secretkey = "NOGEOU1238987OUOUNOQEWQWEIO"
bucketname = "rasterstore"

# Create connection to Google cloud object storage
arcpy.management.CreateCloudStorageConnectionFile(
outfolder, connectname, provider, bucketname, accesskey, secretkey)

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是