SecurityRules class

Firebase SecurityRulesサービス インターフェイス。

サイン:

export declare class SecurityRules 

プロパティ

財産修飾子タイプ説明
アプリアプリ

メソッド

方法修飾子説明
createRuleset(ファイル)指定されたRulesFileから新しいルールセットを作成します
createRulesFileFromSource(名前, ソース)指定された名前とソースを使用してRulesFileを作成します。いずれかの引数が無効な場合は、エラーがスローされます。これはローカル操作であり、ネットワーク API 呼び出しは含まれません。
deleteルールセット(名前)指定された名前で識別されるルールセットを削除します。入力名は、プロジェクト ID プレフィックスのない短い名前文字列である必要があります。たとえば、 projects/project-id/rulesets/my-rulesetを削除するには、短い名前「my-ruleset」を渡します。指定されたRuleset見つからnot-foundエラーで拒否されます。
getFirestoreRuleset()現在 Cloud Firestore に適用されているルールセットを取得します。 Firestore にルールセットが適用されていない場合は、 not-foundエラーで拒否されます。
getルールセット(名前)指定された名前で識別されるルールセットを取得します。入力名は、プロジェクト ID プレフィックスのない短い名前文字列である必要があります。たとえば、 projects/project-id/rulesets/my-rulesetを取得するには、短い名前「my-ruleset」を渡します。指定されたRuleset見つからnot-foundエラーで拒否されます。
getStorageRuleset(バケット) Cloud Storage バケットに現在適用されているルールセットを取得します。バケットにルールセットが適用されていない場合は、 not-foundエラーで拒否されます。
listRulesetMetadata(pageSize, nextPageToken)ルールセットのメタデータのページを取得します。
releaseFirestoreRuleset(ルールセット)指定されたRulesetルールセットを Cloud Firestore に適用します。
releaseFirestoreRulesetFromSource(ソース)指定されたソースから新しいルールセットを作成し、Cloud Firestore に適用します。
releaseStorageRuleset(ルールセット、バケット)指定されたRulesetルールセットを Cloud Storage バケットに適用します。
releaseStorageRulesetFromSource(ソース、バケット)指定されたソースから新しいルールセットを作成し、それを Cloud Storage バケットに適用します。

セキュリティルール.app

サイン:

readonly app: App;

SecurityRules.createRuleset()

指定されたRulesFileから新しいルールセットを作成します

サイン:

createRuleset(file: RulesFile): Promise<Ruleset>;

パラメーター

パラメータタイプ説明
ファイルルールファイル新しいRulesetに含めるルール ファイル。

戻り値:

プロミス<ルールセット>

新しく作成されたRulesetで果たされる約束

SecurityRules.createRulesFileFromSource()

指定された名前とソースを使用してRulesFileを作成します。いずれかの引数が無効な場合は、エラーがスローされます。これはローカル操作であり、ネットワーク API 呼び出しは含まれません。

サイン:

createRulesFileFromSource(name: string, source: string | Buffer): RulesFile;

パラメーター

パラメータタイプ説明
名前ルールファイルに割り当てる名前。これは通常、ルールセット内のファイルを識別するのに役立つ短いファイル名です。
ソース文字列 |バッファルールファイルの内容。

戻り値:

ルールファイル

新しいルール ファイル インスタンス。

const source = '// Some rules source';
const rulesFile = admin.securityRules().createRulesFileFromSource(
  'firestore.rules', source);

SecurityRules.deleteRuleset()

指定された名前で識別されるルールセットを削除します。入力名は、プロジェクト ID プレフィックスのない短い名前文字列である必要があります。たとえば、 projects/project-id/rulesets/my-rulesetを削除するには、短い名前「my-ruleset」を渡します。指定されたRuleset見つからnot-foundエラーで拒否されます。

サイン:

deleteRuleset(name: string): Promise<void>;

パラメーター

パラメータタイプ説明
名前削除するRulesetの名前。

戻り値:

約束<無効>

Rulesetが削除されたときに実行される Promise。

SecurityRules.getFirestoreRuleset()

現在 Cloud Firestore に適用されているルールセットを取得します。 Firestore にルールセットが適用されていない場合は、 not-foundエラーで拒否されます。

