Freigeben über


StorageCredentials Klasse

  • java.lang.Object
    • com.microsoft.azure.storage.StorageCredentials

public class StorageCredentials

Stellt eine Gruppe von Anmeldeinformationen dar, die zum Authentifizieren des Zugriffs auf ein Microsoft Azure-Speicherkonto verwendet werden. Dies ist die Basisklasse für die StorageCredentialsAccountAndKeyKlassen , StorageCredentialsTokenund StorageCredentialsSharedAccessSignature .

Methodenzusammenfassung

Modifizierer und Typ Methode und Beschreibung
String getAccountName()

Gibt den zugeordneten Kontonamen für die Anmeldeinformationen zurück. Dies ist NULL für anmeldeinformationen für anonyme und freigegebene Zugriffssignaturen.

boolean isHttpsOnly()

Ruft ab, ob dieses Objekt nur den Zugriff über HTTPS zulässt.

void setHttpsOnly(boolean httpsOnly)

Legt fest, ob dieses Objekt den Zugriff nur über HTTPS zulässt.

abstract String toString(boolean exportSecrets)

Gibt eine zurück, die diesen instance darstellt.

URI transformUri(final URI resourceUri)

Transformiert einen Ressourcen-URI in einen SAS (Shared Access Signature)-URI, indem ein Token für den freigegebenen Zugriff angefügt wird.

StorageUri transformUri(StorageUri resourceUri)

Transformiert einen Ressourcen-URI in einen SAS (Shared Access Signature)-URI, indem ein Token für den freigegebenen Zugriff angefügt wird.

abstract StorageUri transformUri(StorageUri resourceUri, OperationContext opContext)

Transformiert einen Ressourcen-URI in einen Shared Access Signature-URI, indem ein freigegebenes Zugriffstoken angefügt und der angegebene Vorgangskontext verwendet wird.

abstract URI transformUri(URI resourceUri, OperationContext opContext)

Transformiert einen Ressourcen-URI in einen Shared Access Signature-URI, indem ein freigegebenes Zugriffstoken angefügt und der angegebene Vorgangskontext verwendet wird.

StorageCredentials tryParseCredentials(final Map<String, String> settings)

Versucht, die Speicheranmeldeinformationen aus einer Sammlung von Name-Wert-Paaren zu ermitteln.

Schließen Sie entweder einen Kontonamen mit einem Kontoschlüssel ein (gibt Werte für ACCOUNT_NAME_NAME und ACCOUNT_KEY_NAME an), oder eine Shared Access Signature (geben Sie einen Wert für SHARED_ACCESS_SIGNATURE_NAME an). Wenn Sie einen Kontonamen und einen Kontoschlüssel verwenden, schließen Sie keine Gemeinsame Zugriffssignatur ein und umgekehrt.

StorageCredentials tryParseCredentials(final String connectionString)

Versucht, die Speicheranmeldeinformationen aus einer Verbindungszeichenfolge zu ermitteln.

Das Format für die Verbindungszeichenfolge hat das Muster "<i>keyname=value</i>". Mehrere Schlüssel-Wert-Paare können durch ein Semikolon getrennt werden, z. B. "<i>keyname1=value1;keyname2=value2</i>". Schließen Sie entweder einen Kontonamen mit einem Kontoschlüssel oder eine Gemeinsame Zugriffssignatur ein. Wenn Sie einen Kontonamen und einen Kontoschlüssel verwenden, schließen Sie keine Gemeinsame Zugriffssignatur ein und umgekehrt.

Die gleiche Verbindungszeichenfolge kann wie für parse(final String connectionString) verwendet werden, aber hier werden nur der Kontoname, der Kontoschlüssel und die SAS-Schlüssel-Wert-Paare untersucht.

Details zur Methode

getAccountName

public String getAccountName()

Gibt den zugeordneten Kontonamen für die Anmeldeinformationen zurück. Dies ist NULL für anmeldeinformationen für anonyme und freigegebene Zugriffssignaturen.

Returns:

Eine String , die den zugeordneten Kontonamen für die Anmeldeinformationen darstellt.

isHttpsOnly

public boolean isHttpsOnly()

Ruft ab, ob dieses Objekt nur den Zugriff über HTTPS zulässt.

Returns:

Ein boolean , der angibt, ob dieses StorageCredentials Objekt den Zugriff nur über HTTPS zulässt.

setHttpsOnly

protected void setHttpsOnly(boolean httpsOnly)

Legt fest, ob dieses Objekt den Zugriff nur über HTTPS zulässt.

Parameters:

httpsOnly - Ein boolean , der angibt, ob dieses StorageCredentials Objekt den Zugriff nur über HTTPS zulässt.

toString

public abstract String toString(boolean exportSecrets)

Gibt eine zurück, die diesen instance darstellt.

Parameters:

exportSecrets -

true , um vertrauliche Daten in die Rückgabezeichenfolge einzuschließen; falseandernfalls .

Returns:

Eine String , die dieses Objekt darstellt, optional auch vertrauliche Daten.

transformUri

public URI transformUri(final URI resourceUri)

