Volver al principio

Crear archivo de conexión de almacenamiento en la nube (Administración de datos)

En este tema

  1. Resumen
  2. Uso
  3. Parámetros
  4. Entornos
  5. Información de licenciamiento

Resumen

Crea un archivo de conexión para el almacenamiento en la nube compatible con ArcGIS. Esta herramienta permite que las herramientas de geoprocesamiento de ráster existentes escriban datasets en formato de ráster de nube (CRF) en datasets ráster de lectura o de depósito de almacenamiento en la nube (no solo CRF) almacenados en el almacenamiento en la nube como entrada.

Uso

  • Para ejecutar esta herramienta, debe proporcionar la información necesaria para realizar una conexión de almacenamiento en la nube, como un ID de clave de acceso, una cadena de clave de acceso secreta y un nombre de depósito. También puede utilizar métodos de autenticación alternativos utilizando el parámetro Opciones de proveedor.

    Más información sobre cómo conectarse a un almacén en la nube

  • La herramienta genera un archivo de conexión de almacenamiento en la nube binario (.acs) en formato de almacenamiento en la nube de ArcGIS.

  • El dataset ráster almacenado en el almacenamiento en la nube se puede referenciar mediante una ruta de archivo, por ejemplo, c:/temp/amazons3.acs/someraster. Si el dataset se almacena en una carpeta en el depósito, el nombre de la carpeta se debe incluir en la ruta, por ejemplo, c:/temp/amazons3.acs/foldername/someraster.

  • Esta herramienta admite conexiones con depósitos Amazon Simple Storage Service (S3), contenedores de almacenamiento de Blob Microsoft Azure, almacenamiento Microsoft Azure Data Lake Storage Gen2, depósitos Alibaba Cloud Object Storage Service (OSS), depósitos GCS (Google Cloud Storage Service), WebHDFS, MinIO y depósitos Ozone Object Storage Service.

  • Se puede utilizar una URL de punto final personalizada para admitir cualquier almacenamiento de objetos compatible con S3 o registro CNAME.

  • La herramienta valida las credenciales proporcionadas en el tiempo de ejecución. Si no se puede establecer la conexión, la herramienta devuelve una advertencia.

  • La autenticación OAuth 2.0 con Azure Active Directory se admite con un inicio de sesión de usuario interactivo para Azure y Azure Data Lake Storage Gen2. Consulte Conectarse a proveedores de autenticación desde ArcGIS Pro para obtener información sobe la configuración. Una vez configurado y que el usuario haya iniciado sesión, el parámetro de autenticación pasa a estar activo para Azure y Azure Data Lake Storage Gen2. La región y el extremo se recuperarán de la configuración.

  • La compatibilidad con identidades administradas asignadas por el usuario utilizando Azure Active Directory en una máquina virtual Azure está disponible para Azure y Azure Data Lake Storage Gen2.

  • El control de acceso basado en roles (RBAC) está disponible para los proveedores de nube Amazon, Azure y Google. Mantener todos los parámetros de autenticación vacíos mientras se utiliza una máquina virtual EC2 o Azure o Google Compute Engine permitirá a ArcGIS Pro acceder al almacenamiento Blob utilizando roles IAM o Azure RBAC. Para Amazon, se admite IMDSv1 e IMDSv2.

    Microsoft Azure Data Lake Storage Storage Gen2 sigue las mismas opciones que Azure, pero proporciona un verdadero soporte de directorio y operaciones atómicas utilizando un extremo DFS. Algunos fallos de red durante las operaciones en la nube se vuelven a intentar tras un backoff exponencial.

    Para más información sobre rendimiento, consulte la documentación sobre sistemas de archivos virtuales de GDAL.

Parámetros

Cuadro de diálogoPython

EtiquetaExplicaciónTipo de datos
Ubicación del archivo de conexión

La ruta de la carpeta donde se creará el archivo de conexión.

Folder
Nombre del archivo de conexión

