Résumé
Crée un fichier de connexion à un stockage cloud pris en charge par ArcGIS. Cet outil permet aux outils de géotraitement raster existants d’écrire des jeux de données au format CRF (Cloud Raster Format) dans le paquet du stockage cloud ou de lire des jeux de données raster (pas seulement au format CRF) stockés dans le stockage cloud en entrée.
Utilisation
Cet outil exige que vous indiquiez les informations nécessaires à l’établissement d’une connexion au stockage cloud, comme Access Key (Clé d’accès), Secret Access Key (Clé d’accès secrète) et Bucket Name (Nom du paquet).
L’outil génère en sortie un fichier de connexion binaire au stockage cloud au format ArcGIS Cloud Storage (.icsd).
Le jeu de données raster stocké dans le stockage cloud peut être référencé via un chemin d’accès au fichier, tel que c:/temp/amazons3.acs/someraster.
Les fournisseurs de stockage cloud pris en charge sont Amazon, Azure, Google, Aliyun et Huawei.
SI le jeu de données est stocké dans un dossier du paquet, le nom de dossier doit figurer dans le chemin, par exemple, c:/temp/amazons3.acs/foldername/someraster.
L’outil valide les identifiants de connexion fournis lors de l’exécution. Si la connexion ne peut pas être établie, l’exécution de l’outil échoue.
Syntaxe
CreateCloudStorageConnectionFile_management (out_folder_path, out_name, service_provider, bucket_name, {access_key_id}, {secret_access_key}, {region}, {end_point}, {config_options})| Paramètre | Explication | Type de données |
out_folder_path | Chemin d’accès au dossier dans lequel le fichier de connexion est créé. | Folder |
out_name | Nom du fichier de connexion au stockage cloud. | String |
service_provider | Indique le fournisseur de services du stockage cloud.
| String |
bucket_name | Nom du conteneur de stockage cloud dans lequel le jeu de données raster est stocké. Pour de nombreux fournisseurs cloud, ce conteneur est également appelé paquet. | String |
access_key_id (Facultatif) | ID de la clé d’accès du type de stockage cloud spécifique. Il peut également s’agir du nom du compte, comme c’est le cas avec Azure. | String |
secret_access_key (Facultatif) | Chaîne de la clé d’accès secrète permettant d’authentifier la connexion au stockage cloud. | Encrypted String |
region (Facultatif) | Chaîne de la région du stockage cloud. Si elle est indiquée, la valeur doit respecter le format défini par le choix du stockage cloud. La valeur par défaut est la valeur par défaut du compte du fournisseur cloud. | String |
end_point (Facultatif) | Extrémité du service (uris) du stockage cloud, comme oss-us-west-1.aliyuncs.com. Si ce paramètre n’est pas indiqué, l’extrémité du type de stockage cloud sélectionné est utilisé. L’extrémité redirigée CNAME peut être employée si nécessaire. | String |
config_options [config_options,...] (Facultatif) | Indique les options de configuration liées au type spécifique du service cloud. Certains services proposent des options et d’autres non. Définissez cette option uniquement si vous souhaitez les activer. | Value Table |
Sortie dérivée
| Nom | Explication | Type de données |
| out_connection | Chemin d’accès au fichier de connexion au stockage cloud. | Fichier |
Exemple de code
Exemple 1 d’utilisation de l’outil CreateCloudStorageConnectionFile (fenêtre Python)
Il s'agit d'un exemple Python d'utilisation de l'outil CreateCloudStorageConnectionFile.
#====================================
# CreateCloudStorageConnectionFile
# Usage:
# arcpy.management.CreateCloudStorageConnectionFile(
# out_folder_path, out_name, AZURE | AMAZON | GOOGLE | ALIBABA | HUAWEI, 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 | HUAWEI, 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")
Exemple 2 d’utilisation de l’outil CreateCloudStorageConnectionFile (script autonome)
Il s'agit d'un exemple Python d'utilisation de l'outil CreateCloudStorageConnectionFile.
#====================================
# CreateCloudStorageConnectionFile
# Usage:
# arcpy.management.CreateCloudStorageConnectionFile(
# out_folder_path, out_name, AZURE | AMAZON | GOOGLE | ALIBABA | HUAWEI, 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 | HUAWEI, 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)
Environnements
Cet outil n'utilise pas d'environnement de géotraitement.
Informations de licence
- ArcGIS Desktop Basic: Oui
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui