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 notamment Amazon, Azure, Google et Alibaba.
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.
Vous pouvez utiliser cet outil avec un rôle Amazon Web Services (AWS) Identity and Access Management (IAM). Pour ce faire, laissez les paramètres Access Key ID (ID de la clé d’accès) et Secret Access Key (Clé d’accès secrète) vides. Si le rôle IAM est correctement configuré lors de l’exécution de cet outil sur une machine EC2, une connexion s’établit avec succès. Le fichier de connexion créé peut alors être utilisé dans le même environnement/
Syntaxe
CreateCloudStorageConnectionFile(out_folder_path, out_name, service_provider, bucket_name, {access_key_id}, {secret_access_key}, {region}, {end_point}, {config_options}, {folder})
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 |
folder (Facultatif) | Dans Bucket (Container) Name (Nom du paquet (container)), indiquez un dossier du stockage cloud dans lequel le jeu de données raster sera stocké. | Folder |
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
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, 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")
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, 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)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?