El nombre del archivo de conexión de almacenamiento en la nube.

String
Proveedor de servicios

Especifica el proveedor de servicios de almacenamiento en la nube que se utilizará.

  • Azur—El proveedor de servicios será Microsoft Azure.
  • Amazon—El proveedor de servicios será Amazon S3.
  • Google—El proveedor de servicios será Google Cloud Storage.
  • Alibaba—El proveedor de servicios será Alibaba Cloud Storage.
  • WebHDFS—El proveedor de servicios será WebHDFS.
  • MinIO—El proveedor de servicios será MinIO.
  • Azure Data Lake—El proveedor de servicios será Microsoft Azure Data Lake Storage.
  • Ozone—El proveedor de servicios será Ozone.
String
Nombre de depósito (Contenedor)

El nombre del contenedor de almacenamiento en la nube en el que se almacenará el dataset ráster. Muchos proveedores de servicios en la nube también lo denominan depósito.

String
Id. de clave de acceso (Nombre de cuenta)
(Opcional)

La cadena de Id. de clave de acceso para el tipo de almacenamiento en la nube específico. También puede ser el nombre de cuenta, como en el caso de Azure.

String
Clave de acceso secreta (Clave de cuenta)
(Opcional)

La cadena de clave de acceso secreta para autenticar la conexión al almacenamiento en la nube.

Encrypted String
Región (Entorno)
(Opcional)

La cadena de región para el almacenamiento en la nube. Si se proporciona, el valor debe usar el formato definido por la opción de almacenamiento en la nube. El valor predeterminado es la cuenta predeterminada del proveedor de nube seleccionado.

String
Extremo del servicio
(Opcional)

Extremo de servicio (URI) del almacenamiento en la nube, por ejemplo, oss-us-west-1.aliyuncs.com. Si no se proporciona ningún valor, se utilizará el extremo predeterminado para el tipo de almacenamiento en la nube seleccionado. También se puede utilizar el extremo redirigido CNAME si es necesario.

String
Opciones de proveedor
(Opcional)

Las opciones de configuración que pertenecen al tipo específico de servicio en la nube. Algunos servicios ofrecen opciones y otros no. Solo tiene que configurar este parámetro si desea activar las opciones.

  • Azure y Microsoft Azure Data Lake Storage
    • AZURE_STORAGE_SAS_TOKEN: especifique una firma de acceso compartido. Asegúrese de que su valor esté codificado como URL y no contenga caracteres iniciales "?" ni "&". Cuando se utiliza esta opción, el parámetro Clave de acceso secreta (Clave de cuenta) debe estar vacío.
    • AZURE_NO_SIGN_REQUEST: conéctese de forma anónima a buckets (contenedores) que no requieren acceso autenticado. Cuando se utiliza esta opción, el parámetro Clave de acceso secreta (Clave de cuenta) debe estar vacío. El valor predeterminado es Falso.
    • AZURE_STORAGE_CONNECTION_STRING: especififque una cadena de conexión a Azure Storage. Esta cadena incluye el nombre de la cuenta, la clave y el extremo. Cuando se utiliza esta opción, los parámetros ID de clave de acceso (Nombre de cuenta) y Clave de acceso secreta (Clave de cuenta) deben estar vacíos.
    • CPL_AZURE_USE_HTTPS: establézcalo en Falso para utilizar solicitudes HTTP. Algunos servidores pueden estar configurados para admitir únicamente solicitudes HTTPS. El valor predeterminado es True.
    • AZURE_IMDS_OBJECT_ID: especifique el ID de objeto de la identidad administrada autenticada mediante Azure Instance Metadata Service (IMDS) si su máquina virtual Azure tiene varias identidades gestionadas asignadas por el usuario.
    • AZURE_IMDS_CLIENT_ID: especifique el ID de cliente de la identidad administrada autenticada mediante Azure Instance Metadata Service (IMDS) si su máquina virtual Azure tiene varias identidades administradas asignadas por el usuario.
    • AZURE_IMDS_MSI_RES_ID: especifique el ID de recurso de la identidad administrada autenticada mediante Azure Instance Metadata Service (IMDS) si su máquina virtual Azure tiene varias identidades gestionadas asignadas por el usuario.
  • Amazon y MinIO
    • AWS_NO_SIGN_REQUEST: conéctese de forma anónima a buckets (contenedores) que no requieren acceso autenticado. El valor predeterminado es Falso.
    • AWS_SESSION_TOKEN: especifique credenciales temporales.
    • AWS_DEFAULT_PROFILE: los perfiles de credenciales AWS se utilizan automáticamente cuando falta la clave de acceso o el ID. Esta opción puede utilizarse para especificar el perfil que debe utilizarse.
    • AWS_REQUEST_PAYER: es posible acceder a los buckets de Requester Pays configurando esta opción como solicitante.
    • AWS_Virtual_Hosting: si utiliza proveedores de nube compatibles con Amazon S3 o S3 que solo admitan solicitudes de tipo ruta, establezca esta opción en Verdadero. Se recomienda utilizar alojamiento virtual si es compatible. El valor predeterminado es True.
    • CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE: algunas implementaciones antiguas compatibles con S3 no admiten la operación de eliminación masiva. Establezca esta opción en Falso para dichos proveedores. El valor predeterminado es True.
    • AWS_HTTPS: establézcalo en Falso para utilizar solicitudes HTTP. : establézcalo en Falso para utilizar solicitudes HTTP. El valor predeterminado es True.
  • Google
    • GS_NO_SIGN_REQUEST: conéctese de forma anónima a buckets (contenedores) que no requieren acceso autenticado. El valor predeterminado es Verdadero.
    • GS_USER_PROJECT: es posible acceder a los buckets de Requester Pays configurando claves OAuth2 y un proyecto para facturación. Establezca el proyecto utilizando esta opción y establezca claves OAuth2 utilizando otras opciones y no claves HMAC como clave de acceso secreta o ID.
    • GS_OAUTH2_REFRESH_TOKEN: especifique Token de acceso OAuth2 Refresh. Establezca las credenciales de cliente OAuth2 mediante GS_OAUTH2_CLIENT_ID y GS_OAUTH2_CLIENT_SECRET.
    • GOOGLE_APPLICATION_CREDENTIALS: especifique las credenciales de OAuth2 de cuenta de servicio utilizando un archivo .json que contenga una clave privada y una dirección de correo electrónico de cliente.
    • GS_OAUTH2_ PRIVATE_KEY: especifique las credenciales de OAuth2 de cuenta de servicio utilizando una cadena de clave privada. Debe configurarse GS_AUTH2_CLIENT_EMAIL.
    • GS_OAUTH2_ PRIVATE_KEY_FILE: especifique las credenciales de OAuth2 de cuenta de servicio utilizando una clave privada de un archivo. Debe configurarse GS_AUTH2_CLIENT_EMAIL.
    • GS_AUTH2_CLIENT_EMAIL: especifique las credenciales de OAuth2 de cuenta de servicio utilizando una dirección de correo electrónico de cliente.
    • GS_AUTH2_SCOPE: especifique un ámbito de OAuth2 de cuenta de servicio. Los valores válidos son https://www.googleapis.com/auth/devstorage.read_write (valor predeterminado) y https://www.googleapis.com/auth/devstorage.read_only.
    • GDAL_HTTP_HEADER_FILE: especifique las credenciales de portador almacenadas en un archivo externo.
  • Alibaba
    • OSS_Virtual_Hosting: si utiliza proveedores de nube compatibles con Alibaba o S3 que solo admitan solicitudes de tipo ruta, establezca esta opción en Verdadero. Se recomienda utilizar alojamiento virtual si es compatible. El valor predeterminado es True.
    • OSS_HTTPS: establézcalo en Falso para utilizar solicitudes HTTP. : establézcalo en Falso para utilizar solicitudes HTTP. El valor predeterminado es True.
  • WebHDFS
    • WEBHDFS_REPLICATION (entero): se utiliza el valor de replicación al crear un archivo.
    • WEBHDFS_PERMISSION (decimal): se utiliza una máscara de permisos al crear un archivo.

Si se proporcionan varios parámetros de autenticación, la prioridad es la siguiente:

  • Azure: AZURE_STORAGE_CONNECTION_STRING, nombre o clave de cuenta, AZURE_STORAGE_SAS_TOKEN, AZURE_NO_SIGN_REQUEST o RBAC.
  • Amazon: AWS_NO_SIGN_REQUEST, ID o clave de acceso oAWS_SESSION_TOKEN, AWS Credential Profile o IAM Role.
  • Google: GS_NO_SIGN_REQUEST, ID o clave de acceso, 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) o IAM Role.
  • Ozone
    • AWS_DEFAULT_PROFILE: los perfiles de credenciales AWS se utilizan automáticamente cuando falta la clave de acceso o el ID. Esta opción puede utilizarse para especificar el perfil que debe utilizarse.
    • AWS_Virtual_Hosting: si utiliza proveedores de nube compatibles con Amazon S3 o S3 que solo admitan solicitudes de tipo ruta, establezca esta opción en Verdadero. Se recomienda utilizar alojamiento virtual si es compatible. El valor predeterminado es True.
    • AWS_HTTPS: establézcalo en Falso para utilizar solicitudes HTTP. : establézcalo en Falso para utilizar solicitudes HTTP. El valor predeterminado es True.
    • CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE: algunas implementaciones antiguas compatibles con S3 no admiten la operación de eliminación masiva. Establezca esta opción en Falso para dichos proveedores. El valor predeterminado es True.
    • x-amz-storage-class: especifique REDUCED_REDUNDANCY para escribir en un único contenedor Ozone, ya que tiene un único nodo de datos.

Además de las opciones de proveedor indicadas, la opción ARC_DEEP_CRAWL puede utilizarse con todos los proveedores de servicios. Si es True, se utiliza para identificar en la nube los CRF sin extensión y los productos ráster habilitados para la nube. Esta operación requiere muchos recursos, por lo que recomienda establecerla en False para poder rastrear y navegar por el catálogo con mayor rapidez. El valor predeterminado es True.

Los servicios de venta de tokens personalizados, como la recopilación de datos de Planetary Computer, por ejemplo, pueden autenticarse mediante las opciones de proveedor ARC_TOKEN_SERVICE_API (URL del proveedor de tokens) y ARC_TOKEN_OPTION_NAME (tipo de token del proveedor de servicios).

Nota:

La opción GDAL_DISABLE_READDIR_ON_OPEN está disponible en todos los proveedores de servicios. Para mejorar el rendimiento de la carga de los rásteres basados en la nube, de forma predeterminada esta opción está establecida en NO. Si el ráster reside en una carpeta que contiene más de 30.000 elementos, establezca esta opción en YES.

Value Table
Carpeta
(Opcional)

Carpeta del parámetro Nombre de bucket (contenedor) en la que se almacenará el dataset ráster.

String
Autenticación
(Opcional)

Nombre de conexión de la autenticación OAuth 2.0.

Debe configurarse una conexión válida en el cuadro de diálogo Opciones de la pestaña Autenticación.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Archivo de conexión de salida

La ruta del archivo de conexión de almacenamiento en la nube de salida.

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})
NombreExplicaciónTipo de datos
out_folder_path

La ruta de la carpeta donde se creará el archivo de conexión.

Folder
out_name

El nombre del archivo de conexión de almacenamiento en la nube.

String
service_provider

