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

Сводка

Создает файл подключения к облачному хранилищу, поддерживаемому 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

Указывается поставщик услуг облачного хранения.

  • AZUREПоставщик услуг будет Microsoft Azure.
  • AMAZONПоставщик услуг будет Amazon S3.
  • GOOGLEПоставщик услуг будет Google Cloud Storage.
  • ALIBABAПоставщик услуг будет Alibaba Cloud Storage.
  • WEBHDFSПоставщик услуг будет WebHDFS.
  • MINIOПоставщик услуг будет MinIO.
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

Путь к выходному файлу подключения к облачному хранилищу.

Файл

Пример кода

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)

Environments

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы