File Services - Get Service Properties
Ruft die Eigenschaften von Dateidiensten in Speicherkonten ab, einschließlich CORS-Regeln (Cross-Origin Resource Sharing).
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default?api-version=2023-01-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
account
|
path | True |
string |
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. Regex pattern: |
File
|
path | True |
Der Name des Dateidiensts innerhalb des angegebenen Speicherkontos. Der Dateidienstname muss "standard" sein. |
|
resource
|
path | True |
string |
Der Name der Ressourcengruppe im Abonnement des Benutzers. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. Regex pattern: |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK: Die Eigenschaften des Dateidiensts eines Speicherkontos wurden zurückgegeben. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
GetFileServices
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2023-01-01
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
"name": "default",
"type": "Microsoft.Storage/storageAccounts/fileServices",
"properties": {
"cors": {
"corsRules": [
{
"allowedOrigins": [
"http://www.contoso.com",
"http://www.fabrikam.com"
],
"allowedMethods": [
"GET",
"HEAD",
"POST",
"OPTIONS",
"MERGE",
"PUT"
],
"maxAgeInSeconds": 100,
"exposedHeaders": [
"x-ms-meta-*"
],
"allowedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
]
},
{
"allowedOrigins": [
"*"
],
"allowedMethods": [
"GET"
],
"maxAgeInSeconds": 2,
"exposedHeaders": [
"*"
],
"allowedHeaders": [
"*"
]
},
{
"allowedOrigins": [
"http://www.abc23.com",
"https://www.fabrikam.com/*"
],
"allowedMethods": [
"GET",
"PUT"
],
"maxAgeInSeconds": 2000,
"exposedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
],
"allowedHeaders": [
"x-ms-meta-12345675754564*"
]
}
]
}
},
"sku": {
"name": "Standard_GRS",
"tier": "Standard"
}
}
Definitionen
Name | Beschreibung |
---|---|
Allowed |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. |
Cloud |
Eine Fehlerantwort des Speicherdiensts. |
Cloud |
Eine Fehlerantwort des Speicherdiensts. |
Cors |
Gibt eine CORS-Regel für den Blob-Dienst an. |
Cors |
Legt die CORS-Regeln fest. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. |
Delete |
Die Diensteigenschaften für vorläufiges Löschen. |
File |
Die Eigenschaften von Dateidiensten im Speicherkonto. |
File |
Der Name des Dateidiensts innerhalb des angegebenen Speicherkontos. Der Dateidienstname muss "standard" sein. |
Multichannel |
Multichannel-Einstellung. Gilt nur für Premium FileStorage. |
Protocol |
Protokolleinstellungen für den Dateidienst |
Sku |
Die SKU des Speicherkontos. |
Sku |
Der SKU-Name. Erforderlich für die Kontoerstellung; optional für das Update. Beachten Sie, dass in älteren Versionen der SKU-Name accountType genannt wurde. |
Sku |
Die SKU-Ebene. Dies basiert auf dem SKU-Namen. |
Smb |
Einstellung für das SMB-Protokoll |
AllowedMethods
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen.
Name | Typ | Beschreibung |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
CloudError
Eine Fehlerantwort des Speicherdiensts.
Name | Typ | Beschreibung |
---|---|---|
error |
Eine Fehlerantwort des Speicherdiensts. |
CloudErrorBody
Eine Fehlerantwort des Speicherdiensts.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollten programmgesteuert verwendet werden. |
details |
Eine Liste mit zusätzlichen Details zum Fehler. |
|
message |
string |
Eine Meldung, die den Fehler beschreibt, die für die Anzeige in einer Benutzeroberfläche geeignet sein soll. |
target |
string |
Das Ziel des bestimmten Fehlers. Beispiel: Der Name der -Eigenschaft, die einen Fehler aufweist. |
CorsRule
Gibt eine CORS-Regel für den Blob-Dienst an.
Name | Typ | Beschreibung |
---|---|---|
allowedHeaders |
string[] |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste von Headern, die Teil der ursprungsübergreifenden Anforderung sein dürfen. |
allowedMethods |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. |
|
allowedOrigins |
string[] |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der Ursprungsdomänen, die über CORS oder "*" zugelassen werden, um alle Domänen zuzulassen. |
exposedHeaders |
string[] |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der Antwortheader, die CORS-Clients zur Verfügung stellen sollen. |
maxAgeInSeconds |
integer |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Gibt an, wie viele Sekunden eine Preflight-Antwort vom Client/Browser zwischengespeichert werden soll. |
CorsRules
Legt die CORS-Regeln fest. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen.
Name | Typ | Beschreibung |
---|---|---|
corsRules |
Cors |
Die Liste der CORS-Regeln. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. |
DeleteRetentionPolicy
Die Diensteigenschaften für vorläufiges Löschen.
Name | Typ | Beschreibung |
---|---|---|
allowPermanentDelete |
boolean |
Diese Eigenschaft, wenn sie auf true festgelegt ist, ermöglicht das Löschen der vorläufig gelöschten Blobversionen und Momentaufnahmen. Diese Eigenschaft kann nicht für die Blobwiederherstellung verwendet werden. Diese Eigenschaft gilt nur für den Blobdienst und gilt nicht für Container oder Dateifreigaben. |
days |
integer |
Gibt die Anzahl der Tage an, für die das gelöschte Element aufbewahrt werden soll. Der angegebene Mindestwert kann 1 und der höchstwert 365 sein. |
enabled |
boolean |
Gibt an, ob DeleteRetentionPolicy aktiviert ist. |
FileServiceProperties
Die Eigenschaften von Dateidiensten im Speicherkonto.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Der Name der Ressource |
properties.cors |
Gibt CORS-Regeln für den Dateidienst an. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. Wenn keine CorsRule-Elemente im Anforderungstext enthalten sind, werden alle CORS-Regeln gelöscht, und CORS wird für den Dateidienst deaktiviert. |
|
properties.protocolSettings |
Protokolleinstellungen für den Dateidienst |
|
properties.shareDeleteRetentionPolicy |
Die Dateidiensteigenschaften für das vorläufige Löschen von Freigaben. |
|
sku |
SKU-Name und -Ebene. |
|
type |
string |
Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
FileServicesName
Der Name des Dateidiensts innerhalb des angegebenen Speicherkontos. Der Dateidienstname muss "standard" sein.
Name | Typ | Beschreibung |
---|---|---|
default |
string |
Multichannel
Multichannel-Einstellung. Gilt nur für Premium FileStorage.
Name | Typ | Beschreibung |
---|---|---|
enabled |
boolean |
Gibt an, ob Multichannel aktiviert ist. |
ProtocolSettings
Protokolleinstellungen für den Dateidienst
Name | Typ | Beschreibung |
---|---|---|
smb |
Einstellung für das SMB-Protokoll |
Sku
Die SKU des Speicherkontos.
Name | Typ | Beschreibung |
---|---|---|
name |
Der SKU-Name. Erforderlich für die Kontoerstellung; optional für das Update. Beachten Sie, dass in älteren Versionen der SKU-Name accountType genannt wurde. |
|
tier |
Die SKU-Ebene. Dies basiert auf dem SKU-Namen. |
SkuName
Der SKU-Name. Erforderlich für die Kontoerstellung; optional für das Update. Beachten Sie, dass in älteren Versionen der SKU-Name accountType genannt wurde.
Name | Typ | Beschreibung |
---|---|---|
Premium_LRS |
string |
|
Premium_ZRS |
string |
|
Standard_GRS |
string |
|
Standard_GZRS |
string |
|
Standard_LRS |
string |
|
Standard_RAGRS |
string |
|
Standard_RAGZRS |
string |
|
Standard_ZRS |
string |
SkuTier
Die SKU-Ebene. Dies basiert auf dem SKU-Namen.
Name | Typ | Beschreibung |
---|---|---|
Premium |
string |
|
Standard |
string |
SmbSetting
Einstellung für das SMB-Protokoll
Name | Typ | Beschreibung |
---|---|---|
authenticationMethods |
string |
SMB-Authentifizierungsmethoden, die vom Server unterstützt werden. Gültige Werte sind NTLMv2, Kerberos. Sollte als Zeichenfolge mit dem Trennzeichen ";" übergeben werden. |
channelEncryption |
string |
Vom Server unterstützte SMB-Kanalverschlüsselung. Gültige Werte sind AES-128-CCM, AES-128-GCM, AES-256-GCM. Sollte als Zeichenfolge mit dem Trennzeichen ";" übergeben werden. |
kerberosTicketEncryption |
string |
Vom Server unterstützte Kerberos-Ticketverschlüsselung. Gültige Werte sind RC4-HMAC, AES-256. Sollte als Zeichenfolge mit dem Trennzeichen ";" übergeben werden. |
multichannel |
Multichannel-Einstellung. Gilt nur für Premium FileStorage. |
|
versions |
string |
Vom Server unterstützte SMB-Protokollversionen. Gültige Werte sind SMB2.1, SMB3.0, SMB3.1.1. Sollte als Zeichenfolge mit dem Trennzeichen ";" übergeben werden. |