Especifica el proveedor de servicios de almacenamiento en la nube que se utilizará.

  • AZURE—El proveedor de servicios será Microsoft Azure.
  • AMAZON—El proveedor de servicios será Amazon S3.
  • GOOGLE—El proveedor de servicios será Google Cloud Storage.
  • ALIBABA—El proveedor de servicios será Alibaba Cloud Storage.
  • WEBHDFS—El proveedor de servicios será WebHDFS.
  • MINIO—El proveedor de servicios será MinIO.
  • AZUREDATALAKE—El proveedor de servicios será Microsoft Azure Data Lake Storage.
  • OZONE—El proveedor de servicios será Ozone.
String
bucket_name

El nombre del contenedor de almacenamiento en la nube en el que se almacenará el dataset ráster. Muchos proveedores de servicios en la nube también lo denominan depósito.

String
access_key_id
(Opcional)

La cadena de Id. de clave de acceso para el tipo de almacenamiento en la nube específico. También puede ser el nombre de cuenta, como en el caso de Azure.

String
secret_access_key
(Opcional)

La cadena de clave de acceso secreta para autenticar la conexión al almacenamiento en la nube.

Encrypted String
region
(Opcional)

La cadena de región para el almacenamiento en la nube. Si se proporciona, el valor debe usar el formato definido por la opción de almacenamiento en la nube. El valor predeterminado es la cuenta predeterminada del proveedor de nube seleccionado.

String
end_point
(Opcional)

Extremo de servicio (URI) del almacenamiento en la nube, por ejemplo, oss-us-west-1.aliyuncs.com. Si no se proporciona ningún valor, se utilizará el extremo predeterminado para el tipo de almacenamiento en la nube seleccionado. También se puede utilizar el extremo redirigido CNAME si es necesario.

String
config_options
[config_options,...]
(Opcional)

