Freigeben über


Storage Accounts - List Service SAS

Listen Sie die SAS-Anmeldeinformationen für den Dienst einer bestimmten Ressource auf.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/listServiceSas?api-version=2025-06-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

Der Name des Speicherkontos innerhalb der angegebenen Ressourcengruppe. Speicherkontonamen müssen zwischen 3 und 24 Zeichen lang sein und dürfen nur Zahlen und Kleinbuchstaben enthalten.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
canonicalizedResource True

string

Der kanonische Pfad zur signierten Ressource.

endPk

string

Das Ende des Partitionsschlüssels.

endRk

string

Der Schlüssel für das Ende der Zeile.

keyToSign

string

Der Schlüssel, mit dem das SAS-Token des Kontos signiert werden soll.

rscc

string

Die Überschreibung des Antwortheaders für die Cachesteuerung.

rscd

string

Die Überschreibung des Antwortheaders für die Inhaltsdisposition.

rsce

string

Die Überschreibung des Antwortheaders für die Inhaltscodierung.

rscl

string

Die Überschreibung des Antwortheaders für die Inhaltssprache.

rsct

string

Die Überschreibung des Antwortheaders für den Inhaltstyp.

signedExpiry

string (date-time)

Der Zeitpunkt, zu dem die Shared Access Signature ungültig wird.

signedIdentifier

string

maxLength: 64

Ein eindeutiger Wert mit einer Länge von bis zu 64 Zeichen, der einer Zugriffsrichtlinie entspricht, die für den Container, die Warteschlange oder die Tabelle angegeben ist.

signedIp

string

Eine IP-Adresse oder ein Bereich von IP-Adressen, von denen Anfragen angenommen werden sollen.

signedPermission

Permissions

Die signierten Berechtigungen für die Dienst-SAS. Mögliche Werte sind: Lesen (r), Schreiben (w), Löschen (d), Liste (l), Hinzufügen (a), Erstellen (c), Aktualisieren (u) und Verarbeiten (p).

signedProtocol

HttpProtocol

Das Protokoll, das für eine Anforderung mit dem Konto SAS zulässig ist.

signedResource

SignedResource

Die signierten Dienste, auf die mit dem Dienst SAS zugegriffen werden kann. Mögliche Werte sind: Blob (b), Container (c), Datei (f), Freigabe (s).

signedStart

string (date-time)

Der Zeitpunkt, zu dem die SAS gültig wird.

startPk

string

Der Anfang des Partitionsschlüssels.

startRk

string

Der Schlüssel für den Zeilenanfang.

Antworten

Name Typ Beschreibung
200 OK

ListServiceSasResponse

Der Azure-Vorgang wurde erfolgreich abgeschlossen.

Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

StorageAccountListServiceSAS

Beispielanforderung

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res7439/providers/Microsoft.Storage/storageAccounts/sto1299/listServiceSas?api-version=2025-06-01

{
  "canonicalizedResource": "/blob/sto1299/music",
  "signedExpiry": "2017-05-24T11:32:48.8457197Z",
  "signedPermission": "l",
  "signedResource": "c"
}

Beispiel für eine Antwort

{
  "serviceSasToken": "sv=2015-04-05&sr=c&se=2017-05-24T11%3A32%3A48Z&sp=l&sig=PoF8yBUGixsjzwroLmw7vG3VbGz4KB2woZC2D4C2oio%3D"
}

Definitionen

Name Beschreibung
ErrorResponse

Eine Fehlerantwort des Speicherressourcenanbieters.

ErrorResponseBody

Fehlerantworttext-Vertrag.

HttpProtocol

Das Protokoll, das für eine Anforderung mit dem Konto SAS zulässig ist.

ListServiceSasResponse

Die Sas-Anmeldeinformationsvorgangsantwort des Listendiensts.

Permissions

Die signierten Berechtigungen für die Konto-SAS. Mögliche Werte sind: Lesen (r), Schreiben (w), Löschen (d), Liste (l), Hinzufügen (a), Erstellen (c), Aktualisieren (u) und Verarbeiten (p).

