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

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

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

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

  • Чтобы запустить этот инструмент требуется предоставить необходимую информацию для подключения к облачному хранилищу, такую как ID ключа доступа, Секретный ключ доступа и Имя бакета. Также можно использовать альтернативные методы аутентификации, используя параметр Опции провайдера.

    Подробнее о подключении к облачным хранилищам

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

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

  • Этот инструмент поддерживает подключения к бакетам Amazon Simple Storage Service (S3), контейнерам хранилища BLOB-объектов Microsoft Azure, Microsoft Azure Data Lake Storage Storage Gen2, бакетам Alibaba Cloud Object Storage Service (OSS), бакетам службы облачного хранилища объектов Google Cloud (GCS), WebHDFS, MinIO и бакетам службы хранения объектов Ozone.

  • Собственный URL-адрес конечной точки может использоваться для поддержки любого хранилища объектов, совместимого с S3, или записи CNAME.

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

  • Аутентификация OAuth 2.0 с помощью Azure Active Directory поддерживается с помощью интерактивного входа пользователя для Azure и Azure Data Lake Storage Gen 2. Информацию о настройке смотрите в разделе Подключение к провайдерам аутентификации из ArcGIS Pro. После настройки и входа пользователя в систему параметр аутентификации становится активным для Azure и Azure Data Lake Storage Gen2. Регион и конечная точка будут извлечены из конфигурации.

  • Поддержка назначаемых пользователем управляемых идентификаторов, используемых Azure Active Directory на виртуальной машине Azure, доступна для Azure и Azure Data Lake Storage Gen2.

  • Контроль доступа на основе роли (RBAC) доступен для Amazon, Azure и облачных провайдеров Google. Сохранение всех параметров аутентификации пустыми при использовании виртуальной машины EC2 или Azure, или Google Compute Engine позволит ArcGIS Pro получить доступ к хранилищу больших двоичных объектов (Blob) с использованием ролей IAM или Azure RBAC. Для Amazon поддерживаются IMDSv1 и IMDSv2.

    Хранилище Microsoft Azure Data Lake Storage Gen2 использует те же параметры, что и Azure, но обеспечивает истинную поддержку каталогов и атомарные операции с использованием конечной точки DFS. Некоторые ошибки сети во время облачных операций повторяются после экспоненциального отключения.

    Сведения о производительности и дополнительную информацию см. в документации по виртуальным файловым системам GDAL.

Параметры

ПодписьОписаниеТип данных
Местоположение файла подключения

Путь к папке, где будет создан файл подключения.

Folder
Имя файла подключения

Имя файла подключения к облачному хранилищу.

String
Провайдер сервиса

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

  • ЛазурныйПоставщиком услуг будет Microsoft Azure.
  • AmazonПоставщиком услуг будет Amazon S3.
  • GoogleПоставщиком услуг будет Google Cloud Storage.
  • AlibabaПоставщиком услуг будет Alibaba Cloud Storage.
  • WebHDFSПоставщик услуг будет WebHDFS.
  • MinIOПоставщик услуг будет MinIO.
  • Azure Data LakeПоставщиком услуг будет Microsoft Azure Data Lake Storage.
  • OzoneПоставщиком услуг будет Ozone.
String
Имя бакета (контейнера)

Имя контейнера облачного хранилища, где будет находиться набор данных. Многие облачные провайдеры также называют это бакетом.

String
ID ключа доступа (Имя учетной записи)
(Дополнительный)

Строка ID ключа доступа для определенных типов облачных хранилищ. Также может быть именем учетной записи, как например с Azure.

String
Секретный ключ доступа (Ключ учетной записи)
(Дополнительный)

Строка секретного ключа доступа для аутентификации подключения к облачному хранилищу.

Encrypted String
Регион (Среда)
(Дополнительный)

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

String
Конечная точка сервиса
(Дополнительный)

Конечная точка сервиса (URI) облачного хранилища, например, oss-us-west-1.aliyuncs.com. Если значение не указано, будет использоваться конечная точка по умолчанию для выбранного типа облачного хранилища. При необходимости также можно использовать перенаправленную конечную точку CNAME.

String
Опции провайдера
(Дополнительный)