サイン:

getFirestoreRuleset(): Promise<Ruleset>;

戻り値:

プロミス<ルールセット>

Firestore ルールセットで実現される約束。

SecurityRules.getRuleset()

指定された名前で識別されるルールセットを取得します。入力名は、プロジェクト ID プレフィックスのない短い名前文字列である必要があります。たとえば、 projects/project-id/rulesets/my-ruleset取得するには、短い名前「my-ruleset」を渡します。指定されたRuleset見つからnot-foundエラーで拒否されます。

サイン:

getRuleset(name: string): Promise<Ruleset>;

パラメーター

パラメータタイプ説明
名前取得するRulesetの名前。

戻り値:

プロミス<ルールセット>

指定されたRulesetで満たされる Promise

SecurityRules.getStorageRuleset()

Cloud Storage バケットに現在適用されているルールセットを取得します。バケットにルールセットが適用されていない場合は、 not-foundエラーで拒否されます。

サイン:

getStorageRuleset(bucket?: string): Promise<Ruleset>;

パラメーター

パラメータタイプ説明
バケツ取得する Cloud Storage バケットの名前 (オプション)。指定しない場合、 AppOptionsを介して構成されたデフォルトのバケットに適用されるルールセットを取得します。

戻り値:

プロミス<ルールセット>

Cloud Storage ルールセットで実現される約束。

SecurityRules.listRulesetMetadata()

ルールセットのメタデータのページを取得します。

サイン:

listRulesetMetadata(pageSize?: number, nextPageToken?: string): Promise<RulesetMetadataList>;

パラメーター

パラメータタイプ説明
ページサイズ番号ページ サイズ。未定義の場合は 100。これは最大許容値でもあります。
nextPageトークン次のページのトークン。指定しない場合、オフセットなしで始まるルールセットを返します。

戻り値:

Promise< RulesetMetadataList >

ルールセットのページで実現される約束。

SecurityRules.releaseFirestoreRuleset()

指定されたRulesetルールセットを Cloud Firestore に適用します。

サイン:

releaseFirestoreRuleset(ruleset: string | RulesetMetadata): Promise<void>;

パラメーター

パラメータタイプ説明
ルールセット文字列 |ルールセットメタデータ適用するルールセットの名前、またはその名前を含むRulesetMetadataオブジェクト。

戻り値:

約束<無効>

ルールセットがリリースされたときに実行される約束。

SecurityRules.releaseFirestoreRulesetFromSource()

指定されたソースから新しいルールセットを作成し、Cloud Firestore に適用します。

サイン:

releaseFirestoreRulesetFromSource(source: string | Buffer): Promise<Ruleset>;

パラメーター

パラメータタイプ説明
ソース文字列 |バッファ適用するルールのソース。

戻り値:

プロミス<ルールセット>

ルールセットが作成およびリリースされるときに実行される約束。

SecurityRules.releaseStorageRuleset()

指定されたRulesetルールセットを Cloud Storage バケットに適用します。

サイン:

releaseStorageRuleset(ruleset: string | RulesetMetadata, bucket?: string): Promise<void>;

パラメーター

パラメータタイプ説明
ルールセット文字列 |ルールセットメタデータ適用するルールセットの名前、またはその名前を含むRulesetMetadataオブジェクト。
バケツルールを適用する Cloud Storage バケットの名前 (オプション)。指定しない場合、 AppOptionsで設定されたデフォルトのバケットにルールセットが適用されます。

戻り値:

約束<無効>

ルールセットがリリースされたときに実行される約束。

SecurityRules.releaseStorageRulesetFromSource()

指定されたソースから新しいルールセットを作成し、それを Cloud Storage バケットに適用します。

サイン:

releaseStorageRulesetFromSource(source: string | Buffer, bucket?: string): Promise<Ruleset>;

パラメーター

パラメータタイプ説明
ソース文字列 |バッファ適用するルールのソース。
バケツルールを適用する Cloud Storage バケットの名前 (オプション)。指定しない場合、 AppOptionsで設定されたデフォルトのバケットにルールセットが適用されます。

戻り値:

プロミス<ルールセット>

ルールセットが作成およびリリースされるときに実行される約束。