Las opciones de configuración que pertenecen al tipo específico de servicio en la nube. Algunos servicios ofrecen opciones y otros no. Solo tiene que configurar este parámetro si desea activar las opciones.

  • Azure y Microsoft Azure Data Lake Storage
    • AZURE_STORAGE_SAS_TOKEN: especifique una firma de acceso compartido. Asegúrese de que su valor esté codificado como URL y no contenga caracteres iniciales "?" ni "&". Cuando se utiliza esta opción, el parámetro Clave de acceso secreta (Clave de cuenta) debe estar vacío.
    • AZURE_NO_SIGN_REQUEST: conéctese de forma anónima a buckets (contenedores) que no requieren acceso autenticado. Cuando se utiliza esta opción, el parámetro Clave de acceso secreta (Clave de cuenta) debe estar vacío. El valor predeterminado es Falso.
    • AZURE_STORAGE_CONNECTION_STRING: especififque una cadena de conexión a Azure Storage. Esta cadena incluye el nombre de la cuenta, la clave y el extremo. Cuando se utiliza esta opción, los parámetros ID de clave de acceso (Nombre de cuenta) y Clave de acceso secreta (Clave de cuenta) deben estar vacíos.
    • CPL_AZURE_USE_HTTPS: establézcalo en Falso para utilizar solicitudes HTTP. Algunos servidores pueden estar configurados para admitir únicamente solicitudes HTTPS. El valor predeterminado es True.
    • AZURE_IMDS_OBJECT_ID: especifique el ID de objeto de la identidad administrada autenticada mediante Azure Instance Metadata Service (IMDS) si su máquina virtual Azure tiene varias identidades gestionadas asignadas por el usuario.
    • AZURE_IMDS_CLIENT_ID: especifique el ID de cliente de la identidad administrada autenticada mediante Azure Instance Metadata Service (IMDS) si su máquina virtual Azure tiene varias identidades administradas asignadas por el usuario.
    • AZURE_IMDS_MSI_RES_ID: especifique el ID de recurso de la identidad administrada autenticada mediante Azure Instance Metadata Service (IMDS) si su máquina virtual Azure tiene varias identidades gestionadas asignadas por el usuario.
  • Amazon y MinIO
    • AWS_NO_SIGN_REQUEST: conéctese de forma anónima a buckets (contenedores) que no requieren acceso autenticado. El valor predeterminado es Falso.
    • AWS_SESSION_TOKEN: especifique credenciales temporales.
    • AWS_DEFAULT_PROFILE: los perfiles de credenciales AWS se utilizan automáticamente cuando falta la clave de acceso o el ID. Esta opción puede utilizarse para especificar el perfil que debe utilizarse.
    • AWS_REQUEST_PAYER: es posible acceder a los buckets de Requester Pays configurando esta opción como solicitante.
    • AWS_Virtual_Hosting: si utiliza proveedores de nube compatibles con Amazon S3 o S3 que solo admitan solicitudes de tipo ruta, establezca esta opción en Verdadero. Se recomienda utilizar alojamiento virtual si es compatible. El valor predeterminado es True.
    • CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE: algunas implementaciones antiguas compatibles con S3 no admiten la operación de eliminación masiva. Establezca esta opción en Falso para dichos proveedores. El valor predeterminado es True.
    • AWS_HTTPS: establézcalo en Falso para utilizar solicitudes HTTP. : establézcalo en Falso para utilizar solicitudes HTTP. El valor predeterminado es True.
  • Google
    • GS_NO_SIGN_REQUEST: conéctese de forma anónima a buckets (contenedores) que no requieren acceso autenticado. El valor predeterminado es Verdadero.
    • GS_USER_PROJECT: es posible acceder a los buckets de Requester Pays configurando claves OAuth2 y un proyecto para facturación. Establezca el proyecto utilizando esta opción y establezca claves OAuth2 utilizando otras opciones y no claves HMAC como clave de acceso secreta o ID.
    • GS_OAUTH2_REFRESH_TOKEN: especifique Token de acceso OAuth2 Refresh. Establezca las credenciales de cliente OAuth2 mediante GS_OAUTH2_CLIENT_ID y GS_OAUTH2_CLIENT_SECRET.
    • GOOGLE_APPLICATION_CREDENTIALS: especifique las credenciales de OAuth2 de cuenta de servicio utilizando un archivo .json que contenga una clave privada y una dirección de correo electrónico de cliente.
    • GS_OAUTH2_ PRIVATE_KEY: especifique las credenciales de OAuth2 de cuenta de servicio utilizando una cadena de clave privada. Debe configurarse GS_AUTH2_CLIENT_EMAIL.
    • GS_OAUTH2_ PRIVATE_KEY_FILE: especifique las credenciales de OAuth2 de cuenta de servicio utilizando una clave privada de un archivo. Debe configurarse GS_AUTH2_CLIENT_EMAIL.
    • GS_AUTH2_CLIENT_EMAIL: especifique las credenciales de OAuth2 de cuenta de servicio utilizando una dirección de correo electrónico de cliente.
    • GS_AUTH2_SCOPE: especifique un ámbito de OAuth2 de cuenta de servicio. Los valores válidos son https://www.googleapis.com/auth/devstorage.read_write (valor predeterminado) y https://www.googleapis.com/auth/devstorage.read_only.
    • GDAL_HTTP_HEADER_FILE: especifique las credenciales de portador almacenadas en un archivo externo.
  • Alibaba
    • OSS_Virtual_Hosting: si utiliza proveedores de nube compatibles con Alibaba o S3 que solo admitan solicitudes de tipo ruta, establezca esta opción en Verdadero. Se recomienda utilizar alojamiento virtual si es compatible. El valor predeterminado es True.
    • OSS_HTTPS: establézcalo en Falso para utilizar solicitudes HTTP. : establézcalo en Falso para utilizar solicitudes HTTP. El valor predeterminado es True.
  • WebHDFS
    • WEBHDFS_REPLICATION (entero): se utiliza el valor de replicación al crear un archivo.
    • WEBHDFS_PERMISSION (decimal): se utiliza una máscara de permisos al crear un archivo.

