描述
用于为支持 ArcGIS 的云存储创建连接文件。允许现有栅格地理处理工具将云栅格格式 (CRF) 数据集写入云存储存储段,或者读取存储在云存储中的栅格数据集(不限于 CRF)作为输入。
使用方法
必须提供用于建立云存储连接的必要信息才能运行此工具,例如访问密钥、保密访问密钥和存储段名称。
该工具将以 ArcGIS 云存储格式 (.icsd) 输出二进制云存储连接文件。
可以通过文件路径(例如 c:/temp/amazons3.acs/someraster)来引用存储在云存储中的栅格数据集。
该工具支持连接到 Amazon 简单存储解决方案 (S3) 存储段、Microsoft Azure Blob 存储容器、Alibaba 云对象云存储服务存储段和 Google 云存储。
如果数据集存储在存储段中的文件夹中,则文件夹名称必须包含在路径中,例如,c:/temp/amazons3.acs/foldername/someraster。
该工具将验证在运行时提供的凭据。如果无法建立连接,则该工具将失败。
要将此工具与 Amazon Web Services (AWS) 身份和访问管理 (IAM) 角色一起使用,将访问密钥 ID 和保密访问密钥参数留空。如果在 EC2 计算机上运行此工具时已正确配置 IAM 角色,则可以成功连接。之后可以在相同的环境中使用连接文件。
语法
arcpy.management.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 | 指定云存储服务提供商。
| 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 (可选) | 存储段(容器)名称参数中将存储栅格数据集的文件夹。 | String |
派生输出
名称 | 说明 | 数据类型 |
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_REQUEST_PAYER 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)
CreateCloudStorageConnectionFile 示例 3(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
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: 是