Verbindungsdatei für Cloud-Speicher erstellen (Data Management)

Zusammenfassung

Erstellt eine Verbindungsdatei für von ArcGIS unterstützte Cloud-Speicher. Mit diesem Werkzeug können vorhandene Raster-Geoverarbeitungswerkzeuge CRF-Datasets (Cloud-Raster-Format) in den Cloud-Speicher-Bucket schreiben oder Raster-Datasets als Eingabe lesen (nicht nur CRF), die im Cloud-Speicher gespeichert sind. Das Werkzeug erstellt auch eine Cloud-Speicher-Verbindungsdatei, mit der Sie auf Apache Parquet-Dateien für die Zuordnung zugreifen können.

Verwendung

• Zum Ausführen dieses Werkzeugs müssen Sie die erforderlichen Informationen für eine Cloud-Speicherverbindung angeben, beispielsweise eine Zugriffsschlüssel-ID, eine Zeichenfolge des geheimen Zugriffsschlüssels und einen Bucket-Namen. Mit dem Parameter Provider-Optionen können Sie auch alternative Authentifizierungsmethoden verwenden.

  Weitere Informationen zum Herstellen einer Verbindung mit Cloud-Speichern

• Das Werkzeug gibt eine binäre Cloud-Speicherverbindungsdatei (.acs) im ArcGIS-Cloud-Speicherformat aus.

• Beim Zugriff auf das im Cloud-Speicher gespeicherte Raster-Dataset können Sie über einen Dateipfad wie c:/temp/amazons3.acs/someraster darauf verweisen. Wenn das Dataset in einem Ordner im Bucket gespeichert wird, muss der Ordnername im Pfad enthalten sein, z. B. c:/temp/amazons3.acs/foldername/someraster.

• Dieses Werkzeug unterstützt Verbindungen mit Amazon Simple Storage Service (S3)-Buckets, Microsoft Azure Blob Storage-Containern, Microsoft Azure Data Lake Storage Storage Gen2, Alibaba Cloud Object Storage Service (OSS)-Buckets, Google Cloud Storage Service-Buckets (GCS), WebHDFS, MinIO und Ozone Object Storage Service-Buckets. Beim Zugriff auf eine Parquet-Datei wird nur Amazon S3 unterstützt.

• Bei der Verwendung von Raster-Daten können über eine benutzerdefinierte Endpunkt-URL S3-konforme Objektspeicher oder CNAME-Datensätze unterstützt werden.

• Das Werkzeug überprüft die angegebenen Anmeldeinformationen zur Laufzeit. Wenn die Verbindung nicht hergestellt werden kann, wird eine Warnung zurückgegeben.

• OAuth 2.0-Authentifizierung mit Azure Active Directory wird mit interaktiver Anmeldung für Azure und Azure Data Lake Storage Gen2 unterstützt. Zudem wird die OAuth 2.0-Authentifizierung für Google Cloud Storage Service (GCS) unterstützt. Informationen zur Konfiguration finden Sie unter Verbinden mit Authentifizierungsanbietern über ArcGIS Pro. Wenn die Konfiguration vorgenommen wurde und der Benutzer angemeldet ist, wird der Authentifizierungsparameter für Google, Azure und Azure Data Lake Storage Gen2 aktiviert. Region und Endpunkt werden aus der Konfiguration abgerufen.

• Unterstützung für vom Benutzer zugewiesene verwaltete Identitäten mit Entra ID in einer Azure-VM (virtuelle Maschine) ist für Azure und Azure Data Lake Storage Gen2 verfügbar.

• Rollenbasierte Zugriffssteuerung (Role-Based Access Control, RBAC) ist für Amazon, Azure und Google-Cloud-Provider verfügbar. Wenn Sie alle Authentifizierungsparameter bei Verwendung einer Amazon Elastic Compute Cloud (EC2)- AzureAzure-VM oder einer Google Compute Engine leer lassen, kann ArcGIS Pro mit IAM-Rollen oder Azure RBAC auf BLOB-Speicher zugreifen. Bei Amazon werden IMDSv1 und IMDSv2 unterstützt.

  Microsoft Azure Data Lake Storage Gen2 bietet dieselben Optionen wie Azure, stellt jedoch mithilfe eines DFS-Endpunktes tatsächliche Verzeichnisunterstützung und atomische Vorgänge bereit. Bei einigen Netzwerkfehlern in Cloud-Vorgängen werden gemäß dem exponentiellen Backoff Wiederholungsversuche durchgeführt.

  Überlegungen zur Performance sowie zusätzliche Informationen finden Sie in der Dokumentation zu virtuellen GDAL-Dateisystemen.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Speicherort der Verbindungsdatei	Der Ordnerpfad, in dem die Verbindungsdatei (.acs) erstellt wird.	Folder