Transformiert einen Ressourcen-URI in einen SAS (Shared Access Signature)-URI, indem ein Token für den freigegebenen Zugriff angefügt wird.

Parameters:

resourceUri - Ein java.net.URI-Objekt, das den zu transformierenden Ressourcen-URI darstellt.

Returns:

Ein java.net.URI-Objekt, das die Signatur darstellt, die den Ressourcen-URI und das Token für den gemeinsamen Zugriff enthält.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
URISyntaxException - Wenn der Ressourcen-URI nicht ordnungsgemäß formatiert ist.

transformUri

public StorageUri transformUri(StorageUri resourceUri)

Transformiert einen Ressourcen-URI in einen SAS (Shared Access Signature)-URI, indem ein Token für den freigegebenen Zugriff angefügt wird.

Parameters:

resourceUri - Ein StorageUri-Objekt, das den zu transformierenden Ressourcen-URI darstellt.

Returns:

Ein StorageUri-Objekt, das die Signatur darstellt, die den Ressourcen-URI und das Token für den gemeinsamen Zugriff enthält.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
URISyntaxException - Wenn der Ressourcen-URI nicht ordnungsgemäß formatiert ist.

transformUri

public abstract StorageUri transformUri(StorageUri resourceUri, OperationContext opContext)

Transformiert einen Ressourcen-URI in einen Shared Access Signature-URI, indem ein freigegebenes Zugriffstoken angefügt und der angegebene Vorgangskontext verwendet wird.

Parameters:

resourceUri - Ein StorageUri-Objekt, das den zu transformierenden Ressourcen-URI darstellt.
opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein StorageUri-Objekt, das die Signatur darstellt, die den Ressourcen-URI und das Token für den gemeinsamen Zugriff enthält.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
URISyntaxException - Wenn der Ressourcen-URI nicht ordnungsgemäß formatiert ist.

transformUri

public abstract URI transformUri(URI resourceUri, OperationContext opContext)

Transformiert einen Ressourcen-URI in einen Shared Access Signature-URI, indem ein freigegebenes Zugriffstoken angefügt und der angegebene Vorgangskontext verwendet wird.

Parameters:

resourceUri - Ein java.net.URI-Objekt, das den zu transformierenden Ressourcen-URI darstellt.
opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein java.net.URI-Objekt, das die Signatur darstellt, die den Ressourcen-URI und das Token für den gemeinsamen Zugriff enthält.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
URISyntaxException - Wenn der Ressourcen-URI nicht ordnungsgemäß formatiert ist.

tryParseCredentials

protected static StorageCredentials tryParseCredentials(final Map settings)

Versucht, die Speicheranmeldeinformationen aus einer Sammlung von Name-Wert-Paaren zu ermitteln.

Schließen Sie entweder einen Kontonamen mit einem Kontoschlüssel ein (gibt Werte für ACCOUNT_NAME_NAME und ACCOUNT_KEY_NAME an), oder eine Shared Access Signature (geben Sie einen Wert für SHARED_ACCESS_SIGNATURE_NAME an). Wenn Sie einen Kontonamen und einen Kontoschlüssel verwenden, schließen Sie keine Gemeinsame Zugriffssignatur ein und umgekehrt.

Parameters:

settings - Ein Map Objekt der Name-Wert-Paare, die die Einstellungen darstellen, die zum Konfigurieren der Anmeldeinformationen verwendet werden sollen.

Returns:

Ein StorageCredentials Objekt, das die Aus den Namens-Wert-Paaren ermittelten Speicheranmeldeinformationen darstellt.

Throws:

InvalidKeyException - Wenn der für ACCOUNT_KEY_NAME angegebene Schlüsselwert keine gültige Base64-codierte Zeichenfolge ist.

tryParseCredentials

public static StorageCredentials tryParseCredentials(final String connectionString)

Versucht, die Speicheranmeldeinformationen aus einer Verbindungszeichenfolge zu ermitteln.

Das Format für die Verbindungszeichenfolge hat das Muster "<i>keyname=value</i>". Mehrere Schlüssel-Wert-Paare können durch ein Semikolon getrennt werden, z. B. "<i>keyname1=value1;keyname2=value2</i>". Schließen Sie entweder einen Kontonamen mit einem Kontoschlüssel oder eine Gemeinsame Zugriffssignatur ein. Wenn Sie einen Kontonamen und einen Kontoschlüssel verwenden, schließen Sie keine Gemeinsame Zugriffssignatur ein und umgekehrt.

Die gleiche Verbindungszeichenfolge kann wie für parse(final String connectionString) verwendet werden, aber hier werden nur der Kontoname, der Kontoschlüssel und die SAS-Schlüssel-Wert-Paare untersucht.

Parameters:

connectionString - Eine String , die die Schlüssel-Wert-Paare enthält, die die Speicheranmeldeinformationen darstellen.

Returns:

Ein StorageCredentials Objekt, das die aus der Verbindungszeichenfolge ermittelten Speicheranmeldeinformationen darstellt.

Throws:

InvalidKeyException - Wenn der in connectionString angegebene Kontoschlüssel ungültig ist.
StorageException

Gilt für: