Créer un fichier de connexion au stockage Cloud

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

• Pour exécuter cet outil, vous devez fournir les informations nécessaires à l’établissement d’une connexion au stockage cloud, telles que la clé d’accès, la clé d’accès secrète et le 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.

• Cet outil prend en charge les connexions aux paquets Amazon Simple Storage Solution (S3), aux conteneurs de stockage Microsoft Azure Blob, aux paquets Alibaba Cloud Object Cloud Storage Service et Google Cloud Storage.

• 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.

• Pour utiliser cet outil avec un rôle Amazon Web Services (AWS) Identity and Access Management (IAM), 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

arcpy.management.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. AZURE —Le fournisseur de services sera Microsoft Azure. AMAZON —Le fournisseur de services sera Amazon S3. GOOGLE —Le fournisseur de services sera Google Cloud Storage. ALIBABA —Le fournisseur de services sera Alibaba Cloud Storage. WEBHDFS —Le fournisseur de services sera WebHDFS.	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 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 aucune valeur n’est fournie, l’extrémité par défaut du type de stockage cloud sélectionné est utilisée. L’extrémité redirigée CNAME peut également être utilisée, le cas échéant.	String
config_options [config_options,...] (Facultatif)	Options de configuration inhérentes au type spécifique de 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)	Dossier indiqué par le paramètre Bucket (Container) Name (Nom du paquet (container)) dans lequel le jeu de données raster sera stocké.	String

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, 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")

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, 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)

Exemple 3 d’utilisation de l’outil CreateCloudStorageConnectionFile (fenêtre Python)

Il s’agit d’un exemple Python d’utilisation de l’outil CreateCloudStorageConnectionFile avec des exemples pour différents scénarios de connexion.

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

Cet outil n'utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui