Créer un fichier de connexion au stockage Cloud (Gestion des données)

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ètreExplicationType 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.

  • AZUREMicrosoft Azure
  • AMAZONAmazon S3
  • GOOGLEStockage cloud Google
  • ALIBABAStockage cloud Alibaba
  • WEBHDFSWebHDFS
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

NomExplicationType 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_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, 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

Rubriques connexes