Resumen
Crea un archivo de conexión para el almacenamiento en la nube compatible con ArcGIS. 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
Esta herramienta requiere que proporcione la información necesaria para realizar una conexión de almacenamiento en la nube, como una clave de acceso, una clave de acceso secreta y un nombre de depósito.
La herramienta genera un archivo de conexión de almacenamiento en la nube binario en formato de almacenamiento en la nube de ArcGIS (.icsd).
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.
Entre los proveedores de almacenamiento en la nube compatibles se encuentran Amazon, Azure, Google y Alibaba.
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.
La herramienta validará las credenciales proporcionadas en el tiempo de ejecución. Si no se puede realizar la conexión, la herramienta fallará.
Puede usar esta herramienta junto con el rol administración de identidad y acceso (IAM) de Amazon Web Services (AWS). Para ello, deje vacíos el Id. de clave de acceso y la clave de acceso secreta. Si el rol de IAM está configurado correctamente al ejecutar esta herramienta en un equipo EC2, tiene lugar una conexión correcta. Ahora también es posible usar en el mismo entorno el archivo de conexión creado.
Sintaxis
CreateCloudStorageConnectionFile(out_folder_path, out_name, service_provider, bucket_name, {access_key_id}, {secret_access_key}, {region}, {end_point}, {config_options}, {folder})
Parámetro | Explicación | Tipo 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.
| String |
bucket_name | El nombre del contenedor de almacenamiento en la nube en el que se almacenará el dataset ráster. Para muchos proveedores de servicios en la nube, también se llama 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 el predeterminado de la cuenta del proveedor de servicios en la nube seleccionado. | String |
end_point (Opcional) | El extremo de servicio (uris) del almacenamiento en la nube, por ejemplo, oss-us-west-1.aliyuncs.com. Si no se proporciona el parámetro, se utilizará el extremo predeterminado para el tipo de almacenamiento en la nube seleccionado. Se puede utilizar el extremo redirigido CNAME si es necesario. | String |
config_options [config_options,...] (Opcional) | Especifica las opciones de configuración que pertenecen al tipo específico de servicio en la nube. Algunos servicios ofrecen opciones y otros no. Solo debe configurar la opción si desea activarlos. | Value Table |
folder (Opcional) | Especifique una carpeta en el almacenamiento en la nube Nombre de depósito (contenedor) donde se almacenará el dataset ráster. | Folder |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_connection | La ruta del archivo de conexión de almacenamiento en la nube de salida. | Archivo |
Muestra de código
Ejemplo 1 de CreateCloudStorageConnectionFile (ventana de Python)
Esta es una muestra de Python para la herramienta 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")
Ejemplo 2 de CreateCloudStorageConnectionFile (script independiente)
Esta es una muestra de Python para la herramienta 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)
Esta es una muestra de Python para la herramienta CreateCloudStorageConnectionFile con muestras para diferentes casos de conexión.
#====================================
# 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)
Entornos
Esta herramienta no utiliza ningún entorno de geoprocesamiento.
Información sobre licencias
- Basic: Sí
- Standard: Sí
- Advanced: Sí