Сводка
Создает файл подключения к облачному хранилищу, поддерживаемому ArcGIS. Позволяет имеющимся растровым инструментам геообработки записывать наборы данных в формате облачных растров (CRF) в облачное хранилище или считывать наборы растровых данных (не только CRF), хранящиеся в облаке.
Использование
Вы должны предоставить необходимую информацию для подключения к облачному хранилищу, такую как Ключ доступа, Секретный ключ доступа и Имя бакета, чтобы запустить этот инструмент.
На выходе инструмента создается двоичный файл подключения к облачному хранилищу в формате ArcGIS Cloud Storage (.icsd).
Набор растровых данных хранящийся в облаке, можно использовать через файл пути, такой как c:/temp/amazons3.acs/someraster.
Этот инструмент поддерживает подключения к бакетам Amazon Simple Storage Solution (S3), контейнерам хранилища BLOB-объектов Microsoft Azure, бакетам службы облачного хранилища объектов Alibaba и облачному хранилищу Google.
Если набор данных хранится в папке, ее имя должно быть указано в пути, например, c:/temp/amazons3.acs/foldername/someraster.
Инструмент проверяет указанные учетные данные во время работы. Если подключение установить не удается, инструмент завершает работу с ошибкой.
Чтобы использовать этот инструмент с ролью Amazon Web Services (AWS) Identity и Access Management (IAM), оставьте параметры Идентификатор ключа доступа и Секретный ключ доступа пустыми. Если роль IAM настроена правильно, при запуске этого инструмента на компьютере с EC2, будет установлено подключение. Затем созданный файл подключения можно использовать в той же среде.
Синтаксис
arcpy.management.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 (Дополнительный) | Папка в параметре Bucket (Container) Name, в которой будет храниться набор растровых данных. | String |
Производные выходные данные
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: Да