Сводка
Создает файл подключения к облачному хранилищу, поддерживаемому 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})| Parameter | Объяснение | Тип данных |
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 (Дополнительный) | Укажите папку в облачном хранилище Имя бакета (контейнера), где будет сохранен набор растровых данных. | Folder |
Производные выходные данные
| Name | Объяснение | Тип данных |
| out_connection | Путь к выходному файлу подключения к облачному хранилищу. | Файл |
Пример кода
Пример скрипта 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")Пример скрипта 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)Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да