Interfejs usługi Firebase SecurityRules
.
Podpis:
export declare class SecurityRules
Właściwości
Właściwość | Modyfikatory | Typ | Opis |
---|---|---|---|
aplikacja | Aplikacja |
Metody
Metoda | Modyfikatory | Opis |
---|---|---|
createRuleset(plik) | Tworzy nowy Ruleset (Zbiór reguł) na podstawie danego RulesFile (Plik reguły) . | |
createRulesFileFromSource(nazwa; źródło) | Tworzy RulesFile o podanej nazwie i źródle. Jeśli jeden z argumentów jest nieprawidłowy, zwraca błąd. Jest to operacja lokalna i nie obejmuje żadnych wywołań sieciowych interfejsu API. | |
deleteRuleset(nazwa) | Usuwa zbiór Ruleset (Zbiór reguł) określony przez podaną nazwę. Nazwa danych wejściowych powinna być ciągiem krótkiej nazwy bez prefiksu identyfikatora projektu. Na przykład aby usunąć regułę projects/project-id/rulesets/my-ruleset , przekaż krótką nazwę „my-ruleset”. Jeśli nie można znaleźć określonego elementu Ruleset , jest odrzucana z błędem not-found . |
|
getFirestoreRuleset(), | Pobiera zbiór reguł, który jest obecnie stosowany w Cloud Firestore. Jeśli w Firestore nie zastosowano zestawu reguł, zostanie odrzucony z błędem not-found . |
|
getRuleset(nazwa) | Pobiera Ruleset (Zbiór reguł) identyfikowany przez podaną nazwę. Nazwa danych wejściowych powinna być ciągiem krótkiej nazwy bez prefiksu identyfikatora projektu. Na przykład, aby pobrać projects/project-id/rulesets/my-ruleset , przekaż krótką nazwę „my-ruleset”. Jeśli nie można znaleźć określonego elementu Ruleset , jest odrzucana z błędem not-found . |
|
getStorageRuleset(zasobnik) | Pobiera Ruleset, który jest obecnie stosowany do zasobnika Cloud Storage. Jeśli w zasobniku nie zastosowano zestawu reguł, odrzuca z błędem not-found . |
|
listRulesetMetadata(pageSize, nextPageToken) | Pobiera stronę metadanych zestawu reguł. | |
releaseFirestoreRuleset(ruleset) | Stosuje określony zestaw reguł do Cloud Firestore. | |
releaseFirestoreRulesetFromSource(source) | Tworzy nowy zestaw reguł z podanego źródła i stosuje go do Cloud Firestore. | |
releaseStorageRuleset(reguła, zasobnik) | Stosuje określony zestaw reguł Ruleset do zasobnika Cloud Storage. | |
releaseStorageRulesetFromSource(źródło; zasobnik) | Tworzy nowy Zbiór reguł z podanego źródła i stosuje go do zasobnika Cloud Storage. |
SecurityRules.app,
Podpis:
readonly app: App;
SecurityRules.createRuleset()
Tworzy nowy Ruleset (Zbiór reguł) na podstawie danego RulesFile (Plik reguły) .
Podpis:
createRuleset(file: RulesFile): Promise<Ruleset>;
Parametry
Parametr | Typ | Opis |
---|---|---|
plik | Plik reguł | Plik z regułami do uwzględnienia w nowym formacie Ruleset . |
Zwroty:
Obietnica<zestaw reguł>
Obietnica, która spełnia się dzięki nowo utworzonym Ruleset
.
SecurityRules.createRulesFileFromSource().
Tworzy RulesFile o podanej nazwie i źródle. Jeśli jeden z argumentów jest nieprawidłowy, zwraca błąd. Jest to operacja lokalna i nie obejmuje żadnych wywołań sieciowych interfejsu API.
Podpis:
createRulesFileFromSource(name: string, source: string | Buffer): RulesFile;
Parametry
Parametr | Typ | Opis |
---|---|---|
nazwa | ciąg znaków | Nazwa, która ma zostać przypisana do pliku reguł. Zazwyczaj jest to krótka nazwa pliku, która ułatwia identyfikację pliku w zestawie reguł. |
źródło | ciąg znaków | Bufor | Zawartość pliku reguł. |
Zwroty:
Nowa instancja pliku reguł.
Przykład
const source = '// Some rules source';
const rulesFile = admin.securityRules().createRulesFileFromSource(
'firestore.rules', source);
SecurityRules.deleteRuleset()
Usuwa zbiór Ruleset (Zbiór reguł) określony przez podaną nazwę. Nazwa danych wejściowych powinna być ciągiem krótkiej nazwy bez prefiksu identyfikatora projektu. Aby na przykład usunąć regułę projects/project-id/rulesets/my-ruleset
, przekaż krótką nazwę „my-ruleset”. Odrzuca z błędem not-found
, jeśli nie można znaleźć określonego pola Ruleset
.
Podpis:
deleteRuleset(name: string): Promise<void>;
Parametry
Parametr | Typ | Opis |
---|---|---|
nazwa | ciąg znaków | Nazwa elementu Ruleset do usunięcia. |
Zwroty:
Obietnica<void>
Obietnica spełniająca się po usunięciu elementu Ruleset
.
SecurityRules.getFirestoreRuleset()
Pobiera zbiór reguł, który jest obecnie stosowany w Cloud Firestore. Jeśli w Firestore nie zastosowano zestawu reguł, zostanie odrzucony z błędem not-found
.
Podpis:
getFirestoreRuleset(): Promise<Ruleset>;
Zwroty:
Obietnica<zestaw reguł>
Obietnica spełniająca się w zestawie reguł Firestore.
SecurityRules.getRuleset()
Pobiera Ruleset (Zbiór reguł) identyfikowany przez podaną nazwę. Nazwa danych wejściowych powinna być ciągiem krótkiej nazwy bez prefiksu identyfikatora projektu. Na przykład, aby pobrać projects/project-id/rulesets/my-ruleset
, przekaż krótką nazwę „my-ruleset”. Jeśli nie można znaleźć określonego elementu Ruleset
, jest odrzucana z błędem not-found
.
Podpis:
getRuleset(name: string): Promise<Ruleset>;
Parametry
Parametr | Typ | Opis |
---|---|---|
nazwa | ciąg znaków | Nazwa elementu Ruleset do pobrania. |
Zwroty:
Obietnica<zestaw reguł>
Obietnica spełniająca warunki określone w Ruleset
.
SecurityRules.getStorageRuleset()
Pobiera Ruleset, który jest obecnie stosowany do zasobnika Cloud Storage. Jeśli w zasobniku nie zastosowano zestawu reguł, odrzuca z błędem not-found
.
Podpis:
getStorageRuleset(bucket?: string): Promise<Ruleset>;
Parametry
Parametr | Typ | Opis |
---|---|---|
zasobnik | ciąg znaków | Opcjonalna nazwa zasobnika Cloud Storage do pobrania. Jeśli nie określono tego ustawienia, pobiera zestaw reguł zastosowany do domyślnego zasobnika skonfigurowanego przez AppOptions . |
Zwroty:
Obietnica<zestaw reguł>
Obietnica, która spełnia wymagania zestawu reguł Cloud Storage.
SecurityRules.listRulesetMetadata()
Pobiera stronę metadanych zestawu reguł.
Podpis:
listRulesetMetadata(pageSize?: number, nextPageToken?: string): Promise<RulesetMetadataList>;
Parametry
Parametr | Typ | Opis |
---|---|---|
pageSize | liczba | Rozmiar strony (100, jeśli nie został określony). Jest to również maksymalny dozwolony limit. |
nextPageToken | ciąg znaków | Token następnej strony. Jeśli nie określono tego ustawienia, zwraca zestawy reguł zaczynające się bez przesunięcia. |
Zwroty:
Obietnica<RulesetMetadataList>
Obietnica, która spełnia się na stronie zestawów reguł.
SecurityRules.releaseFirestoreRuleset()
Stosuje określony zestaw reguł do Cloud Firestore.
Podpis:
releaseFirestoreRuleset(ruleset: string | RulesetMetadata): Promise<void>;
Parametry
Parametr | Typ | Opis |
---|---|---|
zestaw reguł | ciąg znaków | RulesetMetadata (Metadane zestawu reguł) | Nazwa zestawu reguł do zastosowania lub obiekt RulesetMetadata zawierający nazwę. |
Zwroty:
Obietnica<void>
Obietnica spełniająca się po zniesieniu zestawu reguł.
SecurityRules.releaseFirestoreRulesetFromSource(),
Tworzy nowy zestaw reguł z podanego źródła i stosuje go do Cloud Firestore.
Podpis:
releaseFirestoreRulesetFromSource(source: string | Buffer): Promise<Ruleset>;
Parametry
Parametr | Typ | Opis |
---|---|---|
źródło | ciąg znaków | Bufor | Źródło reguł do zastosowania. |
Zwroty:
Obietnica<zestaw reguł>
Obietnica, która zostaje spełniony w momencie utworzenia i uwolnienia zestawu reguł.
SecurityRules.releaseStorageRuleset()
Stosuje określony zestaw reguł Ruleset do zasobnika Cloud Storage.
Podpis:
releaseStorageRuleset(ruleset: string | RulesetMetadata, bucket?: string): Promise<void>;
Parametry
Parametr | Typ | Opis |
---|---|---|
zestaw reguł | ciąg znaków | RulesetMetadata (Metadane zestawu reguł) | Nazwa zestawu reguł do zastosowania lub obiekt RulesetMetadata zawierający nazwę. |
zasobnik | ciąg znaków | Opcjonalna nazwa zasobnika Cloud Storage, do którego chcesz zastosować reguły. Jeśli zestaw reguł nie zostanie określony, zostanie zastosowany do domyślnego zasobnika skonfigurowanego za pomocą AppOptions. |
Zwroty:
Obietnica<void>
Obietnica spełniająca się po zniesieniu zestawu reguł.
SecurityRules.releaseStorageRulesetFromSource().
Tworzy nowy Zbiór reguł z podanego źródła i stosuje go do zasobnika Cloud Storage.
Podpis:
releaseStorageRulesetFromSource(source: string | Buffer, bucket?: string): Promise<Ruleset>;
Parametry
Parametr | Typ | Opis |
---|---|---|
źródło | ciąg znaków | Bufor | Źródło reguł do zastosowania. |
zasobnik | ciąg znaków | Opcjonalna nazwa zasobnika Cloud Storage, do którego chcesz zastosować reguły. Jeśli zestaw reguł nie zostanie określony, zostanie zastosowany do domyślnego zasobnika skonfigurowanego za pomocą AppOptions. |
Zwroty:
Obietnica<zestaw reguł>
Obietnica, która zostaje spełniony w momencie utworzenia i uwolnienia zestawu reguł.