Создать файл подключения к облачному хранилищу

Краткая информация

Создает файл подключения к облачному хранилищу, поддерживаемому ArcGIS. Позволяет имеющимся растровым инструментам геообработки записывать наборы данных в формате облачных растров (CRF) в облачное хранилище или считывать наборы растровых данных (не только CRF), хранящиеся в облаке.

Использование

• Инструменту требуется необходимая информация для подключения к облачному хранилищу, такая как Access Key, Secret Access Key и Bucket Name.

• На выходе инструмента создается двоичный файл подключения к облачному хранилищу в формате ArcGIS Cloud Storage (.icsd).

• Набор растровых данных хранящийся в облаке, можно использовать через файл пути, такой как c:/temp/amazons3.acs/someraster.

• К поддерживаемым облачным хранилищам относятся Amazon, Azure, Google и Alibaba.

• Если набор данных хранится в папке, ее имя должно быть указано в пути, например, c:/temp/amazons3.acs/foldername/someraster.

• Инструмент проверяет указанные учетные данные во время работы. Если подключение установить не удается, инструмент завершает работу с ошибкой.

• Вы можете использовать этот инструмент с Amazon Web Services (AWS) Identity и ролью Access Management (IAM). Для этого оставьте параметры ID ключа доступа и Секретный ключ доступа пустыми. Если роль IAM настроена правильно, при запуске этого инструмента на компьютере с EC2, будет установлено подключение. Теперь созданный файл подключения может использоваться в той же среде.

Синтаксис

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 Cloud Storage ALIBABA —Alibaba Cloud Storage 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	Путь к выходному файлу подключения к облачному хранилищу.	File

Пример кода

CreateCloudStorageConnectionFile, пример 1 (окно Python)

Пример скрипта Python для инструмента CreateCloudStorageConnectionFile.

#====================================
# 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 (автономный скрипт)

Пример скрипта Python для инструмента CreateCloudStorageConnectionFile.

#====================================
# 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)

Это пример скрипта Python для инструмента CreateCloudStorageConnectionFile с примерами для различных сценариев подключения.

#====================================
# 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: Да