Name der Verbindungsdatei	Der Name der Cloud-Speicherverbindungsdatei.	String
Service-Provider	Gibt den Cloud-Speicher-Service-Provider an, der verwendet werden soll. Azure—Der Service-Provider ist Microsoft Azure. Amazon—Der Service-Provider ist Amazon S3. Für den Zugriff auf eine Parquet-Datei wird derzeit nur dieser Anbieter unterstützt. Google—Der Service-Provider ist Google Cloud Storage. Alibaba—Der Service-Provider ist Alibaba Cloud Storage. WebHDFS—Der Service-Provider ist WebHDFS. MinIO—Der Service-Provider ist MinIO. Azure Data Lake—Der Service-Provider ist Microsoft Azure Data Lake Storage. Ozone—Der Service-Provider ist Ozone. Web—Der Service-Provider für den Zugriff auf generische HTTP-URLs.	String
Name des Bucket (Containers)	Der Name des Cloud-Speichercontainers, in dem das Raster-Dataset oder die Parquet-Datei gespeichert ist. Wird dieser Speicherort für die Ausgabe für Raster-Geoverarbeitungswerkzeuge verwendet, ist dies der Container, in dem das Raster-Ausgabe-Dataset gespeichert wird. Dieser Container wird von vielen Cloud-Anbietern auch als Bucket bezeichnet.	String
Zugriffsschlüssel-ID (Kontoname) (optional)	Die Zeichenfolge der Zugriffsschlüssel-ID für den speziellen Cloud-Speichertyp. Dies kann auch der Kontoname sein, beispielsweise bei Azure.	String
Geheimer Zugriffsschlüssel (Kontoschlüssel) (optional)	Die Zeichenfolge des geheimen Zugriffsschlüssels zur Authentifizierung der Verbindung mit dem Cloud-Speicher.	Encrypted String
Region (Umgebung) (optional)	Die Regionszeichenfolge für den Cloud-Speicher. Wird sie angegeben, muss der Wert das Format aufweisen, das vom ausgewählten Cloud-Speicher definiert wird. Der Standard ist das Standardkonto des ausgewählten Cloud-Providers.	String
Service-Endpunkt (optional)	Der Service-Endpunkt (URI) des Cloud-Speichers, z. B. oss-us-west-1.aliyuncs.com. Wenn kein Wert angegeben wird, wird der Standardendpunkt des ausgewählten Cloud-Speichertyps verwendet. Bei Bedarf kann auch der umgeleitete CNAME-Endpunkt verwendet werden.	String
Provider-Optionen (optional)	Die Konfigurationsoptionen, die zum jeweiligen Typ von Cloud-Service gehören. Nicht alle Services bieten Optionen an. Diesen Parameter müssen Sie nur dann festlegen, wenn Sie die Optionen aktivieren möchten. Beim Erstellen einer Verbindungsdatei für den Cloud-Speicher, um auf eine Parquet-Datei zuzugreifen, wird, wie in den folgenden Beschreibungen erwähnt, nur eine Teilmenge der Optionen unterstützt. Azure und Microsoft Azure Data Lake Storage AZURE_STORAGE_SAS_TOKEN: Geben Sie eine Shared Access Signature an. Stellen Sie sicher, dass der Wert URL-codiert ist und keine führenden ?- oder &-Zeichen enthält. Wenn Sie diese Option verwenden, muss der Parameter Geheimer Zugriffsschlüssel (Kontoschlüssel) leer sein. AZURE_NO_SIGN_REQUEST: Stellen Sie eine anonyme Verbindung zu Buckets (Containern) her, die keinen authentifizierten Zugriff erfordern. Wenn Sie diese Option verwenden, muss der Parameter Geheimer Zugriffsschlüssel (Kontoschlüssel) leer sein. Der Standardwert ist False. AZURE_STORAGE_CONNECTION_STRING: Geben Sie eine Azure-Speicher-Verbindungszeichenfolge an. Diese Verbindungszeichenfolge bettet den Kontonamen, den Schlüssel sowie den Endpunkt ein. Wenn Sie diese Option verwenden, müssen die Parameter Zugriffsschlüssel-ID (Kontoname) und Geheimer Zugriffsschlüssel (Kontoschlüssel) leer sein. CPL_AZURE_USE_HTTPS: Legen Sie diese Option auf False fest, um HTTP-Anforderungen zu verwenden. Einige Server sind möglicherweise so konfiguriert, dass sie ausschließlich HTTPS-Anforderungen unterstützen. Der Standardwert ist True. AZURE_IMDS_OBJECT_ID: Geben Sie die Objekt-ID der mit dem Azure Instance Metadata Service (IMDS) verwalteten Identität an, wenn für die Azure-VM mehrere vom Benutzer zugewiesene verwaltete Identitäten festgelegt sind. AZURE_IMDS_CLIENT_ID: Geben Sie die Client-ID der mit dem Azure Instance Metadata Service (IMDS) verwalteten Identität an, wenn für die Azure-VM mehrere vom Benutzer zugewiesene verwaltete Identitäten festgelegt sind. AZURE_IMDS_MSI_RES_ID: Geben Sie die Ressourcen-ID der mit dem Azure Instance Metadata Service (IMDS) verwalteten Identität an, wenn für die Azure-VM mehrere vom Benutzer zugewiesene verwaltete Identitäten festgelegt sind. Amazon und MinIO AWS_NO_SIGN_REQUEST: Stellen Sie eine anonyme Verbindung zu Buckets (Containern) her, die keinen authentifizierten Zugriff erfordern. Der Standardwert ist False. Diese Option wird für den Zugriff auf eine Parquet-Datei unterstützt. AWS_SESSION_TOKEN: Geben Sie temporäre Anmeldeinformationen an. Diese Option wird für den Zugriff auf eine Parquet-Datei unterstützt. AWS_DEFAULT_PROFILE: AWS-Anmeldeprofile werden automatisch verwendet, wenn der Zugriffsschlüssel oder die ID fehlt. Diese Option kann verwendet werden, um das zu verwendende Profil anzugeben. Diese Option wird für den Zugriff auf eine Parquet-Datei unterstützt. AWS_REQUEST_PAYER: Auf Buckets mit Zahlung durch den Anforderer kann zugegriffen werden, indem diese Option auf den Anforderer gesetzt wird. AWS_Virtual_Hosting: Wenn Sie Amazon S3 oder mit S3 kompatible Cloud-Provider verwenden, die nur pfadabhängige Anforderungen unterstützen, müssen Sie diese Option auf True setzen. Die Verwendung von virtuellem Hosting wird empfohlen, sofern es unterstützt wird. Der Standardwert ist True. CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE: Einige ältere S3-kompatible Implementierungen unterstützen Bulk-Löschvorgänge nicht. Setzen Sie diese Option bei diesen Providern auf False. Der Standardwert ist True. AWS_HTTPS: Legen Sie diese Option auf False fest, um HTTP-Anforderungen zu verwenden. Einige Server sind möglicherweise so konfiguriert, dass sie ausschließlich HTTPS-Anforderungen unterstützen. Der Standardwert ist True. Google GS_NO_SIGN_REQUEST: Stellen Sie eine anonyme Verbindung zu Buckets (Containern) her, die keinen authentifizierten Zugriff erfordern. Der Standardwert ist True. GS_USER_PROJECT: Auf Buckets mit Zahlung durch den Anforderer kann zugegriffen werden, indem OAuth2-Schlüssel und ein Projekt für die Rechnungsstellung festgelegt werden. Geben Sie das Projekt über diese Option an. Legen Sie OAuth2-Schlüssel unter Verwendung weiterer Optionen und nicht mit HMAC-Schlüsseln als geheimem Zugriffsschlüssel oder ID fest. GS_OAUTH2_REFRESH_TOKEN: Geben Sie ein OAuth2-Aktualisierungszugriffstoken an. Legen Sie OAuth2-Clientanmeldeinformationen mit GS_OAUTH2_CLIENT_ID und GS_OAUTH2_CLIENT_SECRET fest. GOOGLE_APPLICATION_CREDENTIALS: Geben Sie die Anmeldeinformationen für das Service-Konto OAuth2 in Form einer .json-Datei an, die einen privaten Schlüssel und eine Client-E-Mail-Adresse enthält. GS_OAUTH2_ PRIVATE_KEY: Geben Sie die Anmeldeinformationen für das Service-Konto OAuth2 in Form eines privaten Schlüssels in einer Zeichenfolge an. GS_AUTH2_CLIENT_EMAIL muss festgelegt sein. GS_OAUTH2_ PRIVATE_KEY_FILE: Geben Sie die Anmeldeinformationen für das Service-Konto OAuth2 in Form eines privaten Schlüssels in einer Datei an. GS_AUTH2_CLIENT_EMAIL muss festgelegt sein. GS_AUTH2_CLIENT_EMAIL: Geben Sie die Anmeldeinformationen für das Service-Konto OAuth2 in Form einer Client-E-Mail-Adresse an. GS_AUTH2_SCOPE: Geben Sie den Umfang für das Service-Konto OAuth2 an. Gültige Werte sind https://www.googleapis.com/auth/devstorage.read_write (Standardeinstellung) und https://www.googleapis.com/auth/devstorage.read_only. GDAL_HTTP_HEADER_FILE: Geben Sie die in einer externen Datei gespeicherten Anmeldeinformationen für die Bearerauthentifizierung an. Alibaba OSS_Virtual_Hosting: Wenn Sie Alibaba oder mit S3 kompatible Cloud-Provider verwenden, die nur pfadabhängige Anforderungen unterstützen, müssen Sie diese Option auf True setzen. Die Verwendung von virtuellem Hosting wird empfohlen, sofern es unterstützt wird. Der Standardwert ist True. OSS_HTTPS: Legen Sie diese Option auf False fest, um HTTP-Anforderungen zu verwenden. Einige Server sind möglicherweise so konfiguriert, dass sie ausschließlich HTTPS-Anforderungen unterstützen. Der Standardwert ist True. WebHDFS WEBHDFS_REPLICATION (ganze Zahl): Dieser Replikationswert wird beim Erstellen einer Datei verwendet. WEBHDFS_PERMISSION (Dezimalzahl): Beim Erstellen einer Datei wird eine Berechtigungsmaske verwendet. Wenn mehrere Authentifizierungsparameter bereitgestellt werden, gilt diese Rangfolge: Azure: AZURE_STORAGE_CONNECTION_STRING, Kontoname oder -schlüssel, AZURE_STORAGE_SAS_TOKEN, AZURE_NO_SIGN_REQUEST oder RBAC. Amazon: AWS_NO_SIGN_REQUEST, Zugriffs-ID oder Zugriffsschlüssel oder AWS_SESSION_TOKEN, AWS Credential Profile oder IAM Role. Google: GS_NO_SIGN_REQUEST, Zugriffs-ID oder Zugriffsschlüssel, GDAL_HTTP_HEADER_FILE, (GS_OAUTH2_REFRESH_TOKEN or GS_OAUTH2_CLIENT_ID and GS_OAUTH2_CLIENT_SECRET), GOOGLE_APPLICATION_CREDENTIALS, (GS_OAUTH2_PRIVATE_KEY or GS_OAUTH2_CLIENT_EMAIL), (GS_OAUTH2_PRIVATE_KEY_FILE or GS_OAUTH2_CLIENT_EMAIL) oder IAM Role. Ozone AWS_DEFAULT_PROFILE: AWS-Anmeldeprofile werden automatisch verwendet, wenn der Zugriffsschlüssel oder die ID fehlt. Diese Option kann verwendet werden, um das zu verwendende Profil anzugeben. AWS_Virtual_Hosting: Wenn Sie Amazon S3 oder mit S3 kompatible Cloud-Provider verwenden, die nur pfadabhängige Anforderungen unterstützen, müssen Sie diese Option auf True setzen. Die Verwendung von virtuellem Hosting wird empfohlen, sofern es unterstützt wird. Der Standardwert ist True. AWS_HTTPS: Legen Sie diese Option auf False fest, um HTTP-Anforderungen zu verwenden. Einige Server sind möglicherweise so konfiguriert, dass sie ausschließlich HTTPS-Anforderungen unterstützen. Der Standardwert ist True. CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE: Einige ältere S3-kompatible Implementierungen unterstützen Bulk-Löschvorgänge nicht. Setzen Sie diese Option bei diesen Providern auf False. Der Standardwert ist True. x-amz-storage-class: Geben Sie REDUCED_REDUNDANCY an, damit in einen einzelnen Ozone-Container geschrieben wird, da der Container über nur einen Datenknoten verfügt. Web Bei Verwendung der Option Web kann über ein ACS auf einen authentifizierten HTTP/HTTPS-Endpunkt zugegriffen werden. Für den Zugriff auf den Endpunkt werden Authentifizierungsparameter als Optionen des Providers übergeben. GDAL_HTTP_USERPWD: Der HTTP-Benutzer und das Kennwort für die Verbindung. Muss in folgendem Format vorliegen: [user name]:[password]. Verwenden Sie GDAL_HTTP_AUTH, um die Authentifizierungsmethode festzulegen. GDAL_HTTP_NETRC_FILE: Legt den Speicherort einer NETRC-Datei fest. GDAL_HTTP_HEADERS: Gibt Header als durch Kommata getrennte Liste von key:value pairs an. GDAL_HTTP_BEARER: Legt fest, dass für die Verbindung das HTTP OAuth 2.0 Bearer-Zugriffstoken verwendet werden soll. Muss zusammen mit GDAL_HTTP_AUTH=BEARER verwendet werden. GDAL_HTTP_AUTH: Wählt den Typ der zu verwendenden Authentifizierungsmethode aus: [BASIC/NTLM/NEGOTIATE/ANY/ANYSAFE/BEARER]. GDAL_HTTP_SSLCERT: Der Dateiname des SSL-Client-Zertifikats für die PKI-Authentifizierung. GDAL_HTTP_SSLKEY: Der Pfad der privaten Schlüsseldatei für TLS- und SSL-Client-Zertifikate für die PKI-Authentifizierung. GDAL_HTTP_KEYPASSWD: Passphrase für den privaten Schlüssel von GDAL_HTTP_SSLKEY. Zusätzlich zu den oben aufgeführten Provider-Optionen kann die Option ARC_DEEP_CRAWL mit allen Service-Providern verwendet werden. Wenn diese auf True festgelegt ist, werden mit dieser Option CRF-Dateien ohne Erweiterung und cloudfähige Raster-Produkte in der Cloud identifiziert. Da dies ein aufwendiger Vorgang ist, sollten Sie diese Option auf False setzen, um das Durchsuchen des Katalogs und das Durchforsten zu beschleunigen. Der Standardwert ist False. Benutzerdefinierte Token-Anbieterservices, wie z. B. die Datensammlung von Planetary Computer, können mit den Provider-Optionen ARC_TOKEN_SERVICE_API (URL des Token-Anbieters) und ARC_TOKEN_OPTION_NAME (Typ des Service-Provider-Token) authentifiziert werden. Hinweis: Die Option GDAL_DISABLE_READDIR_ON_OPEN ist bei allen Service-Providern verfügbar. Um die Leistung beim Laden von Cloud-basierten Rastern zu verbessern, ist diese Option standardmäßig auf NO gesetzt. Wenn sich das Raster in einem Ordner befindet, der mehr als 30.000 Elemente enthält, setzen Sie diese Option auf YES.	Value Table
Ordner (optional)	Der im Parameterwert Name des Bucket (Container) angegebene Ordner, in dem das Raster-Dataset oder die Parquet-Datei gespeichert ist. Wird dieser Speicherort für die Ausgabe für Raster-Geoverarbeitungswerkzeuge verwendet, ist dies der Ordner, in dem das Raster-Ausgabe-Dataset gespeichert wird.	String
Authentifizierung (optional)	Der Verbindungsname für OAuth 2.0-Authentifizierung. Im Dialogfeld Optionen auf der Registerkarte Authentifizierung muss eine gültige Verbindung konfiguriert sein.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabeverbindungsdatei	Der Ausgabepfad der Cloud-Speicherverbindungsdatei.	File

Python

arcpy.management.CreateCloudStorageConnectionFile(out_folder_path, out_name, service_provider, bucket_name, {access_key_id}, {secret_access_key}, {region}, {end_point}, {config_options}, {folder}, {authentication})

Name	Erläuterung	Datentyp
out_folder_path	Der Ordnerpfad, in dem die Verbindungsdatei (.acs) erstellt wird.	Folder
out_name	Der Name der Cloud-Speicherverbindungsdatei.	String
service_provider	Gibt den Cloud-Speicher-Service-Provider an, der verwendet werden soll. AZURE—Der Service-Provider ist Microsoft Azure. AMAZON—Der Service-Provider ist Amazon S3. Für den Zugriff auf eine Parquet-Datei wird derzeit nur dieser Anbieter unterstützt. GOOGLE—Der Service-Provider ist Google Cloud Storage. ALIBABA—Der Service-Provider ist Alibaba Cloud Storage. WEBHDFS—Der Service-Provider ist WebHDFS. MINIO—Der Service-Provider ist MinIO. AZUREDATALAKE—Der Service-Provider ist Microsoft Azure Data Lake Storage. OZONE—Der Service-Provider ist Ozone. WEB—Der Service-Provider für den Zugriff auf generische HTTP-URLs.	String
bucket_name	Der Name des Cloud-Speichercontainers, in dem das Raster-Dataset oder die Parquet-Datei gespeichert ist. Wird dieser Speicherort für die Ausgabe für Raster-Geoverarbeitungswerkzeuge verwendet, ist dies der Container, in dem das Raster-Ausgabe-Dataset gespeichert wird. Dieser Container wird von vielen Cloud-Anbietern auch als Bucket bezeichnet.	String
access_key_id (optional)	Die Zeichenfolge der Zugriffsschlüssel-ID für den speziellen Cloud-Speichertyp. Dies kann auch der Kontoname sein, beispielsweise bei Azure.	String
secret_access_key (optional)	Die Zeichenfolge des geheimen Zugriffsschlüssels zur Authentifizierung der Verbindung mit dem Cloud-Speicher.	Encrypted String
region (optional)	Die Regionszeichenfolge für den Cloud-Speicher. Wird sie angegeben, muss der Wert das Format aufweisen, das vom ausgewählten Cloud-Speicher definiert wird. Der Standard ist das Standardkonto des ausgewählten Cloud-Providers.	String
end_point (optional)	Der Service-Endpunkt (URI) des Cloud-Speichers, z. B. oss-us-west-1.aliyuncs.com. Wenn kein Wert angegeben wird, wird der Standardendpunkt des ausgewählten Cloud-Speichertyps verwendet. Bei Bedarf kann auch der umgeleitete CNAME-Endpunkt verwendet werden.	String
config_options [config_options,...] (optional)	Die Konfigurationsoptionen, die zum jeweiligen Typ von Cloud-Service gehören. Nicht alle Services bieten Optionen an. Diesen Parameter müssen Sie nur dann festlegen, wenn Sie die Optionen aktivieren möchten. Beim Erstellen einer Verbindungsdatei für den Cloud-Speicher, um auf eine Parquet-Datei zuzugreifen, wird, wie in den folgenden Beschreibungen erwähnt, nur eine Teilmenge der Optionen unterstützt. Azure und Microsoft Azure Data Lake Storage AZURE_STORAGE_SAS_TOKEN: Geben Sie eine Shared Access Signature an. Stellen Sie sicher, dass der Wert URL-codiert ist und keine führenden ?- oder &-Zeichen enthält. Wenn Sie diese Option verwenden, muss der Parameter Geheimer Zugriffsschlüssel (Kontoschlüssel) leer sein. AZURE_NO_SIGN_REQUEST: Stellen Sie eine anonyme Verbindung zu Buckets (Containern) her, die keinen authentifizierten Zugriff erfordern. Wenn Sie diese Option verwenden, muss der Parameter Geheimer Zugriffsschlüssel (Kontoschlüssel) leer sein. Der Standardwert ist False. AZURE_STORAGE_CONNECTION_STRING: Geben Sie eine Azure-Speicher-Verbindungszeichenfolge an. Diese Verbindungszeichenfolge bettet den Kontonamen, den Schlüssel sowie den Endpunkt ein. Wenn Sie diese Option verwenden, müssen die Parameter Zugriffsschlüssel-ID (Kontoname) und Geheimer Zugriffsschlüssel (Kontoschlüssel) leer sein. CPL_AZURE_USE_HTTPS: Legen Sie diese Option auf False fest, um HTTP-Anforderungen zu verwenden. Einige Server sind möglicherweise so konfiguriert, dass sie ausschließlich HTTPS-Anforderungen unterstützen. Der Standardwert ist True. AZURE_IMDS_OBJECT_ID: Geben Sie die Objekt-ID der mit dem Azure Instance Metadata Service (IMDS) verwalteten Identität an, wenn für die Azure-VM mehrere vom Benutzer zugewiesene verwaltete Identitäten festgelegt sind. AZURE_IMDS_CLIENT_ID: Geben Sie die Client-ID der mit dem Azure Instance Metadata Service (IMDS) verwalteten Identität an, wenn für die Azure-VM mehrere vom Benutzer zugewiesene verwaltete Identitäten festgelegt sind. AZURE_IMDS_MSI_RES_ID: Geben Sie die Ressourcen-ID der mit dem Azure Instance Metadata Service (IMDS) verwalteten Identität an, wenn für die Azure-VM mehrere vom Benutzer zugewiesene verwaltete Identitäten festgelegt sind. Amazon und MinIO AWS_NO_SIGN_REQUEST: Stellen Sie eine anonyme Verbindung zu Buckets (Containern) her, die keinen authentifizierten Zugriff erfordern. Der Standardwert ist False. Diese Option wird für den Zugriff auf eine Parquet-Datei unterstützt. AWS_SESSION_TOKEN: Geben Sie temporäre Anmeldeinformationen an. Diese Option wird für den Zugriff auf eine Parquet-Datei unterstützt. AWS_DEFAULT_PROFILE: AWS-Anmeldeprofile werden automatisch verwendet, wenn der Zugriffsschlüssel oder die ID fehlt. Diese Option kann verwendet werden, um das zu verwendende Profil anzugeben. Diese Option wird für den Zugriff auf eine Parquet-Datei unterstützt. AWS_REQUEST_PAYER: Auf Buckets mit Zahlung durch den Anforderer kann zugegriffen werden, indem diese Option auf den Anforderer gesetzt wird. AWS_Virtual_Hosting: Wenn Sie Amazon S3 oder mit S3 kompatible Cloud-Provider verwenden, die nur pfadabhängige Anforderungen unterstützen, müssen Sie diese Option auf True setzen. Die Verwendung von virtuellem Hosting wird empfohlen, sofern es unterstützt wird. Der Standardwert ist True. CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE: Einige ältere S3-kompatible Implementierungen unterstützen Bulk-Löschvorgänge nicht. Setzen Sie diese Option bei diesen Providern auf False. Der Standardwert ist True. AWS_HTTPS: Legen Sie diese Option auf False fest, um HTTP-Anforderungen zu verwenden. Einige Server sind möglicherweise so konfiguriert, dass sie ausschließlich HTTPS-Anforderungen unterstützen. Der Standardwert ist True. Google GS_NO_SIGN_REQUEST: Stellen Sie eine anonyme Verbindung zu Buckets (Containern) her, die keinen authentifizierten Zugriff erfordern. Der Standardwert ist True. GS_USER_PROJECT: Auf Buckets mit Zahlung durch den Anforderer kann zugegriffen werden, indem OAuth2-Schlüssel und ein Projekt für die Rechnungsstellung festgelegt werden. Geben Sie das Projekt über diese Option an. Legen Sie OAuth2-Schlüssel unter Verwendung weiterer Optionen und nicht mit HMAC-Schlüsseln als geheimem Zugriffsschlüssel oder ID fest. GS_OAUTH2_REFRESH_TOKEN: Geben Sie ein OAuth2-Aktualisierungszugriffstoken an. Legen Sie OAuth2-Clientanmeldeinformationen mit GS_OAUTH2_CLIENT_ID und GS_OAUTH2_CLIENT_SECRET fest. GOOGLE_APPLICATION_CREDENTIALS: Geben Sie die Anmeldeinformationen für das Service-Konto OAuth2 in Form einer .json-Datei an, die einen privaten Schlüssel und eine Client-E-Mail-Adresse enthält. GS_OAUTH2_ PRIVATE_KEY: Geben Sie die Anmeldeinformationen für das Service-Konto OAuth2 in Form eines privaten Schlüssels in einer Zeichenfolge an. GS_AUTH2_CLIENT_EMAIL muss festgelegt sein. GS_OAUTH2_ PRIVATE_KEY_FILE: Geben Sie die Anmeldeinformationen für das Service-Konto OAuth2 in Form eines privaten Schlüssels in einer Datei an. GS_AUTH2_CLIENT_EMAIL muss festgelegt sein. GS_AUTH2_CLIENT_EMAIL: Geben Sie die Anmeldeinformationen für das Service-Konto OAuth2 in Form einer Client-E-Mail-Adresse an. GS_AUTH2_SCOPE: Geben Sie den Umfang für das Service-Konto OAuth2 an. Gültige Werte sind https://www.googleapis.com/auth/devstorage.read_write (Standardeinstellung) und https://www.googleapis.com/auth/devstorage.read_only. GDAL_HTTP_HEADER_FILE: Geben Sie die in einer externen Datei gespeicherten Anmeldeinformationen für die Bearerauthentifizierung an. Alibaba OSS_Virtual_Hosting: Wenn Sie Alibaba oder mit S3 kompatible Cloud-Provider verwenden, die nur pfadabhängige Anforderungen unterstützen, müssen Sie diese Option auf True setzen. Die Verwendung von virtuellem Hosting wird empfohlen, sofern es unterstützt wird. Der Standardwert ist True. OSS_HTTPS: Legen Sie diese Option auf False fest, um HTTP-Anforderungen zu verwenden. Einige Server sind möglicherweise so konfiguriert, dass sie ausschließlich HTTPS-Anforderungen unterstützen. Der Standardwert ist True. WebHDFS WEBHDFS_REPLICATION (ganze Zahl): Dieser Replikationswert wird beim Erstellen einer Datei verwendet. WEBHDFS_PERMISSION (Dezimalzahl): Beim Erstellen einer Datei wird eine Berechtigungsmaske verwendet. Wenn mehrere Authentifizierungsparameter bereitgestellt werden, gilt diese Rangfolge: Azure: AZURE_STORAGE_CONNECTION_STRING, Kontoname oder -schlüssel, AZURE_STORAGE_SAS_TOKEN, AZURE_NO_SIGN_REQUEST oder RBAC. Amazon: AWS_NO_SIGN_REQUEST, Zugriffs-ID oder Zugriffsschlüssel oder AWS_SESSION_TOKEN, AWS Credential Profile oder IAM Role. Google: GS_NO_SIGN_REQUEST, Zugriffs-ID oder Zugriffsschlüssel, GDAL_HTTP_HEADER_FILE, (GS_OAUTH2_REFRESH_TOKEN or GS_OAUTH2_CLIENT_ID and GS_OAUTH2_CLIENT_SECRET), GOOGLE_APPLICATION_CREDENTIALS, (GS_OAUTH2_PRIVATE_KEY or GS_OAUTH2_CLIENT_EMAIL), (GS_OAUTH2_PRIVATE_KEY_FILE or GS_OAUTH2_CLIENT_EMAIL) oder IAM Role. Ozone AWS_DEFAULT_PROFILE: AWS-Anmeldeprofile werden automatisch verwendet, wenn der Zugriffsschlüssel oder die ID fehlt. Diese Option kann verwendet werden, um das zu verwendende Profil anzugeben. AWS_Virtual_Hosting: Wenn Sie Amazon S3 oder mit S3 kompatible Cloud-Provider verwenden, die nur pfadabhängige Anforderungen unterstützen, müssen Sie diese Option auf True setzen. Die Verwendung von virtuellem Hosting wird empfohlen, sofern es unterstützt wird. Der Standardwert ist True. AWS_HTTPS: Legen Sie diese Option auf False fest, um HTTP-Anforderungen zu verwenden. Einige Server sind möglicherweise so konfiguriert, dass sie ausschließlich HTTPS-Anforderungen unterstützen. Der Standardwert ist True. CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE: Einige ältere S3-kompatible Implementierungen unterstützen Bulk-Löschvorgänge nicht. Setzen Sie diese Option bei diesen Providern auf False. Der Standardwert ist True. x-amz-storage-class: Geben Sie REDUCED_REDUNDANCY an, damit in einen einzelnen Ozone-Container geschrieben wird, da der Container über nur einen Datenknoten verfügt. Web Bei Verwendung der Option Web kann über ein ACS auf einen authentifizierten HTTP/HTTPS-Endpunkt zugegriffen werden. Für den Zugriff auf den Endpunkt werden Authentifizierungsparameter als Optionen des Providers übergeben. GDAL_HTTP_USERPWD: Der HTTP-Benutzer und das Kennwort für die Verbindung. Muss in folgendem Format vorliegen: [user name]:[password]. Verwenden Sie GDAL_HTTP_AUTH, um die Authentifizierungsmethode festzulegen. GDAL_HTTP_NETRC_FILE: Legt den Speicherort einer NETRC-Datei fest. GDAL_HTTP_HEADERS: Gibt Header als durch Kommata getrennte Liste von key:value pairs an. GDAL_HTTP_BEARER: Legt fest, dass für die Verbindung das HTTP OAuth 2.0 Bearer-Zugriffstoken verwendet werden soll. Muss zusammen mit GDAL_HTTP_AUTH=BEARER verwendet werden. GDAL_HTTP_AUTH: Wählt den Typ der zu verwendenden Authentifizierungsmethode aus: [BASIC/NTLM/NEGOTIATE/ANY/ANYSAFE/BEARER]. GDAL_HTTP_SSLCERT: Der Dateiname des SSL-Client-Zertifikats für die PKI-Authentifizierung. GDAL_HTTP_SSLKEY: Der Pfad der privaten Schlüsseldatei für TLS- und SSL-Client-Zertifikate für die PKI-Authentifizierung. GDAL_HTTP_KEYPASSWD: Passphrase für den privaten Schlüssel von GDAL_HTTP_SSLKEY. Zusätzlich zu den oben aufgeführten Provider-Optionen kann die Option ARC_DEEP_CRAWL mit allen Service-Providern verwendet werden. Wenn diese auf True festgelegt ist, werden mit dieser Option CRF-Dateien ohne Erweiterung und cloudfähige Raster-Produkte in der Cloud identifiziert. Da dies ein aufwendiger Vorgang ist, sollten Sie diese Option auf False setzen, um das Durchsuchen des Katalogs und das Durchforsten zu beschleunigen. Der Standardwert ist False. Benutzerdefinierte Token-Anbieterservices, wie z. B. die Datensammlung von Planetary Computer, können mit den Provider-Optionen ARC_TOKEN_SERVICE_API (URL des Token-Anbieters) und ARC_TOKEN_OPTION_NAME (Typ des Service-Provider-Token) authentifiziert werden. Hinweis: Die Option GDAL_DISABLE_READDIR_ON_OPEN ist bei allen Service-Providern verfügbar. Um die Leistung beim Laden von Cloud-basierten Rastern zu verbessern, ist diese Option standardmäßig auf NO gesetzt. Wenn sich das Raster in einem Ordner befindet, der mehr als 30.000 Elemente enthält, setzen Sie diese Option auf YES.	Value Table
folder (optional)	Der im Parameterwert bucket_name angegebene Ordner, in dem das Raster-Dataset oder die Parquet-Datei gespeichert ist. Wird dieser Speicherort für die Ausgabe für Raster-Geoverarbeitungswerkzeuge verwendet, ist dies der Ordner, in dem das Raster-Ausgabe-Dataset gespeichert wird.	String
authentication (optional)	Der Verbindungsname für OAuth 2.0-Authentifizierung.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_connection	Der Ausgabepfad der Cloud-Speicherverbindungsdatei.	File

Codebeispiel

CreateCloudStorageConnectionFile: Beispiel 1 (Python-Fenster)

Dies ist ein Python-Beispiel für die Funktion 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")

CreateCloudStorageConnectionFile: Beispiel 2 (eigenständiges Skript)

Dies ist ein Python-Beispiel für die Funktion 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)

CreateCloudStorageConnectionFile: Beispiel 3 (Python-Fenster)

Dies ist ein Python-Beispiel für die Funktion CreateCloudStorageConnectionFile, in dem eine Verbindung mit Token-Anbieterservices hergestellt wird.

#====================================
# CreateCloudStorageConnectionFile

import arcpy

outfolder = "C:/Workspace/connections"
connectname = "planetary_landsat.acs"
provider = "Azure"
accesskey = "landsateuwest"
secretkey = ""
bucketname = "landsat-c2"
folder = ""
region = ""
endpoint = ""
config_options= "ARC_TOKEN_OPTION_NAME AZURE_STORAGE_SAS_TOKEN; ARC_TOKEN_SERVICE_API https://planetarycomputer.microsoft.com/api/sas/v1/token/landsateuwest/landsat-c2"

# Create connection to planetary computer landsat data collection

print(arcpy.management.CreateCloudStorageConnectionFile(outfolder, connectname, provider, bucketname, accesskey, secretkey, region, endpoint, config_options, folder))
print(arcpy.GetMessages())

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

• Basic: Ja
• Standard: Ja
• Advanced: Ja