Параметры конфигурации, относящиеся к определенному типу облачного сервиса. У некоторых сервисов имеются такие опции, у других - нет. Параметр необходимо задавать, только если вы хотите включить опции.

  • Azure и Microsoft Azure Data Lake Storage
    • AZURE_STORAGE_SAS_TOKEN—Укажите подпись общего доступа. Убедитесь, что это значение закодировано в URL-адресе и не содержит начальных символов '?' или '&'. При использовании этой опции параметр Секретный ключ доступа (Ключ учетной записи) должен быть пустым.
    • AZURE_NO_SIGN_REQUEST—Анонимное подключение к бакетам (контейнерам), которые не требуют аутентифицированного доступа. При использовании этой опции параметр Секретный ключ доступа (Ключ учетной записи) должен быть пустым. Значением по умолчанию является False.
    • AZURE_STORAGE_CONNECTION_STRING—Укажите строку подключения к хранилищу Azure . В эту строку вставляются имя учетной записи, ключ и конечная точка. При использовании этой опции параметры ID ключа доступа (Имя учетной записи) и Секретный ключ доступа (Ключ учетной записи) должны быть пустыми.
    • CPL_AZURE_USE_HTTPS—Установите значение False для использования HTTP-запросов. Некоторые серверы могут быть настроены только на поддержку HTTPS-запросов. По умолчанию используется значение Да (True).
    • AZURE_IMDS_OBJECT_ID—Укажите ID объекта управляемого идентификатора, прошедшего проверку подлинности с помощью Azure Instance Metadata Service (IMDS), если на вашей виртуальной машине Azure установлено несколько назначенных пользователем управляемых идентификаторов.
    • AZURE_IMDS_CLIENT_ID—Укажите ID клиента управляемого идентификатора, прошедшего проверку подлинности с помощью Azure Instance Metadata Service (IMDS), если на вашей виртуальной машине Azure установлено несколько назначенных пользователем управляемых идентификаторов.
    • AZURE_IMDS_MSI_RES_ID—Укажите ID ресурса управляемого идентификатора, прошедшего проверку подлинности с помощью Azure Instance Metadata Service (IMDS), если на вашей виртуальной машине Azure установлено несколько назначенных пользователем управляемых идентификаторов.
  • Amazon и MinIO
    • AWS_NO_SIGN_REQUEST—Анонимное подключение к бакетам (контейнерам), которое не требует аутентифицированного доступа. Значением по умолчанию является False.
    • AWS_SESSION_TOKEN—Укажите временные учетные данные.
    • AWS_DEFAULT_PROFILEПрофили учетных данных AWS автоматически используются при отсутствии ключа доступа или ID. Эта опция может использоваться для указания используемого профиля.
    • AWS_REQUEST_PAYERЗаказчик оплачивает бакеты, к которым можно получить доступ, установив для этой опции значение requester.
    • AWS_Virtual_Hosting—Если вы используете облачные провайдеры Amazon S3, совместимые с S3, которые поддерживают только запросы в стиле пути (path), установите для этого параметра значение True. Рекомендуется использовать виртуальный хостинг, если он поддерживается. По умолчанию используется значение Да (True).
    • CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE—Некоторые старые реализации, совместимые с S3, не поддерживают операцию пакетного удаления Bulk Delete. Установите для этого параметра значение False для этих поставщиков. По умолчанию используется значение Да (True).
    • AWS_HTTPS—Установите значение False для использования HTTP-запросов. Некоторые серверы могут быть настроены только на поддержку HTTPS-запросов. По умолчанию используется значение Да (True).
  • Google
    • GS_NO_SIGN_REQUEST—Анонимное подключение к бакетам (контейнерам), которое не требует аутентифицированного доступа. По умолчанию используется значение Да (True)
    • GS_USER_PROJECTЗаказчик оплачивает бакеты, к которым можно получить доступ, установив ключи OAuth2 и проект для выставления счетов. Установите проект, используя эту опцию, и установите ключи OAuth2, используя другие опции, а не ключи HMAC, в качестве секретного ключа доступа или идентификатора.
    • GS_OAUTH2_REFRESH_TOKEN—Укажите токен доступа к обновлению OAuth2. Установите учетные данные клиента OAuth2, используя GS_OAUTH2_CLIENT_ID и GS_OAUTH2_CLIENT_SECRET.
    • GOOGLE_APPLICATION_CREDENTIALS—Укажите учетные данные служебной записи OAuth2, используя файл .json, содержащий закрытый ключ и адрес электронной почты клиента.
    • GS_OAUTH2_ PRIVATE_KEY—Укажите учетные данные учетной записи службы OAuth2, используя строку закрытого ключа. GS_AUTH2_CLIENT_EMAIL должен быть задан.
    • GS_OAUTH2_ PRIVATE_KEY_FILE—Укажите учетные данные учетной записи службы OAuth2, используя закрытый ключ из файла. GS_AUTH2_CLIENT_EMAIL должен быть задан.
    • GS_AUTH2_CLIENT_EMAIL—Укажите учетные данные учетной записи службы OAuth2, используя адрес электронной почты клиента.
    • GS_AUTH2_SCOPE—Укажите область применения учетной записи службы OAuth2. Допустимыми значениями являются https://www.googleapis.com/auth/devstorage.read_write (по умолчанию) и https://www.googleapis.com/auth/devstorage.read_only.
    • GDAL_HTTP_HEADER_FILE—Укажите учетные данные для аутентификации на предъявителя, хранящиеся во внешнем файле.
  • Alibaba
    • OSS_Virtual_Hosting—Если вы используете облачные провайдеры Alibaba, совместимые с S3, которые поддерживают только запросы в стиле пути path, установите для этого параметра значение True. Рекомендуется использовать виртуальный хостинг, если он поддерживается. По умолчанию используется значение Да (True).
    • OSS_HTTPS—Установите значение False для использования HTTP-запросов. Некоторые серверы могут быть настроены только на поддержку HTTPS-запросов. По умолчанию используется значение Да (True).
  • WebHDFS
    • WEBHDFS_REPLICATION (целое число) — значение репликации используется при создании файла
    • WEBHDFS_PERMISSION(десятичный) — при создании файла используется маска разрешений.

Если задано несколько параметров аутентификации, приоритет следующий:

  • AzureAZURE_STORAGE_CONNECTION_STRING, имя учетной записи или ключ,AZURE_STORAGE_SAS_TOKEN,AZURE_NO_SIGN_REQUEST, илиRBAC .
  • AmazonAWS_NO_SIGN_REQUEST, ID доступа или ключ, или AWS_SESSION_TOKEN,AWS Credential Profile, или IAM Role.
  • GoogleGS_NO_SIGN_REQUEST, ID доступа или ключ, GDAL_HTTP_HEADER_FILE,(GS_OAUTH2_REFRESH_TOKEN or GS_OAUTH2_CLIENT_ID and GS_OAUTH2_CLIENT_SECRET),GOOGLE_APPLICATION_CREDENTIALS,(GS_OAUTH2_PRIVATE_KEY or GS_OAUTH2_CLIENT_EMAIL), (GS_OAUTH2_PRIVATE_KEY_FILE or GS_OAUTH2_CLIENT_EMAIL) или IAM Role.
  • Ozone
    • AWS_DEFAULT_PROFILEПрофили учетных данных AWS автоматически используются при отсутствии ключа доступа или ID. Эта опция может использоваться для указания используемого профиля.
    • AWS_Virtual_Hosting—Если вы используете облачных провайдеров Amazon S3, совместимых с S3, которые поддерживают только запросы в стиле пути (path), установите для этого параметра значение True. Рекомендуется использовать виртуальный хостинг, если он поддерживается. По умолчанию используется значение Да (True).
    • AWS_HTTPS—Установите значение False для использования HTTP-запросов. Некоторые серверы могут быть настроены только на поддержку HTTPS-запросов. По умолчанию используется значение Да (True).
    • CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE—Некоторые старые реализации, совместимые с S3, не поддерживают операцию пакетного удаления. Установите для этой опции значение False для этих поставщиков. По умолчанию используется значение Да (True).
    • x-amz-storage-class—Укажите REDUCED_REDUNDANCY для записи в один контейнер ozone, поскольку он имеет один узел данных.

В дополнение к опциям поставщика, перечисленным выше, опцию ARC_DEEP_CRAWL можно использовать со всеми поставщиками услуг. Если значение равно True, оно используется для идентификации CRF-файлов без расширения и растровых продуктов с поддержкой облачных вычислений в облаке. Это требует больших затрат времени, и рекомендуется установить для этого параметра значение False для более быстрого просмотра каталога. По умолчанию используется значение Да (True).

Пользовательские сервисы по продаже токенов, такие как, например, сбор данных Planetary Computer, могут быть аутентифицированы с использованием параметров провайдера ARC_TOKEN_SERVICE_API (URL поставщика токенов) и ARC_TOKEN_OPTION_NAME (тип токена от поставщика услуг).

Примечание:

Опция GDAL_DISABLE_READDIR_ON_OPEN доступна у всех поставщиков услуг. Чтобы повысить производительность загрузки облачных растров, по умолчанию для этого параметра установлено значение NO. Если растр находится в папке, содержащей более 30 000 элементов, установите для этого параметра значение YES.

Value Table
Папка
(Дополнительный)

Папка со значением параметра Bucket (Container) Name, в которой будет храниться набор растровых данных.

String
Аутентификация
(Дополнительный)

Имя подключения для аутентификации OAuth 2.0.

Рабочее подключение необходимо настроить в диалоговом окне Опции на вкладке Аутентификация.

String

Производные выходные данные

ПодписьОписаниеТип данных
Выходной файл подключения

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

File

arcpy.management.CreateCloudStorageConnectionFile(out_folder_path, out_name, service_provider, bucket_name, {access_key_id}, {secret_access_key}, {region}, {end_point}, {config_options}, {folder}, {authentication})
ИмяОписаниеТип данных
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.
  • AZUREDATALAKEПоставщиком услуг будет Microsoft Azure Data Lake Storage.
  • OZONEПоставщиком услуг будет Ozone.
String
bucket_name

Имя контейнера облачного хранилища, где будет находиться набор данных. Многие облачные провайдеры также называют это бакетом.

String
access_key_id
(Дополнительный)

Строка ID ключа доступа для определенных типов облачных хранилищ. Также может быть именем учетной записи, как например с Azure.

String
secret_access_key
(Дополнительный)

Строка секретного ключа доступа для аутентификации подключения к облачному хранилищу.

Encrypted String
region
(Дополнительный)

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

String
end_point
(Дополнительный)

Конечная точка сервиса (URI) облачного хранилища, например, oss-us-west-1.aliyuncs.com. Если значение не указано, будет использоваться конечная точка по умолчанию для выбранного типа облачного хранилища. При необходимости также можно использовать перенаправленную конечную точку CNAME.

String
config_options
[config_options,...]
(Дополнительный)

Параметры конфигурации, относящиеся к определенному типу облачного сервиса. У некоторых сервисов имеются такие опции, у других - нет. Параметр необходимо задавать, только если вы хотите включить опции.

  • Azure и Microsoft Azure Data Lake Storage
    • AZURE_STORAGE_SAS_TOKEN—Укажите подпись общего доступа. Убедитесь, что это значение закодировано в URL-адресе и не содержит начальных символов '?' или '&'. При использовании этой опции параметр Секретный ключ доступа (Ключ учетной записи) должен быть пустым.
    • AZURE_NO_SIGN_REQUEST—Анонимное подключение к бакетам (контейнерам), которые не требуют аутентифицированного доступа. При использовании этой опции параметр Секретный ключ доступа (Ключ учетной записи) должен быть пустым. Значением по умолчанию является False.
    • AZURE_STORAGE_CONNECTION_STRING—Укажите строку подключения к хранилищу Azure . В эту строку вставляются имя учетной записи, ключ и конечная точка. При использовании этой опции параметры ID ключа доступа (Имя учетной записи) и Секретный ключ доступа (Ключ учетной записи) должны быть пустыми.
    • CPL_AZURE_USE_HTTPS—Установите значение False для использования HTTP-запросов. Некоторые серверы могут быть настроены только на поддержку HTTPS-запросов. По умолчанию используется значение Да (True).
    • AZURE_IMDS_OBJECT_ID—Укажите ID объекта управляемого идентификатора, прошедшего проверку подлинности с помощью Azure Instance Metadata Service (IMDS), если на вашей виртуальной машине Azure установлено несколько назначенных пользователем управляемых идентификаторов.
    • AZURE_IMDS_CLIENT_ID—Укажите ID клиента управляемого идентификатора, прошедшего проверку подлинности с помощью Azure Instance Metadata Service (IMDS), если на вашей виртуальной машине Azure установлено несколько назначенных пользователем управляемых идентификаторов.
    • AZURE_IMDS_MSI_RES_ID—Укажите ID ресурса управляемого идентификатора, прошедшего проверку подлинности с помощью Azure Instance Metadata Service (IMDS), если на вашей виртуальной машине Azure установлено несколько назначенных пользователем управляемых идентификаторов.
  • Amazon и MinIO
    • AWS_NO_SIGN_REQUEST—Анонимное подключение к бакетам (контейнерам), которое не требует аутентифицированного доступа. Значением по умолчанию является False.
    • AWS_SESSION_TOKEN—Укажите временные учетные данные.
    • AWS_DEFAULT_PROFILEПрофили учетных данных AWS автоматически используются при отсутствии ключа доступа или ID. Эта опция может использоваться для указания используемого профиля.
    • AWS_REQUEST_PAYERЗаказчик оплачивает бакеты, к которым можно получить доступ, установив для этой опции значение requester.
    • AWS_Virtual_Hosting—Если вы используете облачные провайдеры Amazon S3, совместимые с S3, которые поддерживают только запросы в стиле пути (path), установите для этого параметра значение True. Рекомендуется использовать виртуальный хостинг, если он поддерживается. По умолчанию используется значение Да (True).
    • CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE—Некоторые старые реализации, совместимые с S3, не поддерживают операцию пакетного удаления Bulk Delete. Установите для этого параметра значение False для этих поставщиков. По умолчанию используется значение Да (True).
    • AWS_HTTPS—Установите значение False для использования HTTP-запросов. Некоторые серверы могут быть настроены только на поддержку HTTPS-запросов. По умолчанию используется значение Да (True).
  • Google
    • GS_NO_SIGN_REQUEST—Анонимное подключение к бакетам (контейнерам), которое не требует аутентифицированного доступа. По умолчанию используется значение Да (True)
    • GS_USER_PROJECTЗаказчик оплачивает бакеты, к которым можно получить доступ, установив ключи OAuth2 и проект для выставления счетов. Установите проект, используя эту опцию, и установите ключи OAuth2, используя другие опции, а не ключи HMAC, в качестве секретного ключа доступа или идентификатора.
    • GS_OAUTH2_REFRESH_TOKEN—Укажите токен доступа к обновлению OAuth2. Установите учетные данные клиента OAuth2, используя GS_OAUTH2_CLIENT_ID и GS_OAUTH2_CLIENT_SECRET.
    • GOOGLE_APPLICATION_CREDENTIALS—Укажите учетные данные служебной записи OAuth2, используя файл .json, содержащий закрытый ключ и адрес электронной почты клиента.
    • GS_OAUTH2_ PRIVATE_KEY—Укажите учетные данные учетной записи службы OAuth2, используя строку закрытого ключа. GS_AUTH2_CLIENT_EMAIL должен быть задан.
    • GS_OAUTH2_ PRIVATE_KEY_FILE—Укажите учетные данные учетной записи службы OAuth2, используя закрытый ключ из файла. GS_AUTH2_CLIENT_EMAIL должен быть задан.
    • GS_AUTH2_CLIENT_EMAIL—Укажите учетные данные учетной записи службы OAuth2, используя адрес электронной почты клиента.
    • GS_AUTH2_SCOPE—Укажите область применения учетной записи службы OAuth2. Допустимыми значениями являются https://www.googleapis.com/auth/devstorage.read_write (по умолчанию) и https://www.googleapis.com/auth/devstorage.read_only.
    • GDAL_HTTP_HEADER_FILE—Укажите учетные данные для аутентификации на предъявителя, хранящиеся во внешнем файле.
  • Alibaba
    • OSS_Virtual_Hosting—Если вы используете облачные провайдеры Alibaba, совместимые с S3, которые поддерживают только запросы в стиле пути path, установите для этого параметра значение True. Рекомендуется использовать виртуальный хостинг, если он поддерживается. По умолчанию используется значение Да (True).
    • OSS_HTTPS—Установите значение False для использования HTTP-запросов. Некоторые серверы могут быть настроены только на поддержку HTTPS-запросов. По умолчанию используется значение Да (True).
  • WebHDFS
    • WEBHDFS_REPLICATION (целое число) — значение репликации используется при создании файла
    • WEBHDFS_PERMISSION(десятичный) — при создании файла используется маска разрешений.

Если задано несколько параметров аутентификации, приоритет следующий:

  • AzureAZURE_STORAGE_CONNECTION_STRING, имя учетной записи или ключ,AZURE_STORAGE_SAS_TOKEN,AZURE_NO_SIGN_REQUEST, илиRBAC .
  • AmazonAWS_NO_SIGN_REQUEST, ID доступа или ключ, или AWS_SESSION_TOKEN,AWS Credential Profile, или IAM Role.
  • GoogleGS_NO_SIGN_REQUEST, ID доступа или ключ, GDAL_HTTP_HEADER_FILE,(GS_OAUTH2_REFRESH_TOKEN or GS_OAUTH2_CLIENT_ID and GS_OAUTH2_CLIENT_SECRET),GOOGLE_APPLICATION_CREDENTIALS,(GS_OAUTH2_PRIVATE_KEY or GS_OAUTH2_CLIENT_EMAIL), (GS_OAUTH2_PRIVATE_KEY_FILE or GS_OAUTH2_CLIENT_EMAIL) или IAM Role.
  • Ozone
    • AWS_DEFAULT_PROFILEПрофили учетных данных AWS автоматически используются при отсутствии ключа доступа или ID. Эта опция может использоваться для указания используемого профиля.
    • AWS_Virtual_Hosting—Если вы используете облачных провайдеров Amazon S3, совместимых с S3, которые поддерживают только запросы в стиле пути (path), установите для этого параметра значение True. Рекомендуется использовать виртуальный хостинг, если он поддерживается. По умолчанию используется значение Да (True).
    • AWS_HTTPS—Установите значение False для использования HTTP-запросов. Некоторые серверы могут быть настроены только на поддержку HTTPS-запросов. По умолчанию используется значение Да (True).
    • CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE—Некоторые старые реализации, совместимые с S3, не поддерживают операцию пакетного удаления. Установите для этой опции значение False для этих поставщиков. По умолчанию используется значение Да (True).
    • x-amz-storage-class—Укажите REDUCED_REDUNDANCY для записи в один контейнер ozone, поскольку он имеет один узел данных.

В дополнение к опциям поставщика, перечисленным выше, опцию ARC_DEEP_CRAWL можно использовать со всеми поставщиками услуг. Если значение равно True, оно используется для идентификации CRF-файлов без расширения и растровых продуктов с поддержкой облачных вычислений в облаке. Это требует больших затрат времени, и рекомендуется установить для этого параметра значение False для более быстрого просмотра каталога. По умолчанию используется значение Да (True).

Пользовательские сервисы по продаже токенов, такие как, например, сбор данных Planetary Computer, могут быть аутентифицированы с использованием параметров провайдера ARC_TOKEN_SERVICE_API (URL поставщика токенов) и ARC_TOKEN_OPTION_NAME (тип токена от поставщика услуг).

Примечание:

Опция GDAL_DISABLE_READDIR_ON_OPEN доступна у всех поставщиков услуг. Чтобы повысить производительность загрузки облачных растров, по умолчанию для этого параметра установлено значение NO. Если растр находится в папке, содержащей более 30 000 элементов, установите для этого параметра значение YES.

Value Table
folder
(Дополнительный)

Папка со значением параметра bucket_name, в которой будет храниться набор растровых данных.

String
authentication
(Дополнительный)

Имя подключения для аутентификации OAuth 2.0.

String

Производные выходные данные

ИмяОписаниеТип данных
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_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 (автономный скрипт)

Это пример 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 = "planetary_landsat.acs"
provider = "Azure"
accesskey = "landsateuwest"
secretkey = ""
bucketname = "landsat-c2"
folder = ""
region = ""
endpoint = ""
config_options= "ARC_TOKEN_OPTION_NAME AZURE_STORAGE_SAS_TOKEN; ARC_TOKEN_SERVICE_API https://planetarycomputer.microsoft.com/api/sas/v1/token/landsateuwest/landsat-c2"

# Create connection to planetary computer landsat data collection

print(arcpy.CreateCloudStorageConnectionFile_management(outfolder, connectname, provider, bucketname, accesskey, secretkey, region, endpoint, config_options, folder))
print(arcpy.GetMessages())

Параметры среды

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

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

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

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