Si se proporcionan varios parámetros de autenticación, la prioridad es la siguiente:

  • Azure: AZURE_STORAGE_CONNECTION_STRING, nombre o clave de cuenta, AZURE_STORAGE_SAS_TOKEN, AZURE_NO_SIGN_REQUEST o RBAC.
  • Amazon: AWS_NO_SIGN_REQUEST, ID o clave de acceso oAWS_SESSION_TOKEN, AWS Credential Profile o IAM Role.
  • Google: GS_NO_SIGN_REQUEST, ID o clave de acceso, 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) o IAM Role.
  • Ozone
    • AWS_DEFAULT_PROFILE: los perfiles de credenciales AWS se utilizan automáticamente cuando falta la clave de acceso o el ID. Esta opción puede utilizarse para especificar el perfil que debe utilizarse.
    • AWS_Virtual_Hosting: si utiliza proveedores de nube compatibles con Amazon S3 o S3 que solo admitan solicitudes de tipo ruta, establezca esta opción en Verdadero. Se recomienda utilizar alojamiento virtual si es compatible. El valor predeterminado es True.
    • AWS_HTTPS: establézcalo en Falso para utilizar solicitudes HTTP. : establézcalo en Falso para utilizar solicitudes HTTP. El valor predeterminado es True.
    • CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE: algunas implementaciones antiguas compatibles con S3 no admiten la operación de eliminación masiva. Establezca esta opción en Falso para dichos proveedores. El valor predeterminado es True.
    • x-amz-storage-class: especifique REDUCED_REDUNDANCY para escribir en un único contenedor Ozone, ya que tiene un único nodo de datos.

Además de las opciones de proveedor indicadas, la opción ARC_DEEP_CRAWL puede utilizarse con todos los proveedores de servicios. Si es True, se utiliza para identificar en la nube los CRF sin extensión y los productos ráster habilitados para la nube. Esta operación requiere muchos recursos, por lo que recomienda establecerla en False para poder rastrear y navegar por el catálogo con mayor rapidez. El valor predeterminado es True.

Los servicios de venta de tokens personalizados, como la recopilación de datos de Planetary Computer, por ejemplo, pueden autenticarse mediante las opciones de proveedor ARC_TOKEN_SERVICE_API (URL del proveedor de tokens) y ARC_TOKEN_OPTION_NAME (tipo de token del proveedor de servicios).

Nota:

La opción GDAL_DISABLE_READDIR_ON_OPEN está disponible en todos los proveedores de servicios. Para mejorar el rendimiento de la carga de los rásteres basados en la nube, de forma predeterminada esta opción está establecida en NO. Si el ráster reside en una carpeta que contiene más de 30.000 elementos, establezca esta opción en YES.

Value Table
folder
(Opcional)

Carpeta del valor del parámetro bucket_name en la que se almacenará el dataset ráster.

String
authentication
(Opcional)

Nombre de conexión de la autenticación OAuth 2.0.

String

Salida derivada

NombreExplicaciónTipo de datos
out_connection

La ruta del archivo de conexión de almacenamiento en la nube de salida.

File

Muestra de código

Ejemplo 1 de CreateCloudStorageConnectionFile (ventana de Python)

Se trata de un ejemplo de Python para la función 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")
Ejemplo 2 de CreateCloudStorageConnectionFile (script independiente)

Se trata de un ejemplo de Python para la función 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)
Ejemplo 3 de CreateCloudStorageConnectionFile (ventana de Python)

Se trata de un ejemplo Python para la función CreateCloudStorageConnectionFile para establecer conexión con servicios de venta de tokens.

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

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados

  • Vista general del conjunto de herramientas Espacio de trabajo
  • Buscar una herramienta de geoprocesamiento

¿Algún comentario sobre este tema?

En este tema
  1. Resumen
  2. Uso
  3. Parámetros
  4. Entornos
  5. Información de licenciamiento