ServiceSasParameters

Die Parameter zum Auflisten von Dienst-SAS-Anmeldeinformationen einer bestimmten Ressource.

SignedResource

Die signierten Dienste, auf die mit dem Dienst SAS zugegriffen werden kann. Mögliche Werte sind: Blob (b), Container (c), Datei (f), Freigabe (s).

ErrorResponse

Eine Fehlerantwort des Speicherressourcenanbieters.

Name Typ Beschreibung
error

ErrorResponseBody

Fehlerantworttext des Azure Storage-Ressourcenanbieters.

ErrorResponseBody

Fehlerantworttext-Vertrag.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.

message

string

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

HttpProtocol

Das Protokoll, das für eine Anforderung mit dem Konto SAS zulässig ist.

Wert Beschreibung
https,http
https

ListServiceSasResponse

Die Sas-Anmeldeinformationsvorgangsantwort des Listendiensts.

Name Typ Beschreibung
serviceSasToken

string

Listen Sie die SAS-Anmeldeinformationen für den Dienst einer bestimmten Ressource auf.

Permissions

Die signierten Berechtigungen für die Konto-SAS. Mögliche Werte sind: Lesen (r), Schreiben (w), Löschen (d), Liste (l), Hinzufügen (a), Erstellen (c), Aktualisieren (u) und Verarbeiten (p).

Wert Beschreibung
r
d
w
l
a
c
u
p

ServiceSasParameters

Die Parameter zum Auflisten von Dienst-SAS-Anmeldeinformationen einer bestimmten Ressource.

Name Typ Beschreibung
canonicalizedResource

string

Der kanonische Pfad zur signierten Ressource.

endPk

string

Das Ende des Partitionsschlüssels.

endRk

string

Der Schlüssel für das Ende der Zeile.

keyToSign

string

Der Schlüssel, mit dem das SAS-Token des Kontos signiert werden soll.

rscc

string

Die Überschreibung des Antwortheaders für die Cachesteuerung.

rscd

string

Die Überschreibung des Antwortheaders für die Inhaltsdisposition.

rsce

string

Die Überschreibung des Antwortheaders für die Inhaltscodierung.

rscl

string

Die Überschreibung des Antwortheaders für die Inhaltssprache.

rsct

string

Die Überschreibung des Antwortheaders für den Inhaltstyp.

signedExpiry

string (date-time)

Der Zeitpunkt, zu dem die Shared Access Signature ungültig wird.

signedIdentifier

string

maxLength: 64

Ein eindeutiger Wert mit einer Länge von bis zu 64 Zeichen, der einer Zugriffsrichtlinie entspricht, die für den Container, die Warteschlange oder die Tabelle angegeben ist.

signedIp

string

Eine IP-Adresse oder ein Bereich von IP-Adressen, von denen Anfragen angenommen werden sollen.

signedPermission

Permissions

Die signierten Berechtigungen für die Dienst-SAS. Mögliche Werte sind: Lesen (r), Schreiben (w), Löschen (d), Liste (l), Hinzufügen (a), Erstellen (c), Aktualisieren (u) und Verarbeiten (p).

signedProtocol

HttpProtocol

Das Protokoll, das für eine Anforderung mit dem Konto SAS zulässig ist.

signedResource

SignedResource

Die signierten Dienste, auf die mit dem Dienst SAS zugegriffen werden kann. Mögliche Werte sind: Blob (b), Container (c), Datei (f), Freigabe (s).

signedStart

string (date-time)

Der Zeitpunkt, zu dem die SAS gültig wird.

startPk

string

Der Anfang des Partitionsschlüssels.

startRk

string

Der Schlüssel für den Zeilenanfang.

SignedResource

Die signierten Dienste, auf die mit dem Dienst SAS zugegriffen werden kann. Mögliche Werte sind: Blob (b), Container (c), Datei (f), Freigabe (s).

Wert Beschreibung
b
c
f
s